Home
avatar

𝑿𝑴𝑯𝑨𝑰

没错,我的博客的评论没了

前言

我用的是 Waline 评论系统,之前部署在 Netlify 上,存储好像用的是 MongoDB —— 忘了🤪

一段时间没管,也不知道干了什么:

  • 邮件通知挂了
  • 评论加载特别慢

干脆重新在 Vercel 部署了一个。


重新部署 Waline 到 Vercel

1. 一键部署

Waline 官方支持 Vercel 一键部署,非常省心:

  1. 打开 Waline 官方文档
  2. 点击 “Deploy with Vercel” 按钮
  3. 登录 GitHub 账号授权
  4. 填写必要的环境变量(见下文)
  5. 等待部署完成

2. 环境变量配置

在 Vercel 项目的 Settings → Environment Variables 中配置:

变量名说明示例
LEAN_IDLeanCloud App ID你的 LeanCloud App ID
LEAN_KEYLeanCloud App Key你的 LeanCloud App Key
LEAN_MASTER_KEYLeanCloud Master Key你的 LeanCloud Master Key
SITE_NAME站点名称我的博客
SITE_URL站点地址https://yourblog.com
SMTP_SERVICESMTP 服务商例如 QQ / 163 / Gmail
SMTP_USER发件邮箱your-email@example.com
SMTP_PASS邮箱授权码你的授权码
AUTHOR_EMAIL博主邮箱用于接收通知

💡 关于存储:Waline 支持多种数据库,包括 MongoDB、PostgreSQL、MySQL、SQLite、LeanCloud 等。我这次用的是 neon,免费额度够用,而且不用自己维护 MongoDB。

3. 绑定自定义域名(可选)

  1. 进入 Vercel 项目 → Settings → Domains
  2. 输入你的域名,例如 waline.yourblog.com
  3. 在域名服务商处添加 CNAME 记录:
TypeNameValue
CNAMEwalinecname.vercel-dns.com
  1. 等待 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 邮箱QQ465
163 邮箱163465
GmailGmail465
OutlookOutlook365587

测试邮件发送

部署完成后,可以在 Waline 管理后台发一条测试评论,看看能否收到邮件通知。如果收不到:

  1. 检查 Vercel 的 Runtime Logs 是否有报错
  2. 确认邮箱授权码是否正确(不是登录密码)
  3. 检查垃圾邮件箱

客户端接入

在你的博客页面中引入 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,可以:

  1. 导出旧数据:从 MongoDB 导出 JSON/CSV
  2. 导入新数据库:根据新部署使用的数据库类型,使用对应工具导入
  3. 或者直接放弃:评论不多就重新来过,反正博客也没几个人看(不是

😅 我这次就是直接放弃了旧数据,反正之前的评论也没几条,重新来过更清爽。


总结

项目之前现在
部署平台NetlifyVercel
数据库MongoDB(忘了)neon
邮件通知❌ 挂了✅ 正常
加载速度🐢 特别慢🚀 飞快
历史评论😭 没了🆕 重新开始

虽然评论没了有点心疼,但重新部署后一切正常,邮件通知也恢复了,加载速度肉眼可见地提升。Vercel + neon 的组合对于个人博客来说完全够用,而且免费。

下次一定要记得备份数据!


📝 本文写于 2026-06-13,Waline 版本为 v3.15.2,如有变动请以 官方文档 为准。

waline 教程