type
status
date
slug
summary
tags
category
icon
password
最近给自己的博客（基于 NotionNext）添加评论功能，选用了轻量又漂亮的 Twikoo。过程中踩了一些坑，在这里做个完整记录，方便后来人也方便自己备忘。
1. 添加 Twikoo 评论插件
NotionNext 支持多种评论系统（如 Giscus、Valine、Cusdis 等），我选择的是 Twikoo。
我是在 Vercel 里面发布的我的 NotionNext 博客。所以只需要Vercel 后台Setting-Enviroment Variables 中加入NEXT_PUBLIC_COMMENT_ENV_ID值为配置的 twikoo 地址即可。具体添加配置如下：
2. 使用 Vercel 部署 Twikoo 遇到的问题
一开始尝试将 Twikoo 作为 Serverless 应用部署到 Vercel，很快部署成功，但无法登录后台，一直报错，无法正常管理评论。
排查发现，Twikoo 后台登录基于 IP 判断权限，而 Vercel 由于运行在无状态环境中，对 IP 管控有限，导致后台登录失效。
3. 改用 ECS + Docker 部署 Twikoo
最终选择了最稳妥的方案：自建服务器（ECS）+ Docker 部署 Twikoo。
部署流程：
部署成功后，可以通过 http://目标 IP:8080 访问 Twikoo 接口，后台登录也正常！
4. 评论区语言变成英文？一行代码搞定
部署完后发现前端评论区界面是英文的，排查后发现是语言设置的问题。
解决办法：在 Notion 中，找到博客配置页面的 config 区块，将 LANG 设置为 zh-CN 即可。
刷新页面后，评论区切换为中文界面，完美！
5. 插件版本不一致导致功能异常
有网友反馈 Twikoo 前端插件版本过旧，导致部分功能无法使用。官方说明需要在 blog.config.js 中修改版本号，但实际上（NotionNext 的版本可能不同）应在以下路径修改：
找到如下这行代码：
将里面的 Twikoo CDN 版本号设置为最新即可。例如：
改完重新部署，前端和后端版本一致，功能恢复正常。
6. 总结
整个过程踩了几个小坑，但收获也不小：
- ✅ Vercel 发布方便但不适合 Twikoo 后台
- ✅ Docker + ECS 稳定可靠
- ✅ config.LANG 控制前端评论语言
- ✅ 评论插件版本需要手动更新，注意路径
希望这篇记录能帮到你，也欢迎留言交流更多使用经验。
如果你有更多关于 NotionNext 或 Twikoo 的使用心得，也欢迎分享！💬
7. 参考文献
- 作者:小月半子
- 链接:http://www.izhiku.edu.kg/article/NotionNext_install_twikoo
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
