详细说明
优势 5 项
不足 4 项
服务商概述
Remark42 是由开发者 Umputun 主导的开源评论引擎,官网 remark42.com,代码托管在 GitHub,采用 MIT 协议,用 Go 编写。它的目标很克制:只解决「网页评论」这一件事,把它做成一个独立服务。站点只需要在页面里放 1 个容器节点和一段 embed.js,评论的存储、登录、通知与审核全部交给这个服务处理,站点本身用什么语言、是不是静态生成都无所谓。
在社区与论坛品类里,它属于「轻交互」的一端。Disqus 这类第三方评论服务把数据放在平台侧,加载脚本还常被墙与追踪问题困扰;Remark42 的思路是把评论搬回自己的服务器——数据库是内嵌的 BoltDB,备份就是拷 1 个目录,隐私上也没有第三方追踪脚本。
它的形态决定了适用边界:它能做好评论、回复、通知与审核,但不会给你版块、私信、用户主页与复杂权限。如果目标是把读者讨论留在站内、又不想引入完整论坛系统,它的接入成本很低;如果目标是运营一个多版块社区,它只能算辅助工具。
核心优势
- 部署轻:单个二进制文件加内嵌数据库即可运行,Docker 镜像体积小,1 台 1 核 1GB 的服务器就能服务中小流量站点,1 个实例还能挂多个站点。
- 登录方式多:匿名评论可按站点允许或禁止,社交登录覆盖 Google、GitHub、Facebook、X、Yandex、Patreon、Telegram 与邮件验证码,国内团队可只保留 GitHub 与邮件通道。
- 审核到位:管理界面集中处理待审评论、举报、用户屏蔽与数据导出,配合关键词过滤与频率限制,垃圾评论在进入页面前就能被拦下。
- 接入零耦合:前端只有 1 段配置脚本与 1 个容器节点,静态站、SPA 与多语言站点都能用,路由切换时重新初始化即可。
- 数据自主:MIT 协议、无按量计费,评论与用户数据存在自己的数据库里,导出与迁移不受服务商限制。
产品生态
平台能力
评论支持 Markdown、图片上传、投票、置顶、折叠与嵌套回复;通知支持邮件订阅新回复、Telegram 推送与站内未读提示。管理端可以看到按站点、按用户、按时间的统计,支持把评论导出为 JSON 备份,也支持从其他评论系统导入。防滥用层包括 IP 与用户屏蔽、评论频率限制、匿名开关以及可选的第三方反垃圾服务。
集成
前端通过 embed.js 注入 iframe 组件,SPA 需要在路由变化时调用初始化接口;登录侧需要为每个渠道申请 OAuth 应用并填写 client id 与 secret;通知依赖 SMTP 或 Telegram Bot;图片可落到本地目录或对象存储。运维侧通常放在反向代理后面,配合自动 HTTPS 与每日备份脚本。
典型场景
技术博客与文档站替换第三方评论、内容站把读者讨论留在自有域名下、企业内部文档的批注式讨论、静态站点生成器搭的站点补齐互动、对隐私合规有要求的欧洲站点。
不足之处
- 只做评论,没有版块、私信、用户主页与关注关系,需要完整社区能力时它只能是配件。
- 没有官方托管,OAuth 应用申请、域名证书、邮件送达与备份全部自己维护,出问题要读文档与日志。
- 管理权限模型偏简单,多人协作审核与分级授权需要另建流程或代理层。
- 检索与统计能力有限,评论量大后跨站点分析、全文搜索都要外接工具。
适用场景
- 技术博客与文档站(★★★★☆):接入成本低、数据自持,替换第三方评论后页面加载也更干净。
- 静态站点补互动(★★★★☆):不依赖站点后端,部署 1 个服务即可给全站加评论。
- 企业内部文档批注(★★★☆):可以靠登录限制与站点白名单做出半内部讨论区。
- 隐私合规敏感的场景(★★★☆):无第三方追踪脚本,数据不出境,但登录渠道仍需合规评估。
- 多版块社区运营(★★):缺少版块与用户体系,不适合作为主社区平台。
价格参考
| 项目 | 价格 | 备注 |
|---|---|---|
| Remark42 软件 | 免费 | MIT 协议,源码公开,无授权与按量费用 |
| 服务器 | 按服务商计费 | 小流量 1 核 1GB 可起步,图片与备份占用随评论量增长,金额以报价为准 |
| 域名与证书 | 按年计费 | 评论域名建议独立,可用免费证书 |
| 邮件与推送服务 | 按量计费 | SMTP 用于回复通知与验证码,Telegram Bot 免费,以各家报价为准 |
软件本身零成本,支出集中在服务器与邮件。需要注意 OAuth 应用的维护成本:每个登录渠道都要单独申请与续期,渠道下线时要在配置里及时关闭,否则用户会在登录环节卡住。
常见问题
Remark42 能替代 Disqus 吗?
在评论这一点上可以,功能覆盖匿名、社交登录、通知与审核,并且数据在自己手里。缺少的是 Disqus 的跨站推荐与广告位,以及开箱即用的托管。
静态站点怎么接入?
在页面里放 1 个容器节点与配置脚本,指向已部署的评论服务域名即可。SPA 或按需渲染的框架要在路由切换后重新初始化,否则评论不会跟随页面变化。
支持中文评论与审核吗?
支持。界面有多语言文案,评论正文以 UTF-8 存储,中文关键词过滤与审核都可用;分词搜索不是它的强项,需要全文检索时要外接搜索引擎。
数据怎么备份和迁移?
内嵌数据库是 1 个目录,定期打包即可;也可以在管理端导出 JSON,再导入到新实例。迁移时记得同步站点 id 与密钥,否则老评论会认不到新站点。
代码示例
用 Docker 启动评论服务
export REMARK_URL="https://comments.example.com"
export SITE="example.com" # 站点 id,多站点时用逗号分隔
export SECRET="$REMARK_SECRET" # JWT 签名密钥,务必备份
export ADMIN_PASSWD="$REMARK_ADMIN_PASS" # 管理后台密码
docker run -d --name remark42 \
-p 8080:8080 \
-e REMARK_URL="$REMARK_URL" \
-e SITE="$SITE" \
-e SECRET="$SECRET" \
-e ADMIN_PASSWD="$ADMIN_PASSWD" \
-e AUTH_GITHUB_CID="$GH_CLIENT_ID" \
-e AUTH_GITHUB_CSEC="$GH_CLIENT_SECRET" \
-e AUTH_ANON=true \
-e NOTIFY_EMAIL="$NOTIFY_EMAIL" \
-e SMTP_HOST="$SMTP_HOST" \
-v "$PWD/var:/srv/var" \
ghcr.io/umputun/remark42:latest
SECRET 一旦更换,所有历史会话的签名都会失效,用户需要重新登录,所以要在备份里保留原值。
在页面中嵌入评论组件
<div id="remark42"></div>
<script>
var remark_config = {
host: "https://comments.example.com", // 评论服务地址,需与 REMARK_URL 一致
site_id: "example.com", // 与后端 SITE 对应
components: ["embed"],
url: window.location.href,
locale: "zh"
};
</script>
<script src="https://comments.example.com/web/embed.js" defer></script>
<noscript>请启用 JavaScript 以查看评论。</noscript>
site_id 与后端不一致时评论区会显示为空而不是报错,这是最常见的接入问题。
社区与资源
社区与官方渠道
- Remark42 官网 — 功能演示、部署方式与版本说明
- Remark42 文档 — 参数、登录渠道与审核后台的完整配置
- Remark42 GitHub 仓库 — 源码、issue 与发布记录
- 官方演示站 — 直接体验评论与后台界面
学习资源与工具
- Docker 官方文档 — 镜像运行、卷挂载与环境变量管理
- Telegram Bot 文档 — 用 Bot 接收评论通知的配置参考