📦 程序部署
Docker 部署
推荐使用 Docker 部署,需预先安装 Docker 引擎,执行命令创建容器:
docker run -d \
--name artalk \
-p 8080:23366 \
-v $(pwd)/data:/data \
-e "TZ=Asia/Shanghai" \
-e "ATK_LOCALE=zh-CN" \
-e "ATK_SITE_DEFAULT=Artalk 的博客" \
-e "ATK_SITE_URL=https://example.com" \
artalk/artalk-go
执行命令创建管理员账户:
docker exec -it artalk artalk admin
浏览器输入 http://artalk.example.com:8080
进入 Artalk 后台登录界面。
在网页中引入 Artalk 程序内嵌的的前端 JS 和 CSS 资源并初始化 Artalk:
<!-- CSS -->
<link href="http://artalk.example.com:8080/dist/Artalk.css" rel="stylesheet" />
<!-- JS -->
<script src="http://artalk.example.com:8080/dist/Artalk.js"></script>
<!-- Artalk -->
<div id="Comments"></div>
<script>
Artalk.init({
el: '#Comments', // 绑定元素的 Selector
pageKey: '/post/1', // 固定链接
pageTitle: '关于引入 Artalk 的这档子事', // 页面标题 (留空自动获取)
server: 'http://artalk.example.com:8080', // 后端地址
site: 'Artalk 的博客', // 你的站点名
})
</script>
评论框输入管理员用户名和邮箱,「控制台」按钮将出现在评论框右下角。
在控制台,你可以根据喜好配置评论系统、将评论迁移到 Artalk。
🥳 你已成功完成 Artalk 部署!
普通方式部署
GitHub Release 下载程序压缩包
解压
tar -zxvf artalk_版本号_系统_架构.tar.gz
运行
./artalk server
配置
jsArtalk.init({ server: 'http://artalk.example.com:23366' })
进阶操作:
Compose 部署
compose.yaml
version: '3.8'
services:
artalk:
container_name: artalk
image: artalk/artalk-go
restart: unless-stopped
ports:
- 8080:23366
volumes:
- ./data:/data
environment:
- TZ=Asia/Shanghai
- ATK_LOCALE=zh-CN
- ATK_SITE_DEFAULT=Artalk 的博客
- ATK_SITE_URL=https://your_domain
创建容器:
docker-compose up -d
Compose 常用命令
docker-compose restart # 重启容器
docker-compose stop # 暂停容器
docker-compose down # 删除容器
docker-compose pull # 更新镜像
docker-compose exec artalk bash # 进入容器
Linux 发行版
Arch Linux (AUR):
paru -S artalk
NixOS:
nix-env -iA nixpkgs.artalk
Termux:
pkg install artalk
CDN 资源
Artalk 最新版本
当前 Artalk 前端最新版本号为: 2.9.0
若需升级前端将 URL 中的版本号数字部分替换即可。
Artalk 后端程序内嵌了前端 JS、CSS 文件,使用公共 CDN 资源请注意版本兼容性。
CDNJS
https://cdnjs.cloudflare.com/ajax/libs/artalk/2.9.0/Artalk.js
https://cdnjs.cloudflare.com/ajax/libs/artalk/2.9.0/Artalk.css
查看更多
SUSTech Mirrors (境内)
https://mirrors.sustech.edu.cn/cdnjs/ajax/libs/artalk/2.9.0/Artalk.js
https://mirrors.sustech.edu.cn/cdnjs/ajax/libs/artalk/2.9.0/Artalk.css
Staticfile CDN (境内)
UNPKG
JS DELIVR
Node 项目
安装 Artalk:
npm install artalk
引入 Artalk:
import 'artalk/dist/Artalk.css'
import Artalk from 'artalk'
Artalk.init({
// ...
})
更多参考:
数据导入
从其他评论系统导入数据:数据迁移
ArtalkLite
可选择精简版 ArtalkLite:体积更小、更简约。
开发环境
可参考:开发者指南