Artalk

简体中文

English

简体中文

English

Appearance

📦 程序部署 ​

Docker 部署 ​

推荐使用 Docker 部署，需预先安装 Docker 引擎，执行命令创建容器：

bash
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

执行命令创建管理员账户：

bash
docker exec -it artalk artalk admin

浏览器输入 http://artalk.example.com:8080 进入 Artalk 后台登录界面。

在网页中引入 Artalk 程序内嵌的的前端 JS 和 CSS 资源并初始化 Artalk：

html
<!-- 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 部署！

普通方式部署 ​

  1. GitHub Release 下载程序压缩包

  2. 解压 tar -zxvf artalk_版本号_系统_架构.tar.gz

  3. 运行 ./artalk server

  4. 配置

    js
    Artalk.init({ server: 'http://artalk.example.com:23366' })

进阶操作：

Compose 部署 ​

compose.yaml

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

创建容器：

bash
docker-compose up -d
Compose 常用命令
bash
docker-compose restart  # 重启容器
docker-compose stop     # 暂停容器
docker-compose down     # 删除容器
docker-compose pull     # 更新镜像
docker-compose exec artalk bash # 进入容器

参考文档：Docker / 环境变量

WARNING

自 2024-06-06 开始，境内的 Docker Hub 镜像相继停止服务，可选择配置代理或自建镜像。

详见：Docker 镜像加速。

Linux 发行版 ​

Arch Linux (AUR)：

bash
paru -S artalk

NixOS：

bash
nix-env -iA nixpkgs.artalk

Termux：

bash
pkg install artalk

Packaging status

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 (境内)

https://cdn.staticfile.org/artalk/2.9.0/Artalk.js

https://cdn.staticfile.org/artalk/2.9.0/Artalk.css

UNPKG

https://unpkg.com/artalk@2.9.0/dist/Artalk.js

https://unpkg.com/artalk@2.9.0/dist/Artalk.css

JS DELIVR

https://cdn.jsdelivr.net/npm/artalk@2.9.0/dist/Artalk.js

https://cdn.jsdelivr.net/npm/artalk@2.9.0/dist/Artalk.css

Node 项目 ​

安装 Artalk：

bash
npm install artalk

引入 Artalk：

js
import 'artalk/dist/Artalk.css'
import Artalk from 'artalk'

Artalk.init({
  // ...
})

更多参考：

数据导入 ​

从其他评论系统导入数据：数据迁移

ArtalkLite ​

可选择精简版 ArtalkLite：体积更小、更简约。

开发环境 ​

可参考：开发者指南