Hexo+Next主题安装Waline评论插件
部署服务端
因为官方文档写的比较详细 简单写写
2026.1.15更新:leancloud已停止服务 ,新版本官方文档是vercel+neon部署
部署数据库https://leancloud.app/(已停止服务参考官方文档)
在Vercel 部署 (服务端)
- clone仓库https://github.com/walinejs/waline
- 在vercel上链接git仓库部署
- Root Directory填写example
- 后续同步fork更新即可
服务端环境变量(不包括数据库相关变量)
环境变量配置教程https://waline.js.org/reference/server/env.html
邮件评论通知教程https://waline.js.org/guide/features/notification.html#%E9%82%AE%E4%BB%B6%E9%80%9A%E7%9F%A5
数据库相关环境变量见:https://waline.js.org/guide/database.html
如果部署在Vercel+neon(postgresql )好像不需要额外增加数据库环境变量 直接在Vercel中关联数据库即可(会自动增加相关环境变量)
Turnstile Key 和 Secret 可在 https://www.cloudflare.com/zh-cn/products/turnstile/ 申请。
GRAVATAR_STR我的设置为(后边的参数为默认头像)
https://cravatar.cn/avatar/{{mail|md5}}?d=https%3A%2F%2Fzlay.fun%2Fuploads%2Ffavicon-96x96_2.png
| SITE_NAME | 我的博客 | 站点名称 |
|---|---|---|
| SITE_URL | https://zlay.fun | 站点地址 |
| TURNSTILE_KEY | 建议开启; Turnstile key,须与客户端同时配置 | |
| TURNSTILE_SECRET | 建议开启; Turnstile secret,服务端使用,不可泄漏 | |
| GRAVATAR_STR | 选填; 头像的代理地址,选填,AVATAR_PROXY为false则走这个url | |
| AVATAR_PROXY | 选填; 头像的代理地址,选填,自定义的时候配置false则走GRAVATAR_STR的url | |
| SENDER_NAME | 站点管理员 | 邮件通知相关; 发信名称 |
| SENDER_EMAIL | [email protected] | 邮件通知相关; 发信的时候显示的地址,如果使用resend,@前面的内容随便填 |
| SMTP_HOST | smtp.resend.com | 邮件通知相关; 我使用的resend的免费发信服务也可以用自己的163邮箱等 |
| SMTP_PORT | 465 | 邮件通知相关; SSL开启默认为465 |
| SMTP_USER | resend | 邮件通知相关; resend的默认用户名 |
| SMTP_PASS | 邮件通知相关; 邮件发信密码 | |
| SMTP_SECURE | true | 邮件通知相关; 是否开启SSL |
| AUTHOR_EMAIL | [email protected] | 博主邮箱,用来接收新评论通知。如果是博主发布的评论则不进行提醒通知。 |
| WEBHOOK | 选填; 评论成功后会向 WEBHOOK 配置的地址发送一条 POST 请求,数据格式在文章末尾,可以配合moepush实现企业微信钉钉飞书等的推送 |
客户端
1 | 在hexo安装插件 |
客户端配置
在根目录下的_config.yml中增加如下代码
1 | # Waline 评论系统start https://www.npmjs.com/package/@waline/hexo-next |
管理
注册
https://{服务端部署地址}/ui/register
管理
https://{服务端部署地址}/ui
LeanCloud 停止服务,数据库迁移
从LeanCloud 迁移到postgresql 本教程使用的是https://neon.tech/home,与vercel(服务端)兼容很好
官方教程
https://waline.js.org/guide/get-started/
https://waline.js.org/guide/database.html#postgresql
在服务端导出数据waline.json,备份已存在数据:
管理->导入导出neno创建数据库,创建成功之后不要关闭,有数据库相关信息
在vercel中打开项目点击Storage,关联数据库到vercel项目
执行数据库脚本脚本下载地址https://github.com/walinejs/waline/blob/main/assets/waline.pgsql
删除环境变量
LEAN_ID,LEAN_KEY和LEAN_MASTER_KEY新增环境变量(
vercel+neon测试新版本好像不需要配置下边的环境变量了)变量名 变量值 备注 PG_DBneondb PostgreSQL 数据库库名,从POSTGRES_DATABASE复制 PG_USERneondb_owner PostgreSQL 数据库的用户名,从POSTGRES_USER复制 PG_PASSWORDnpg_FNpc123412J2WM PostgreSQL 数据库的密码,从POSTGRES_PASSWORD复制 PG_HOSTep-dark-frog-1234-pooler.c-3.us-east-1.aws.neon.tech PostgreSQL 服务的地址,从POSTGRES_HOST复制 PG_PORT5432 PostgreSQL 服务的端口,SSL开启给5432.这地方容易踩坑(不开启默认是3211) PG_SSLtrue 是否使用 SSL 连接 PostgreSQL 数据库 ,neon默认ssl开启给true 重启Vercel服务端
注册管理员用户
导入备份的数据waline.json(如新注册的管理员密码和旧的不同,导入之后会覆盖 变为旧的)
服务端webhook数据格式
教程https://waline.js.org/reference/server/env.html#%E9%AB%98%E7%BA%A7%E9%85%8D%E7%BD%AE
在服务端配置了环境变量WEBHOOK之后的数据格式记录
匿名用户是没user_id这个字段的 其他都一致
json格式 body记录
1 | { |