手把手教你为 Butterfly 部署和配置 Umami 访问统计
本文介绍了作者因对不蒜子统计 API 的不稳定感到困扰,并在发现网站总浏览量接近两万后,对访客来源、设备类型等数据产生强烈好奇,最终决定部署开源网站分析工具 Umami 的过程。文章详细描述了 Umami 的部署步骤:首先通过 Vercel 官方链接一键克隆仓库,创建项目并配置 Neon 数据库实现自动集成注入环境变量 DATABASE_URL,其次绑定自定义域名或使用 Vercel 提供的二级域名,然后触发重新部署。部署完成后使用默认账号 admin 和密码 umami 登录,并立即修改密码并切换界面语言为简体中文。核心环节是将博客网站添加到 Umami 统计界面,通过修改 Hexo 主题配置文件(如 _config.butterfly.yml),将 enable 设为 true,填入 serverURL 和从 Umami 控制台获取的 website_id,并可按需关闭不蒜子以避免数据冗余。最终,Umami 能提供访客国家地区地图展示、页面停留时间、访客行为等详细分析,帮助作者根据数据优化写作方向。全文强调通过 Vercel 与 Neon 的深度集成,部署过程已极为简化,即使是技术基础薄弱的用户也可按步骤完成。
Waline 后台空白问题:一天内从排查到修复
本文介绍了作者在使用 Waline 评论系统时遭遇的后台空白故障及其解决过程。某天作者发现管理后台页面完全空白,反复刷新并更换浏览器均无效,随后重新部署时遇到 Vercel 502 错误,经排查得知是 @waline/vercel 新版本存在兼容问题。在 DeepSeek 指导下手动回退版本号后编译通过,但后台仍为空白。作者向 Waline 提交了 Issue,详细描述了现象、步骤和日志。项目负责人认为与另一 Issue 相似,但作者对比后发现本质不同,并补充了截图和日志。当日下午,维护者 lizheming 确认问题源于新版 Waline 核心模块改动引发的连锁反应,导致所有基于新版的后台均失效。当晚,外国用户和作者朋友峰哥也反馈了同样问题。作者通过修改 Neon 数据库中评论的 user_id 字段使评论正确显示博主标签。深夜,维护者发布了修复版本,去除了有问题的功能模块,虽然界面简陋但核心功能恢复。全文展示了开源社区快速响应(一天内修复)的优势,也指出了活跃项目频繁重构(如 Rust 重写)给用户带来的升级困扰。
一次 Waline 评论迁移:被 Vercel 路径坑惨的血泪教训
本文介绍了作者因 GitHub 被封导致 Vercel 无法使用,不得不将博客评论区迁移到自家树莓派的过程。文章详细描述了使用 Waline 导出评论后,在迁移至 Cloudflare Pages 时发现评论大量丢失的乌龙事件。经过与 DeepSeek 彻夜排查,最终发现罪魁祸首是 Vercel 的路径问题:Vercel 将文章时间错误改为 10 号,导致路径为 2026/04/10,而本地正确路径为 2026/04/11,因此本地浏览时评论显示异常。此外,友链页面也因 Vercel 与 Cloudflare Pages 路径规范差异(是否带尾部斜杠)而无法显示评论。最终作者通过修改 Waline 源文件中的路径重新导入,成功恢复评论。文章强调 Waline 数据自主可控的优势,提醒开发者注意平台路径差异带来的兼容性问题。
Hexo 博客部署平台选哪个?四大平台优缺点对比
本文介绍了 Vercel、Cloudflare Pages、Netlify 和 GitHub Pages 四种静态网站部署平台。Vercel 部署 Hexo 简单快速,但默认域名国内被屏蔽,需购买域名;Cloudflare Pages 速度仅次于 Vercel,同样需要自定义域名;Netlify 默认域名国内可访问,无需购买域名;GitHub Pages 最简单但速度最慢,仅支持静态页面和 Jekyll,其他框架需配置 Actions,优点是其 github.io 域名国内可访问。文章最后给出推荐顺序:Vercel 为首选,其次 Cloudflare Pages,再次 Netlify,最后 GitHub Pages。






