remark42：独立开源评论系统部署与博客嵌入接入指南
remark42 是一个自托管、轻量、简洁但功能完整的评论引擎，主打「不监视用户」。它可以被嵌入到博客、文章或任意读者需要留言的地方；支持社交登录、邮件登录、匿名访问、多级嵌套评论、导入 Disqus/WordPress、通知、图片拖拽上传、JSON 导出备份等，全部数据内嵌在单一数据文件里，无外部数据库。
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/umputun/remark42 |
| 官方网站 | https://remark42.com |
| 安装文档 | https://remark42.com/docs/getting-started/installation/ |
| 开源协议 | MIT |
| 主要语言 | Go（约 67.7%） |
| Star 数 | 5.6k+ |
说明：该项目实际仓库为
umputun/remark42，本文按发布约定 slug 用remark42。
二、官方图片
remark42 仓库社交预览图：
三、环境要求
- 方式一（推荐）：Docker Engine，一条命令即可部署；
- 方式二：自包含可执行文件，可直接跑在 Linux / Windows / macOS；
- 数据持久化：挂载数据卷（单数据文件，无需外部数据库）；
- 生产建议：反向代理提供 HTTPS（支持自动 SSL），并配置站点 URL 与管理员账号。
四、部署步骤
方式 A：Docker 部署（官方推荐）
remark42 完全 Docker 化，一条命令启动。核心环境变量包括：站点地址 REMARK_URL、管理员账号 REMARK_ADMIN_LOGIN / REMARK_ADMIN_PASSWORD、存储目录等：
docker run -d \
--name remark42 \
-p 8080:8080 \
-v $(pwd)/remark42_data:/srv/var \
-e REMARK_URL="https://comments.example.com" \
-e REMARK_ADMIN_LOGIN="admin" \
-e REMARK_ADMIN_PASSWORD="请改成强密码" \
-e REMARK_AUTH_ANONYMOUS="true" \
umputun/remark42:latest
说明：
-p 8080:8080：映射 Web 端口；-v …:/srv/var：把数据目录持久化（评论数据全部内嵌在这一份数据文件里）；REMARK_URL：你对外访问评论服务的地址；REMARK_ADMIN_*：管理员登录凭据；REMARK_AUTH_ANONYMOUS：是否允许匿名访问。
方式 B：自包含可执行文件
remark42 提供自包含可执行文件，可直接部署到 Linux / Windows / macOS，不依赖 Docker，运行时通过环境变量做同样的配置。
反向代理与 HTTPS
生产环境把评论服务放在 Nginx / Caddy 反代后并签发证书；remark42 集成自动 SSL（直连或通过 nginx-le），可参考官方文档。
五、使用方法（嵌入任意博客/静态站）
remark42 的核心是往任意页面嵌入一个评论 widget：
- 引入 widget 脚本：在博客/文章页面引入 remark42 提供的 embeds 脚本；
- 放置容器节点：页面里放一个
<div id="remark42"></div>容器； - 传入站点配置：脚本会连接到你的 remark42 服务，加载该文章的评论流。
读者即可在文章底部看到评论区，支持：
- 社交登录（Google、GitHub、Apple、Telegram、Discord 等）或邮件登录、可选匿名；
- 多级嵌套评论（树形/平铺两种展示）；
- Markdown + 格式化工具栏、图片拖拽上传；
- 点赞、置顶、审核、排序；
- 管理员经 Telegram / Slack / Webhook / 邮件收到新评论通知；
- 支持多站点模式（单实例服务多个站点）。
六、常见问题 FAQ
Q1：remark42 需要外部数据库吗？ 不需要。所有评论数据内嵌在单个数据文件里，通过卷挂载持久化即可。
Q2：怎么部署最简单？
用 Docker，一条 docker run 命令，配好 REMARK_URL 与管理员凭据即可。
Q3：能迁移 Disqus / WordPress 评论吗？ 官方支持从 Disqus 与 WordPress 导入历史评论。
Q4：怎么把评论嵌到我的博客上？
在文章页引入 remark42 的 embeds 脚本，并放置 #remark42 容器节点，脚本会连到你的评论服务加载评论流。
Q5：管理员怎么通知？ 支持 Telegram、Slack、Webhook、邮件等渠道，有新评论时通知管理员；用户也可在被回复时收到邮件/Telegram 通知。
Q6：数据如何备份？ 内置 JSON 导出与自动备份；单数据文件本身也方便整份复制备份。
七、跳转链接
- GitHub 仓库：https://github.com/umputun/remark42
- 官方网站：https://remark42.com
- 安装文档：https://remark42.com/docs/getting-started/installation/
- 管理界面文档：https://remark42.com/docs/manuals/admin-interface/