没错,我的博客的评论没了
前言
我用的是 Waline 评论系统,之前部署在 Netlify 上,存储好像用的是 MongoDB —— 忘了🤪
一段时间没管,也不知道干了什么:
- 邮件通知挂了
- 评论加载特别慢
干脆重新在 Vercel 部署了一个。
重新部署 Waline 到 Vercel
1. 一键部署
Waline 官方支持 Vercel 一键部署,非常省心:
- 打开 Waline 官方文档
- 点击 “Deploy with Vercel” 按钮
- 登录 GitHub 账号授权
- 填写必要的环境变量(见下文)
- 等待部署完成
2. 环境变量配置
在 Vercel 项目的 Settings → Environment Variables 中配置:
| 变量名 | 说明 | 示例 |
|---|---|---|
LEAN_ID | LeanCloud App ID | 你的 LeanCloud App ID |
LEAN_KEY | LeanCloud App Key | 你的 LeanCloud App Key |
LEAN_MASTER_KEY | LeanCloud Master Key | 你的 LeanCloud Master Key |
SITE_NAME | 站点名称 | 我的博客 |
SITE_URL | 站点地址 | https://yourblog.com |
SMTP_SERVICE | SMTP 服务商 | 例如 QQ / 163 / Gmail |
SMTP_USER | 发件邮箱 | your-email@example.com |
SMTP_PASS | 邮箱授权码 | 你的授权码 |
AUTHOR_EMAIL | 博主邮箱 | 用于接收通知 |
💡 关于存储:Waline 支持多种数据库,包括 MongoDB、PostgreSQL、MySQL、SQLite、LeanCloud 等。我这次用的是 neon,免费额度够用,而且不用自己维护 MongoDB。
3. 绑定自定义域名(可选)
- 进入 Vercel 项目 → Settings → Domains
- 输入你的域名,例如
waline.yourblog.com - 在域名服务商处添加 CNAME 记录:
| Type | Name | Value |
|---|---|---|
| CNAME | waline | cname.vercel-dns.com |
- 等待 DNS 生效,访问
https://waline.yourblog.com/ui/register注册管理员账号
⚠️ 注意:首个注册的用户自动成为管理员,务必第一时间注册!
修复邮件通知
之前邮件通知挂了,这次重新配置了一下,以下是常见问题的排查思路:
检查环境变量
确保以下变量都已正确配置:
SMTP_SERVICE=QQ # 或其他服务商
SMTP_USER=your@qq.com
SMTP_PASS=你的授权码 # 不是登录密码!是 SMTP 授权码
AUTHOR_EMAIL=your@qq.com常见 SMTP 服务商配置
| 服务商 | SMTP_SERVICE | 端口 |
|---|---|---|
| QQ 邮箱 | QQ | 465 |
| 163 邮箱 | 163 | 465 |
| Gmail | Gmail | 465 |
| Outlook | Outlook365 | 587 |
测试邮件发送
部署完成后,可以在 Waline 管理后台发一条测试评论,看看能否收到邮件通知。如果收不到:
- 检查 Vercel 的 Runtime Logs 是否有报错
- 确认邮箱授权码是否正确(不是登录密码)
- 检查垃圾邮件箱
客户端接入
在你的博客页面中引入 Waline 客户端:
<!-- 引入 Waline CSS -->
<link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />
<!-- 引入 Waline JS -->
<script src="https://unpkg.com/@waline/client@v3/dist/waline.js"></script>
<script>
Waline.init({
el: '#waline',
serverURL: 'https://waline.yourblog.com', // 你的 Waline 服务地址
path: window.location.pathname,
// 可选配置
dark: 'html[data-theme="dark"]',
comment: true,
pageview: true,
});
</script>
<!-- 评论容器 -->
<div id="waline"></div>📌 注意:V3 版本不需要手动引入 CSS,但为了兼容性建议保留。如果使用的是旧版 Waline,请根据文档调整。
数据迁移(可选)
如果你之前的数据还在 MongoDB 里,想迁移到新部署的 Waline,可以:
- 导出旧数据:从 MongoDB 导出 JSON/CSV
- 导入新数据库:根据新部署使用的数据库类型,使用对应工具导入
- 或者直接放弃:评论不多就重新来过,反正博客也没几个人看(不是
😅 我这次就是直接放弃了旧数据,反正之前的评论也没几条,重新来过更清爽。
总结
| 项目 | 之前 | 现在 |
|---|---|---|
| 部署平台 | Netlify | Vercel |
| 数据库 | MongoDB(忘了) | neon |
| 邮件通知 | ❌ 挂了 | ✅ 正常 |
| 加载速度 | 🐢 特别慢 | 🚀 飞快 |
| 历史评论 | 😭 没了 | 🆕 重新开始 |
虽然评论没了有点心疼,但重新部署后一切正常,邮件通知也恢复了,加载速度肉眼可见地提升。Vercel + neon 的组合对于个人博客来说完全够用,而且免费。
下次一定要记得备份数据!
📝 本文写于 2026-06-13,Waline 版本为 v3.15.2,如有变动请以 官方文档 为准。
