评论系统

本文介绍了作者因 GitHub 被封导致 Vercel 无法使用，不得不将博客评论区迁移到自家树莓派的过程。文章详细描述了使用 Waline 导出评论后，在迁移至 Cloudflare Pages 时发现评论大量丢失的乌龙事件。经过与 DeepSeek 彻夜排查，最终发现罪魁祸首是 Vercel 的路径问题：Vercel 将文章时间错误改为 10 号，导致路径为 2026/04/10，而本地正确路径为 2026/04/11，因此本地浏览时评论显示异常。此外，友链页面也因 Vercel 与 Cloudflare Pages 路径规范差异（是否带尾部斜杠）而无法显示评论。最终作者通过修改 Waline 源文件中的路径重新导入，成功恢复评论。文章强调 Waline 数据自主可控的优势，提醒开发者注意平台路径差异带来的兼容性问题。

本文介绍了作者在博客建站过程中对多种评论系统的使用体验与对比。文章首先回顾了作者从 Jekyll 和 Chirpy 主题开始的建站历程，并详细剖析了 Giscus 基于 GitHub Discussions 的简单易用性及其无法迁移评论、多用户混乱通知等缺点。接着分析了 Utterances 和 Gitalk 的不足，如需要 GitHub 登录、加载不稳定等问题。重点探讨了 Waline 及其家族的优越性，包括支持匿名评论、一对一邮件提醒、可迁移数据库以及与网站外观适配等。最后，文章总结了不同场景下的推荐：追求简单可用 Giscus，需要完整后台系统则选择 Waline 或 Twikoo，其他系统则不再推荐。本文为静态网站建站者选择评论系统提供了实用参考。

本文介绍了 Waline 评论系统配置邮箱提醒所需的环境变量，包括 AUTHOR_EMAIL、SITE_URL、SMTP_USER、SMTP_PASS、SMTP_HOST、SMTP_PORT 和 SITE_NAME，并强调一个也不能少。文章指出 SMTP_USER 和 AUTHOR_EMAIL 可以相同，也可使用域名邮箱；同时提醒在 Vercel 或 Docker 部署时，环境变量的写法差异——Docker 版 docker-compose.yml 中值不能带引号。全文旨在帮助已搭建好 Waline 的用户快速完成邮件通知配置，避免遗漏关键变量。