lightweight, privacy-friendly alternative to Disqus.
Cusdis is an open-source, lightweight (~5kb gzip), privacy-friendly alternative to Disqus.
Features
- Lightweight comment widget, with i18n, dark mode.
- Email notification
- Webhook
- Easy to self-host
- Many integrations
Documentation
Community
FAQ
Compared to Disqus
Cusdis is not designed to be a complete alternative to Disqus. It's aim is to implement a minimalist and embeddable comment system for small websites (such as your static blog).
Given below are the pros and cons of Cusdis:
Pros
- Cusdis is open-source and self-hostable. Hence, you own your data.
- The SDK is lightweight(~5kb gzipped).
- Cusdis doesn't require your user to sign in to make a comment.
- Cusdis doesn't use cookies at all.
Cons
- Cusdis is on the early stages of its development.
- There is no spam filter, hence, you will have to manually moderate your comment section and comments won't be displayed until you approve them.
- Disqus is a company, we aren't.
from https://github.com/djyde/cusdis
-----
A lightweight, privacy-first, open-source comment system.
Cusdis is an open-source, lightweight, privacy-first alternative to Disqus. It's super easy to use and integrate with your existing website.
from https://cusdis.com/
-----------
轻量级开源免费博客评论系统解决方案 （Cusdis + Railway）
本篇是关于博客评论系统的解决方案，我最早使用的博客评论系统是万恶的 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 实例，我们主要示范一下自行部署方式。
作为一个爱折腾的人，这个评论系统我们就用 Railway 来搭建部署。
Railway 和 Vercel 类似，也是一个 PaaS 平台，能够支持多种语言项目的部署。对于个人项目来说，它每月提供的 5 美元免费额度非常够用，实测了一下，把之前的 umami 网站数据统计系统 连同 Postgre SQL 数据库实例部署在 Railway 平台，大约一个月 0.7 美元，对于个人使用来说完全足够。
比起 Vercel，它同时支持部署数据库实例，可以将数据库与实例一起部署在单个项目中，减少搭建维护成本。下文会对具体搭建部署流程做个记录，因为官方支持 Railway 一键部署方式，整个搭建流程很顺畅。
搭建部署说明
使用 Railway 一键部署服务与数据库实例
首先注册一个 Railway 账号，可以用我的邀请链接。注册登录完成后，点击右上角 New Project 新建项目。
然后输入 Cusdis 进行搜索，点击出现的项目即可开始部署。前几步也可以通过点击 Cusdis 项目仓库 中的 Deploy on Railway 按钮进行一键部署。
开始部署前，需要手动填入三个环境变量：
- USERNAME: 用来登录的账户
- PASSWORD: 用来登录的密码
- JWT_SECRET: 一个随机字符串
其他一些环境变量已经预先设置默认值，请不要自行修改。
- NEXTAUTH_URL:
${{ RAILWAY_STATIC_URL }} - DB_TYPE:
pgsql - DB_URL:
${{ DATABASE_URL }} - PORT:
3000
点击部署后，等待完成即可，会自动部署服务并初始化数据库。
配置 Cusdis 脚本至个人博客
部署完成后，点击 cusdis 服务生成的链接，点击访问Dashboard。
此处输入部署前配置的用户名与密码，点击登录。登录完成后，点击 Dashboard，进入项目配置页面。
初次登录会弹窗提示需要配置第一个网站，输入网站名称即可完成添加。后续当我们需要添加网站时，点击侧边栏 New Website，填写网站名称即可完成添加。
因为我已经配置了自己的网站，所以界面会有之前的评论记录。
下面我们点击上方 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 模块。
修改后，将其添加到博客的相应位置（一般在最下方），配置部署后，即可看到评论框。
配置自定义域名
Railway 部署自动生成的域名比较长，且有一些字符，不方便记忆。我们可以在 Railway 中为项目配置自定义域名。
例如，我使用的是 Cloudflare 托管的域名，需要先添加一下域名 的CNAME解析记录。
至此，我们的部署已经完成，可以通过域名访问管理后台，进行评论审核等。
更新项目
如前文所述，Cusdis 还是一个正在开发成长的项目，我们想第一时间更新作者发布的新功能。Railway 提供了十分便捷的上游分支管理功能，可以设置项目的父项目，点击即可拉取最新的更新，很方便。
总结
以上就是我们为网站添加 Cusdis 评论系统的全流程，配置完成后，无需后续维护，可以便捷地通过看板来进行网站管理与评论审核，且数据存储在 Postgre SQL 数据库实例中，方便导出备份与迁移。这是我的博客搭建部署系列教程之一，请持续关注，希望能对大家有所参考。
参考资料
No comments:
Post a Comment