type
status
date
slug
summary
tags
category
icon
password
😀
在完成了NotionNext博客搭建，以及将其静态化之后。我想如何能为它安排一个留言板（评论插件） 但这个过程比我想像的艰难百倍，把笔记记录下来，免得回头忘记了
 

01 为什么放弃了Cusdis

我在网上看到对Cusdis的赞美很多。但是我体验了几天之后发现有大问题
1）要命！它居然采用的是iframe形式，把留言区限制在一个区块里，别说留言呈现不出来，连submit按钮都被挡住了，需要“划动这个区域”，才能看到按纽和人们已经有的留言。我开始以为是我自己的问题，后来打听了半天，甚至我去了他的官方惊讶的看到官方自己的留言也是这个屎样，就知道可以放弃了。当然，在放弃之前，我不甘心的和AI协作修改css，改了两天发现搞不定。
2）更要命的是这个留言区在微信里面根本显示不了，必须得用手机自带浏览器打开这个网址才能显示出来，这意味着在中国几乎他就没有办法用。
我的要求和想法是： 1）留言者无需注册（体验好） 2）数据可以导入导出（防平台跑路） 3）可设置审核后呈现（防垃圾留言）
经过搜索和与DeepSeek对话以及性能对比后，我决定换成twikoo。
 

02 twikoo的部署比想象的难得多

三天！在AI强大的鼓励（反向PUA）下，我进行了上百次DEBUG。
看看AI是如何PUA我的
notion image
notion image
notion image
notion image
最初，我尝试了两种主流的 Node.js 应用部署方案：
  1. PM2 进程管理：这是最直接的思路。但 npm install 过程频繁失败，主要表现为无法从 npm 官方源或 GitHub 下载依赖包，导致模块缺失，服务无法启动。
  1. Docker 容器化：为了隔离环境并简化依赖管理，我转向 Docker。然而，同样由于网络问题，docker pull 无法拉取基础镜像，此路亦不通。
在与我的 AI 开发助手 CodeBuddy 的多轮协作中，我们尝试了更换国内镜像源等多种方案，但由于依赖链条中仍存在无法通过镜像解决的资源，这些尝试均未取得稳定成功。整个过程耗时近三天，进行了上百次调试，核心症结始终是网络环境下的依赖解析问题。
在多次清理失败的部署残留后，我意识到零散地解决单个错误是低效的。问题的根源在于环境的特殊性，因此需要一个能够适应这种环境的、系统性的解决方案。
我向 AI 助手提出了一个更明确的需求：生成一个自动化的一键安装脚本。该脚本必须满足以下几个关键条件：
  • 自包含性：预先处理好所有依赖，避免在服务器上进行实时网络下载。
  • 环境适应性：考虑到服务器无法访问外网的现实，内置所有必要的国内镜像或离线资源。
  • 原子性操作：将环境准备、安装、配置、启动服务的完整流程整合到一个脚本中，减少手动干预。
AI 助手在理解了前期所有失败尝试的上下文后，生成了一个综合性的 Shell 脚本。我们共同对该脚本进行了三到四轮的迭代和修正，解决了其中路径、权限和配置上的一些细节问题。
最终，这个经过优化的脚本成功地在目标服务器上一次性完成了 Twikoo 的部署、配置和启动。
我觉得关于在于这个脚本。我把它上传上来，供需要的朋友参考
 

03 共享我的安装脚本

一键安装脚本.sh
13.1 KB
↑↑↑↑↑↑↑点击下载
 

04 安装方法

1）把 [一键安装脚本.sh] 上传到你的服务器某个位置，比如/www/wwwrot/twikoo/（我用的阿里云），你用宝塔或命令都可以上传
2) 执行下面这个命令
3）这个脚本里集成了所有的安装步骤，并为相关步骤准备了各种国内镜像源供服务器挨个安装，并且集成了最终的测试和启动。它会
 
总之，最后我就是靠这个莫名地搞定了。
最后，我看到了
 

05 安装完成后

你最好做一个反向代理，让它成为你域名的子目录，因为你让它是一个子域名的话，还得单独申请SSL，太麻烦了，我喜欢统一用域名下的子目录。
同时，还要让这个留言插件在你的notionNext上跑起来。
这些工作很简单，让AI IDE去干就好了。
你可以在我的文章下留言试试效果。我很满意。

后续配置：开启审核与邮件通知

为了有效管理评论并及时获取通知，建议完成以下两项关键配置。

1. 开启评论审核模式

此功能可有效拦截垃圾评论，确保所有新评论在您批准后才公开显示。
  • 步骤 1：进入管理面板 在您博客中任何一个加载了 Twikoo 评论区的页面，找到评论框右上角的设置图标 (⚙️)，点击后选择“管理”。
  • 步骤 2：登录 输入您之前设定的管理员密码以登录（如果是第一次，会要求你设置个密码）
  • 步骤 3：定位配置项 在管理面板中，找到并进入“垃圾评论过滤” (Spam) 设置区域。
  • 步骤 4：启用手动审核 找到 AKISMET_KEY 字段，将其值修改为 MANUAL_REVIEW (注意需全大写)。
  • 步骤 5：保存 点击页面底部的“保存”按钮使设置生效。

2. 配置邮件通知

设置后，每当有新评论时，系统会自动发送邮件提醒到您的指定邮箱。以下以国内常见邮箱服务商为例。
  • 步骤 1：获取邮箱授权码 登录您的邮箱网页版（如 126、QQ 邮箱等），在“设置”中找到 POP3/SMTP/IMAP 相关选项，开启 SMTP 服务并获取一个授权码。请注意，这是专用的授权码，不是您的邮箱登录密码。
  • 步骤 2：进入邮件配置 按照上一节的方法进入 Twikoo 管理面板，找到并进入“邮件通知” (Email notification) 设置区域。
  • 步骤 3：填写配置信息 根据界面提示，填写以下字段：
    • SENDER_EMAIL: 您的发件邮箱地址 (例如: yourname@126.com)
    • SENDER_NAME: 邮件中显示的发件人名称 (例如: 我的博客)
    • SMTP_SERVICE: 您的邮箱服务商 (例如: 126, QQ)
    • SMTP_USER: 您的邮箱用户名 (通常是完整的邮箱地址)
    • SMTP_PASS: 您在步骤 1 中获取的授权码
    • MAIL_SUBJECT: 自定义通知邮件的主题
    • MAIL_TO: 接收评论通知的邮箱地址 (通常是您自己)
  • 步骤 4：测试与保存 点击“测试”按钮，检查 MAIL_TO 邮箱是否能收到测试邮件。确认无误后，点击页面底部的“保存”按钮完成配置。
这样，当有人留言时，你就会收到邮件啦！