Twikoo 评论系统部署全流程

本文是我这个博客集成轻量级评论系统 Twikoo 的实操记录，基于 MongoDB Atlas 存储评论数据，通过 Vercel 部署 Twikoo 云函数，最终实现博客评论功能。

项目背景

Twikoo 是一款开源轻量级评论系统，支持匿名评论、邮件通知等功能，无需后端服务，通过云函数 + MongoDB 即可搭建。本次部署将 MongoDB Atlas 作为数据存储端，Vercel 作为云函数托管平台，完成评论功能集成，本人也在使用这套系统，非常方便，重点是全开源+免费，非常适合个人博客搭建使用。

一、MongoDB Atlas 配置（数据存储端）

1. 创建数据库用户

   用于 Twikoo 连接 MongoDB 的身份凭证

   ---

   • 进入 MongoDB Atlas 的Database Users页面，点击Add New Database User。
   • 设置用户名和密码（建议使用强密码），权限选择atlasAdmin@admin（测试环境，生产环境可按需分配权限）。
   • 创建完成后，页面会显示已创建的用户，记录用户名和密码。

2. 配置 IP 访问白名单

   允许 Vercel 云函数访问 MongoDB 集群

   ---

   • 进入IP Access List页面，点击Add IP Address。
   • 弹出窗口中：
   • 测试环境可选择ALLOW ACCESS FROM ANYWHERE（对应 IP 段0.0.0.0/0，生产环境不推荐，需限制 Vercel 出口 IP）
   • 本地测试可选择Add Current IP Address
   • 点击Confirm保存配置。

3. 获取访问链接

   获取 Vercel 云函数访问 MongoDB 集群的链接

   ---

   • 进入Project Overview首页，查看当前MongoDB集群状态，点击Connect。
   • 选择Connect to your application。
   • 复制链接，替换自己设置的<db_password>，点击Done完成MongoDB Atlas配置。

二、Vercel 部署 Twikoo 云函数

1. 导入 Twikoo 项目

   • 进入 Vercel 控制台，选择Import Git Repository，输入 Twikoo 仓库地址：https://github.com/imaegoo/twikoo。
   • 选择 Git 提供商（如 GitHub）授权后，进入项目创建页面。

2. 创建 Vercel 项目

   • 配置 Git 仓库信息：选择 Git Scope、填写私有仓库名称。
   • 选择 Vercel Team（个人用户可选默认），计划选择Hobby（免费），点击Create开始部署。

3. 配置环境变量

   添加 MongoDB 连接串，让 Twikoo 云函数连接数据库

   ---

   • 进入项目的Settings > Environment Variables。
   • 添加变量MONGODB_URI，值为 MongoDB Atlas 的连接串（格式如下）。

        # 自行替换为刚刚在MongoDB Atlas获取的链接，以下为实例，实际使用需替换<用户名>、<密码>、<mongodb链接>、<集群名>为实际信息
        mongodb+srv://<db_name>:<db_password>@xxxxxxx.mongodb.net/?appName=<db_cluster_name>

   • 保存后，点击部署记录的Redeploy使环境变量生效。

4. 部署验证

   • 进入Deployments页面，查看部署状态为Ready。
   • （可选）可在Settings > Deployment Protection中开启 Vercel Authentication，限制仅团队成员访问云函数。
   • 访问部署后的域名，显示{“code”:100,“message”:“Twikoo 云函数运行正常，请参考…”}，说明部署成功。

三、自有博客集成 Twikoo

此章节为本博客集成示例，仅供参考，各位需按照自己项目进行集成。

---

• 配置文件中添加 Twikoo 配置，启动后，即可显示 Twikoo 评论框

// src/configs/comment.ts
export default {
    type: "twikoo",
    envId: "https://你的Vercel云函数域名" // 替换为实际部署域名
};

Twikoo 功能亮点

• 🚀 轻量无依赖：仅需云函数 + MongoDB，无需自建后端。
• 📧 通知支持：评论、回复的邮件通知。
• 🔒 数据自主：评论数据存储在自己的 MongoDB 中，隐私可控。
• 📱 响应式：适配移动端与桌面端显示。

结语

通过 MongoDB Atlas+Vercel 的组合，可快速实现轻量级评论系统的部署，既保证了数据自主性，又无需维护服务器。本流程适用于个人博客、静态站点的评论功能集成，若需更高安全性，可进一步限制 MongoDB 的 IP 访问范围与 Vercel 云函数的访问权限。

---

最后更新：2025-12-29