Momo Backend

轻量，便捷，易部署的博客评论系统

主要功能

• 💬 多级嵌套评论 — 支持无限层级的树形回复，Markdown 编辑，自动渲染 HTML
• 🤖 两层无感验证 — Turnstile 风格人机验证。第一层是 HashWX 工作量证明；第二层是 Instrumentation 环境质询。另有蜜罐字段 + IP 绑定票据，无需任何第三方服务
• 🛡️ 安全防护 — IP 封禁、黑名单（IP/邮箱）、XSS 过滤、评论频率限制、管理员评论密钥验证、反向代理真实 IP 识别；可选来源域名绑定（挑战签发/答案兑换/评论提交三处都要求来源命中白名单，挡住「把组件搬到别的站点」与跨站点搬运凭证）
• 📧 邮件通知 — SMTP 配置，新评论及回复自动通知，支持自定义模板与邮箱验证；通知邮件发送渲染后的内容（图片 / 表情 / 链接）；所有外发邮件都会留痕，管理面板的邮件管理页可按状态/类型/收件人筛选与搜索
• 🔗 链接安全审查 — 长期未再来评论的用户，其历史个人网址自动标记为「休眠」：访客点击只看到「暂时无法由本站跳转访问」的小浮窗，本人再次评论即自动解除
• 📈 认证记录 — 每一次人机验证的签发/通过/失败、解题耗时与来源 IP/域名都会落库：管理面板提供指标卡、趋势折线、失败原因与地域/运营商 Top 榜（地域数据仅 Cloudflare Worker 部署有），保留期与是否记录签发事件均可配置
• 😀 表情多来源 — 评论区表情支持最多 5 个 OwO 格式地址（owo.json 同构），按顺序拼接合并成一个面板，由访客浏览器直接拉取
• 📊 管理面板 — 评论审核、数据概览统计、认证记录分析、邮件管理、用户搜索与黑名单管理、模块化系统设置
• ⚡ 多后端支持 — Node.js 、Go 、Cloudflare Worker 三种实现
• 🔄 数据管理 — JSON 格式导入/导出，方便备份迁移
• 🎨 前端组件 — Svelte 5 构建的轻量评论组件，支持 CDN 引入、多语言、暗色模式和自定义占位符
• 🗄️ SQLite 存储 — 零配置数据库，无需额外安装数据库服务

快速开始

Momo Backend 包含前端和后端两个模块，需要分别进行部署。

前端部署

前端即为评论页面，一般集成在博客、论坛等位置，用于提交并展示评论，使用 Svelte 5 开发。

前端可以通过 CDN 引入，也可以自行修改编译成 JS 文件，集成到自己的项目中。具体部署方式参考 frontend。

如果需要自己设计前端样式，或集成到已有的评论组件中，可参考 API 文档 自行开发。

后端部署

后端用于提供评论存储和管理服务，包括 API 应用和管理面板。

API 应用

API 应用基于 SQLite 数据库，对外提供 RESTful API，目前提供四种部署方式：

• Docker 版本 — 一键部署，推荐方式
• Node.js 版本 — 基于 Hono 4 + Drizzle ORM，适合有 Node.js 环境的服务器
• Go 版本 — 编译为单二进制文件，部署简单性能优异
• Cloudflare Worker 版本 — 基于 Hono + D1 + KV，无需服务器

如需其他平台的部署支持，欢迎提交 Issue。

具体部署方式请参考对应文档：Docker · Node.js · Go · Cloudflare Worker

Docker 部署

Go 版本支持 Docker 一键部署，镜像同时发布在 GitHub Container Registry 与 Docker Hub。

# 使用 docker-compose（推荐）
curl -fsSLO https://raw.githubusercontent.com/Motues/Momo-backend/main/docker-compose.yml
docker compose up -d

# 或直接运行（两个仓库内容相同，任选其一）
docker run -d \
  --name momo-backend \
  -p 3000:3000 \
  -v momo-data:/app/data \
  ghcr.io/motues/momo-backend:latest

# Docker Hub
docker run -d \
  --name momo-backend \
  -p 3000:3000 \
  -v momo-data:/app/data \
  motues/momo-backend:latest

启动后访问 http://localhost:3000，默认管理员账号密码均为 momo。

管理面板

提供可视化面板对评论数据进行管理，基于 Vue 3 构建。

Release 中默认已集成编译好的静态文件（./public 目录），部署后可直接访问 /admin 路径打开管理面板。

源码位于 ./dashboard 目录，可自行修改页面样式和功能，修改后执行 pnpm build 重新编译。

版本更新

项目仍处于维护状态，不定期更新。更新前请参考更新文档。

界面展示

点击查看界面预览

前端评论页面展示

管理后台登录界面

管理后台首页

相关文档

• API 文档 — 完整的接口定义和调用示例
• 数据库表结构 — 数据表字段说明
• 更新文档 — 版本升级指南
• 表情来源格式 — owo.json 形状与多来源拼接合并口径
• 多管理员邮箱 — 管理员列表与通知收件邮箱
• 邮件内容渲染 — 通知邮件里的 HTML 与表情水合
• 链接安全审查 — 休眠链接与历史链接批量更新
• Momo 静态博客 — 配套博客主题

测试

三套后端、管理面板与前端组件都配有自动化测试。除 Go 使用标准库 testing 外，其余均使用 Vitest。

# 三套后端
cd nodejs && pnpm test       # Hono + Drizzle：纯逻辑单测 + 真实 SQLite 上的接口集成测试
cd worker && pnpm test       # vitest-pool-workers：纯逻辑单测 + 内存 D1 / KV 上的接口集成测试
cd go     && go test ./...   # utils、repository、handler 三层

# 前端与管理面板
cd frontend  && pnpm test
cd dashboard && pnpm test

开发计划

• 支持其他评论系统的数据迁移（Twikoo、Valine 等）

欢迎提交 Issue 和 PR，共同完善项目。
Made with ❤️ by Motues