轻量级开源免费博客评论系统解决方案（Cusdis + Railway）

《后来的我们 - 五月天》

前言

cusdis_intro

之前写了一篇《免费的个人博客系统搭建及部署解决方案（Hugo + GitHub Pages + Cusdis）》，讲述了一下我使用 Serverless 和一些开源项目搭建的博客系统，也开了个系列来记录搭建过程。

本篇是关于博客评论系统的解决方案，我最早使用的博客评论系统是~~万恶的~~ Disqus，一个笨重且会收集用户隐私的知名评论系统，因为加载比较慢，且免费版本经常会附带一些广告，实在难以忍受，于是换成了另一个基于 GitHub issues 的评论系统 utterances，它会为每篇文章生成一个 issue，将，用户通过授权 GitHub 登录来对 issue 发表评论。这种方式的好处是只需要授权一个 utterances-bot 来进行管理，无需自己部署服务，维护数据库等。但是用了一段时间后，觉得有几点不足：

基于 GitHub API 进行评论管理，如之后接口变动或对这类利用 issue 进行评论的方式进行限制，会不太稳定
读者必须要授权 GitHub 登录，非技术人员或使用移动端阅读的读者使用起来很不方便
会将 GitHub 仓库弄得较乱，也不方便后续迁移到其他系统

经过一番调研 Randy 的 Cusdis 很合我的心意。Cusdis 是一个注重数据隐私的开源的评论系统，十分轻量，经过 gzipped 后大约只有 5kb，从名字来看也知道开发者也是难以忍受 Disqus，自己做了一个替代版，因此它也是支持 Disqus 历史数据导入的，很贴心。

虽然这是一个开发早期的项目，但是已经提供了电子邮件通知以及通过 Webhook 联动 Telegram 等方式进行评论提醒，对使用者来说很方便进行管理。Cusdis 提供了免费托管服务与自行部署两种方式，如果不想折腾可以直接用作者提供的服务。自行部署则需要服务器与一个 Postgre SQL 实例，我们主要示范一下自行部署方式。

因为在上一篇《从零开始搭建一个免费的个人博客数据统计系统（umami + Vercel + Heroku）》中我使用的是 Vercel 和 Heroku 进行搭建的，作为一个爱折腾的人，这个评论系统我们就用 Railway 来搭建部署。

Railway 和 Vercel 类似，也是一个 PaaS 平台，能够支持多种语言项目的部署。对于个人项目来说，它每月提供的 5 美元免费额度非常够用，实测了一下，把之前的 umami 网站数据统计系统连同 Postgre SQL 数据库实例部署在 Railway 平台，大约一个月 0.7 美元，对于个人使用来说完全足够。

railway_price

比起 Vercel，它同时支持部署数据库实例，可以将数据库与实例一起部署在单个项目中，减少搭建维护成本。下文会对具体搭建部署流程做个记录，因为官方支持 Railway 一键部署方式，整个搭建流程很顺畅。

[2024-06-30 更新]

鉴于 Railway 从去年 8 月起已经取消了 Free Plan，如果依然想完全免费使用，可以使用 Vercel/Netlify/Zeabur 免费部署主项目，并在 Supabase 上部署一个免费的 PostgreSQL 数据库实例，把链接作为环境变量传入 Cusdis 服务中即可，其他流程大同小异。

搭建部署说明

使用 Railway 一键部署服务与数据库实例

首先注册一个 Railway 账号，可以用我的邀请链接。注册登录完成后，点击右上角 New Project 新建项目。

railway_dashboard

然后输入 Cusdis 进行搜索，点击出现的项目即可开始部署。前几步也可以通过点击 Cusdis 项目仓库中的 Deploy on Railway 按钮进行一键部署。

new_cusids_starter

开始部署前，需要手动填入三个环境变量：

deploy_cusdis_on_railway

USERNAME: 用来登录的账户
PASSWORD: 用来登录的密码
JWT_SECRET: 一个随机字符串

其他一些环境变量已经预先设置默认值，请不要自行修改。

NEXTAUTH_URL: ${{ RAILWAY_STATIC_URL }}
DB_TYPE: pgsql
DB_URL: ${{ DATABASE_URL }}
PORT: 3000

点击部署后，等待完成即可，会自动部署服务并初始化数据库。

cusdis_deploy_done

配置 Cusdis 脚本至个人博客

部署完成后，点击 cusdis 服务生成的链接，点击访问服务 Dashboard。

cusdis_login

此处输入部署前配置的用户名与密码，点击登录。登录完成后，点击 Dashboard，进入项目配置页面。

初次登录会弹窗提示需要配置第一个网站，输入网站名称即可完成添加。后续当我们需要添加网站时，点击侧边栏 New Website，填写网站名称即可完成添加。

add_new_website

因为我已经配置了自己的网站，所以界面会有之前的评论记录。

cusdis_dashboard

下面我们点击上方 Embed Code，复制弹窗中的代码。

cusdis_embed_code

这部份代码需要根据你所用的博客网站类型不同进行部分修改，具体可参考官方文档的 Integration 模块进行配置。

我所用的是 Hugo，配置如下：

<div id="cusdis_thread"
  data-host="xxx"
  data-app-id="xxx"
  data-page-id="{{ .File.UniqueID }}"
  data-page-url="{{ .Permalink }}"
  data-page-title="{{ .Title }}"
>
</div>

<script defer src="https://cusdis.com/js/widget/lang/zh-cn.js"></script>
<script async defer src="xxx"></script>

其中的 data-host，data-app-id 等都需要以刚复制出的 Embed Code 内容为准。其中 <script defer src="https://cusdis.com/js/widget/lang/zh-cn.js"></script> 主要实现了汉化，不同语言支持详见文档 i18n 模块。

修改后，将其添加到博客的相应位置（一般在最下方），配置部署后，即可看到评论框，呈现效果如下：

cusdis_display