Waline

本文介绍了作者在使用 Waline 评论系统时遭遇的后台空白故障及其解决过程。某天作者发现管理后台页面完全空白，反复刷新并更换浏览器均无效，随后重新部署时遇到 Vercel 502 错误，经排查得知是 @waline/vercel 新版本存在兼容问题。在 DeepSeek 指导下手动回退版本号后编译通过，但后台仍为空白。作者向 Waline 提交了 Issue，详细描述了现象、步骤和日志。项目负责人认为与另一 Issue 相似，但作者对比后发现本质不同，并补充了截图和日志。当日下午，维护者 lizheming 确认问题源于新版 Waline 核心模块改动引发的连锁反应，导致所有基于新版的后台均失效。当晚，外国用户和作者朋友峰哥也反馈了同样问题。作者通过修改 Neon 数据库中评论的 user_id 字段使评论正确显示博主标签。深夜，维护者发布了修复版本，去除了有问题的功能模块，虽然界面简陋但核心功能恢复。全文展示了开源社区快速响应（一天内修复）的优势，也指出了活跃项目频繁重构（如 Rust 重写）给用户带来的升级困扰。

本文介绍了作者对个人网站进行的一次大规模破坏式更新，主要包括导航栏顺序调整、合并友链与社交入口、新增工单和留言页面，并移除了分类与标签入口。网站彻底删除了对 Giscus 评论系统的支持，保留 Waline 匿名评论功能以提升访客积极性；同时移除了大部分特效和浅色模式，统一为深色主题，并更换了更符合风格的图片。技术方面，新增 PWA 适配以提升缓存和加载速度，移除 PJAX 并恢复 Lazyload 懒加载，优化了性能。文章还提醒老读者务必清除浏览器缓存，并分享了网站图标设计建议。作者感谢读者支持，鼓励大家继续进步。

本文介绍了作者因 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 的用户快速完成邮件通知配置，避免遗漏关键变量。