Hexo+Next主题安装Waline评论插件

部署服务端

参考https://waline.js.org/guide/get-started/

因为官方文档写的比较详细 简单写写

2026.1.15更新:leancloud已停止服务 ,新版本官方文档是vercel+neon部署

部署数据库https://leancloud.app/(已停止服务参考官方文档)

在Vercel 部署 (服务端)

  1. clone仓库https://github.com/walinejs/waline
  2. 在vercel上链接git仓库部署
  3. Root Directory填写example
  4. 后续同步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_URLhttps://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_EMAILadmin@zlay.fun邮件通知相关; 发信的时候显示的地址,如果使用resend,@前面的内容随便填
SMTP_HOSTsmtp.resend.com邮件通知相关; 我使用的resend的免费发信服务也可以用自己的163邮箱等
SMTP_PORT465邮件通知相关; SSL开启默认为465
SMTP_USERresend邮件通知相关; resend的默认用户名
SMTP_PASS邮件通知相关; 邮件发信密码
SMTP_SECUREtrue邮件通知相关; 是否开启SSL
AUTHOR_EMAILzlay0701@gmail.com博主邮箱,用来接收新评论通知。如果是博主发布的评论则不进行提醒通知。
WEBHOOK选填; 评论成功后会向 WEBHOOK 配置的地址发送一条 POST 请求,数据格式在文章末尾,可以配合moepush实现企业微信钉钉飞书等的推送

客户端

1
2
在hexo安装插件
npm install @waline/hexo-next --save

客户端配置

在根目录下的_config.yml中增加如下代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# Waline 评论系统start https://www.npmjs.com/package/@waline/hexo-next
waline:
enable: true
serverURL: https://waline.zlay.fun

# Waline library CDN url, you can set this to your preferred CDN
# libUrl: https://unpkg.com/@waline/client@v3/dist/waline.umd.js

# Waline CSS styles CDN url, you can set this to your preferred CDN
cssUrl: https://unpkg.com/@waline/client@v3/dist/waline.css

# Custom locales 自定义区域设置
locale:
placeholder: 请文明评论呀 #评论框的默认文字

# 如果为false,评论数将只显示在文章页面,而不是在主页
commentCount: false

# 浏览量统计,注意:您不应该同时启用`waline.pageview`和`leancloud_visitors`。 leancloud_visitors在主题文件夹中
pageview: false

lang: zh-CN
search: false #禁用表情包搜索
reaction: false #文章反应
imageUploader: false #图片上传
# Custom emoji
# emoji:
# - https://unpkg.com/@waline/emojis@1.1.0/weibo
# - https://unpkg.com/@waline/emojis@1.1.0/alus
# - https://unpkg.com/@waline/emojis@1.1.0/bilibili
# - https://unpkg.com/@waline/emojis@1.1.0/qq
# - https://unpkg.com/@waline/emojis@1.1.0/tieba
# - https://unpkg.com/@waline/emojis@1.1.0/tw-emoji

# Comment information, valid meta are nick, mail and link
# meta:
# - nick
# - mail
# - link

# Set required meta field, e.g.: [nick] | [nick, mail] 未登录必填字段
requiredMeta:
- nick

# Word limit, no limit when setting to 0
# wordLimit: 0

# Whether enable login, can choose from 'enable', 'disable' and 'force'
# login: enable

# comment per page
# pageSize: 10
# Waline 评论系统 end

管理

注册

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

  1. 在服务端导出数据waline.json,备份已存在数据: 管理->导入导出

  2. neno创建数据库,创建成功之后不要关闭,有数据库相关信息

  3. 在vercel中打开项目点击Storage,关联数据库到vercel项目

  4. 打开https://console.neon.tech/数据库控制台,选中新建的数据库

  5. 执行数据库脚本脚本下载地址https://github.com/walinejs/waline/blob/main/assets/waline.pgsql

  6. 删除环境变量LEAN_ID, LEAN_KEY 和 LEAN_MASTER_KEY

  7. 新增环境变量(vercel+neon测试新版本好像不需要配置下边的环境变量了)

    变量名变量值备注
    PG_DBneondbPostgreSQL 数据库库名,从POSTGRES_DATABASE复制
    PG_USERneondb_ownerPostgreSQL 数据库的用户名,从POSTGRES_USER复制
    PG_PASSWORDnpg_FNpc123412J2WMPostgreSQL 数据库的密码,从POSTGRES_PASSWORD复制
    PG_HOSTep-dark-frog-1234-pooler.c-3.us-east-1.aws.neon.techPostgreSQL 服务的地址,从POSTGRES_HOST复制
    PG_PORT5432PostgreSQL 服务的端口,SSL开启给5432.这地方容易踩坑(不开启默认是3211)
    PG_SSLtrue是否使用 SSL 连接 PostgreSQL 数据库 ,neon默认ssl开启给true
  8. 重启Vercel服务端

  9. 注册管理员用户

  10. 导入备份的数据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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
type: 'new_comment',
data: {
comment: {
link: '个人主页地址',
mail: '123@gmail.com',
nick: '素喂',
ua: 'Mozilla/5.0 (Windows NT 11.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 QuarkPC/6.1.5.666',
url: '/post/2025-06-04-hexo-waline/',
comment: '测试啊123评论2',
ip: '172.70.123.11',
user_id: 1,
status: 'approved',
createdAt: '2026-01-16T10:11:07.475Z',
updatedAt: '2026-01-16T10:11:07.475Z',
objectId: 7,
insertedAt: '2026-01-16 10:11:07',
rawComment: '测试啊123评论2'
}
}
}