本文最后更新于:2024年5月7日 下午
距离刚刚使用 Waline 已经将近一年过去了,近期发现 Waline 升级到了 2.6+ 版本,修复了一些 bug,增加了一些功能,本文记录升级过程。
背景
- 我的 Waline 用在 Hexo Fluid 中,当前版本为 1.5,想要升级到 2.6.1
- 支持点赞,支持删除评论,修复了博主头像不显示的 bug 还是很值得更新的
- 由于大版本升级,改动较大,决定放弃之前的 Vercel 部署重新来过
- 官方教程 事实上已经很完备了,此处记录我遵循官方文档使用 Vercel 重新部署 Waline 的过程。
Vercel 部署 Waline 2
部署 waline 到自己的仓库
- 申请 vercel 账号后进入链接:https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwalinejs%2Fwaline%2Ftree%2Fmain%2Fexample
- 在自己的 github 创建仓库,我起名为
waline2
- 此时 Vercel 会基于 Waline 模板帮助你新建并初始化仓库,仓库名为你之前输入的项目名。
部署成功
控制台基础配置
- 此时点击
Go to Dashboard
可以跳转到应用的控制台。 - 点击顶部的
Settings
-Environment Variables
进入环境变量配置页
- 配置三个环境变量
LEAN_ID
,LEAN_KEY
和LEAN_MASTER_KEY
,它们的值分别对应 LeanCloud 中的APP ID
,APP KEY
,Master Key
。
如果你使用 LeanCloud 国内版,请额外配置
LEAN_SERVER
环境变量,值为你绑定好的域名。
- 环境变量配置完成之后点击顶部的
Deployments
点击顶部最新的一次部署右侧的Redeploy
按钮进行重新部署。
该步骤是为了让刚才设置的环境变量生效。
- 部署完成后点击 visit 可以进入测试页面,正常评论后,Waline2 基础部署完成
评论通知
- 如 Waline 1+ 版本一样,升级后仍需要保留评论通知功能
邮件通知
- 邮件通知需要配置以下环境变量:
变量 | 描述 |
---|---|
SMTP_SERVICE |
SMTP 邮件发送服务提供商。 |
SMTP_USER |
SMTP 邮件发送服务的用户名,一般为登录邮箱。 |
SMTP_PASS |
SMTP 邮件发送服务的密码,一般为邮箱登录密码,部分邮箱(例如 163)是单独的 SMTP 密码。 |
SITE_NAME |
网站名称,用于在消息中显示。 |
SITE_URL |
网站地址,用于在消息中显示。 |
AUTHOR_EMAIL |
博主邮箱,用来接收新评论通知。如果是博主发布的评论则不进行提醒通知。 |
- 选填的环境变量:
变量 | 描述 |
---|---|
SENDER_NAME |
自定义发送邮件的发件人 |
SENDER_EMAIL |
自定义发送邮件的发件地址 |
MAIL_SUBJECT |
自定义评论回复邮件标题 |
MAIL_TEMPLATE |
自定义评论回复邮件内容 |
MAIL_SUBJECT_ADMIN |
自定义新评论通知邮件标题 |
MAIL_TEMPLATE_ADMIN |
自定义新评论通知邮件内容 |
微信通知
微信通知使用了 Server 酱open in new window 提供的服务,需要在环境变量中配置在 Server 酱中申请的 SC_KEY
。
变量 | 描述 |
---|---|
SC_KEY |
Server 酱提供的 Token,必填。 |
AUTHOR_EMAIL |
博主邮箱,用来区分发布的评论是否是博主本身发布的。如果是博主发布的则不进行提醒通知。 |
SITE_NAME |
网站名称,用于在消息中显示。 |
SITE_URL |
网站地址,用于在消息中显示。 |
企业微信通知
由于
Server 酱
提供的推送服务对发送消息数量有限制,如果消息数量较多时,建议使用企业微信应用通知。
-
要使用企业微信应用通知,需要配置环境变量
QYWX_AM
。 -
需要 5 个值:第一个值是
企业id
,第二个值是secret
,第三个值@all
(或者成员id
),第四个值是AgentID
,第五个值是图片id
中间以逗号隔开 -
创建自己的企业,输入名称等信息
如果是企业老板可以直接跳过
-
扫码登录企业微信后台,找到五个值组成字符串填入
固定域名
- 部署的应用会有随机生成的 DEPLOYMENT 域名
- 可以通过该域名部署应用,但每次都要修改很麻烦
- 而 vercel 为每个服务提供了专用域名,可以部分自定义
- 进入
View Domains
可以看到当前域名
- 也可以编辑、添加域名
参考资料
- https://waline.js.org/guide/get-started.html#vercel-部署-服务端
- https://www.zywvvd.com/notes/hexo/theme/fluid/fluid-waline-mail-notify/waline-mail-notify/
- https://waline.js.org/guide/server/notification.html#邮件通知
- https://www.zywvvd.com/notes/hexo/theme/fluid/fluid-wechat-notify/fluid-wechat-notify/
文章链接:
https://www.zywvvd.com/notes/hexo/theme/fluid/fluid-waline2/waline2/
“觉得不错的话,给点打赏吧 ୧(๑•̀⌄•́๑)૭”
微信支付
支付宝支付
Fluid -18- 升级 Waline2 重新部署
https://www.zywvvd.com/notes/hexo/theme/fluid/fluid-waline2/waline2/