Waline

本文介绍了 1 个用于备份 Waline 评论数据的 Python 脚本及其配套的 GitHub Actions 工作流。脚本基于 Playwright 自动化浏览器操作，通过 Waline 官方提供的一键导出功能，将评论数据保存为 JSON 文件。运行时需要设置环境变量 WALINE_RESET_URLS 获取重置链接，依次访问后台并跳转至迁移页面，点击导出按钮完成下载。文章详细展示了参数解析、链接处理、文件命名及异常处理等核心代码，并说明了 Actions 的定时触发与密钥配置方式。此外，作者提醒用户应创建私密仓库存放备份，并强调保护好备份文件的重要性，因为其中包含的用户信息可能被恶意利用。整体内容兼顾代码展示与技术讲解，适合需要自动化备份 Waline 数据的开发者参考。

本文介绍了由于 Waline 客户端更新导致 Butterfly 主题样式出现异常，例如多出按钮或布局变化，这些并非主题作者更新所致，而是 Waline 自身变动。为解决此问题，文章指导用户如何修改 Butterfly 主题内置的 Waline 版本以固定版本。具体步骤包括：确保使用 Butterfly 主题；找到主题配置文件末尾的 CDN 选项段；定位 waline_js 项，取消注释并指定版本，例如使用 https://unpkg.com/@waline/client@v3.8.0/dist/waline.js；修改后提交源码至 GitHub 等静态服务器，部署后检查评论区结构。文章还指出 Waline 将源码作为 JS 直接引用热更新虽快，但频繁更新无关样式功能反而带来不便，建议开源社区保持本体仅修复 Bug，样式由第三方维护。最终通过固定版本避免不必要的更新问题。

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