Artalk · 直观而功能丰富的自托管评论系统｜Docker 一键部署与使用全指南

项目仓库： https://github.com/ArtalkJS/Artalk

开源协议：MIT · 定位：可立即部署到任意博客/网站/应用的评论系统 · 客户端：约 40KB 纯 Vanilla JS · 服务端：Go · Docker 镜像：artalk/artalk-go · 服务端端口：23366（容器内） · 官方文档：artalk.js.org

1 项目简介

Artalk 是一个直观而功能丰富的评论系统，可立即部署到任意博客、网站或 Web 应用。客户端约 40KB、纯 Vanilla JS、框架无关；服务端用 Golang 编写，高效轻量跨平台；提供 Docker 一键部署；开源自托管、以隐私为先。

1.1 核心信息一览

1.2 适用场景

• 博客 / 网站需要自托管评论，希望数据在自己手里。
• 希望 Docker 一键部署，且功能丰富（侧边栏、邮件、推送、图床、多站）。

1.3 能力边界（官方口径）

• 除 Docker 外，也提供二进制、go install、Linux 包管理器等安装方式。
• 客户端框架无关，可嵌入任意页面。

2 功能特性

• 侧边栏：快速管理、直观浏览。
• 社交登录、邮件通知、多样推送。
• 验证码、评论审核、图片上传。
• Markdown、表情包、多站隔离。
• PV 统计、评论投票、排序、搜索、置顶、跳转。
• Latex、夜间模式、插件扩展、多语言、命令行、OpenAPI、一键升级。

3 官方界面预览

开头封面为 Artalk 官方 Banner。评论框嵌入文章页，侧边栏提供管理入口。

4 官方跳转链接汇总

5 前置要求与服务器配置

5.1 软件前提

• 一台可跑 Docker 的 VPS；或用二进制 / 包管理器安装。

5.2 硬件建议

• 普通 VPS；评论数据量不大时 1C1G 起步。

5.3 端口与资源

• 容器内服务端端口 23366；宿主映射 -p 8080:23366。

6 方式一：Docker 一键部署（推荐）

docker run -d \
    --name artalk \
    -p 8080:23366 \
    -v $(pwd)/data:/data \
    -e "TZ=America/New_York" \
    -e "ATK_LOCALE=en" \
    -e "ATK_SITE_DEFAULT=Artalk Blog" \
    -e "ATK_SITE_URL=https://example.com" \
    artalk/artalk-go

客户端接入：

Artalk.init({
  el:      '#Comments',
  site:    'Artalk Blog',
  server:  'https://artalk.example.com',
  pageKey: '/2018/10/02/hello-world.html'
})

7 方式二：二进制 / go install / 包管理器

按官方部署文档选择对应方式安装。

8 配置项说明

• 环境变量：TZ、ATK_LOCALE、ATK_SITE_DEFAULT、ATK_SITE_URL；更多见文档。
• 客户端：el、site、server、pageKey。

9 常用运维命令

• 容器：docker logs artalk、docker restart artalk。
• 内置命令行管理；一键升级按文档。

10 常见故障排查

• 查官方文档部署章节；确认 server 地址与站点配置。

11 风险与合规说明

• 许可证：MIT。
• 本文整理自官方 README，命令以官方文档最新说明为准；不包含 star 数等动态数据。