DieselChen

个人博客,记录一下学习的点滴～

0%

hexo搭建评论系统Valine

发表于 更新于 分类于 ， Valine：
本文字数： 7.9k 阅读时长 ≈ 7 分钟

hexo 搭建评论系统 valine，记录一下相关配置

参考各位大佬的链接

LeanCloud注册

Valine 用 LeanCloud 作为数据库，所以我们需要注册一个 LeanCloud 账号。

  1. 注册完以后需要创建一个应用，然后 进入应用 -> 设置 -> 应用 key，得到 appid、appkey。
  2. 我们需要在 Leancloud -> 设置 -> 安全中心 -> Web 安全域名把你的域名加进去

注意点： 注册的时候一定要选择国际版，如果你选择的是华北或者华东的话，Valine 后台评论管理是需要备案才能绑定的

NexT 配置

由于 NexT 7.1.2 已经内置了 Valine，所以我们只需要进行简单的配置即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# Valine
# You can get your appid and appkey from https://leancloud.cn
# More info available at https://valine.js.org
valine:
  enable: true # When enable is set to be true, leancloud_visitors is recommended to be closed for the re-initialization problem within different leancloud adk version.
  appid:  # your leancloud application appid
  appkey:  # your leancloud application appkey
  notify: false # mail notifier, See: https://github.com/xCss/Valine/wiki
  verify: false # Verification code
  placeholder: 'ヾﾉ≧∀≦)o来啊，快活啊!' # comment box placeholder
  avatar: mm # gravatar style
  guest_info: nick,mail,link # custom comment header
  pageSize: 10 # pagination size
  language: zh-cn # language, available values: en, zh-cn
  visitor: true # leancloud-counter-security is not supported for now. When visitor is set to be true, appid and appkey are recommended to be the same as leancloud_visitors' for counter compatibility. Article reading statistic https://valine.js.org/visitor.html
  comment_count: true # if false, comment count will only be displayed in post page, not in home page

主要就是填入前一步得到的 appid、appkey。然后由于我后面要用更完善的第三方邮件提醒 Valine-Admin，所以这里我关闭了自带的邮件提醒 notify。

由于自带的 CDN 加载很慢，所以这里我们在 NexT 配置文件_config.yml 中改成第三方 CDN：

1
2
3
4
5
6
7
vendors:
  # valine
  # See: https://github.com/xCss/Valine
  # Example:
  # valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js
  # valine: //cdnjs.cloudflare.com/ajax/libs/valine/1.3.4/Valine.min.js
  valine: //cdn.jsdelivr.net/npm/valine@1/dist/Valine.min.js

到目前为止，我们就可以正常使用 Valine 了。

下面是一些可选的高级配置，比如我想要评论后得到邮件通知、垃圾邮件过滤，那就需要配置 Valine Admin。

Valine Admin相关配置

选择云引擎–>设置–>云引擎域名(强调这个就是LeancLoud的后台地址输入自己喜欢的一个的前缀)
后台地址后面加上/sign-up就可以注册
例如：https://letetest.avosapps.us/sign-up

07
当然如果你有自己的域名也可以选择绑定自己的域名，选择设置–>域名绑定–>云引擎域名
image-20210317111459392

注意 如果想要绑定自己网站的二级域名有两种方式：

  1. 注册国际版本，这样域名不备案就行
  2. 注册国内版本，域名需要备案。

环境变量：

变量 示例 说明
SITE_NAME DieselChen [必填] 博客名称
SITE_URL https://dieselchen.work/ [必填] 首页地址
SMTP_SERVICE QQ [新版支持] 邮件服务提供商，支持 QQ、163、126、Gmail 以及 更多
SMTP_USER xxxxxx@qq.com [必填]SMTP 登录用户
SMTP_PASS ccxxxxxxxxch [必填]SMTP 登录密码（QQ 邮箱需要获取独立密码）
SENDER_NAME DieselChen [必填] 发件人
SENDER_EMAIL xxxxxx@qq.com [必填] 发件邮箱
ADMIN_URL https://valine.dieselchen.work/ [建议]Web 主机二级域名，用于自动唤醒
BLOGGER_EMAIL xxxxx@gmail.com [可选] 博主通知收件地址，默认使用 SENDER_EMAIL
AKISMET_KEY xxxxxxxxxxxx [可选]Akismet Key 用于垃圾评论检测，设为 MANUAL_REVIEW 开启人工审核，留空不使用反垃圾

邮件通知模板

邮件通知模板在云引擎环境变量中设定，可自定义通知邮件标题及内容模板。

环境变量 示例 说明
MAIL_SUBJECT ${PARENT_NICK}，您在 ${SITE_NAME} 上的评论收到了回复 [可选]@通知邮件主题（标题）模板
MAIL_TEMPLATE 见下文 [可选]@通知邮件内容模板
MAIL_SUBJECT_ADMIN ${SITE_NAME} 上有新评论了 [可选] 博主邮件通知主题模板
MAIL_TEMPLATE_ADMIN 见下文 [可选] 博主邮件通知内容模板

邮件通知包含两种，分别是被@通知（上面的 MAIL_TEMPLATE）和博主通知（上面的 MAIL_TEMPLATE_ADMIN），这两种模板都可以完全自定义。默认使用经典的蓝色风格模板。

默认被@通知邮件内容模板如下：

1
<div style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"><h2 style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;">您在<a style="text-decoration:none;color: #12ADDB;" href="${SITE_URL}" target="_blank">            ${SITE_NAME}</a>上的评论有了新的回复</h2> ${PARENT_NICK} 同学，您曾发表评论：<div style="padding:0 12px 0 12px;margin-top:18px"><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;">            ${PARENT_COMMENT}</div><p><strong>${NICK}</strong>回复说：</p><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"> ${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb" href="${POST_URL}" target="_blank">查看回复的完整內容</a>，欢迎再次光临<a style="text-decoration:none; color:#12addb" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>。<br></p></div></div>

默认博主通知邮件内容模板如下：

1
<div style="border-top:2px solid #12ADDB;box-shadow:0 1px 3px #AAAAAA;line-height:180%;padding:0 15px 12px;margin:50px auto;font-size:12px;"><h2 style="border-bottom:1px solid #DDD;font-size:14px;font-weight:normal;padding:13px 0 10px 8px;">您在<a style="text-decoration:none;color: #12ADDB;" href="${SITE_URL}" target="_blank">${SITE_NAME}</a>上的文章有了新的评论</h2><p><strong>${NICK}</strong>回复说：</p><div style="background-color: #f5f5f5;padding: 10px 15px;margin:18px 0;word-wrap:break-word;"> ${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb" href="${POST_URL}" target="_blank">查看回复的完整內容</a><br></p></div></div>

这里还提供一个彩虹风格的 @通知邮件模板代码：

1
<div style="border-radius: 10px 10px 10px 10px;font-size:13px;    color: #555555;width: 666px;font-family:'Century Gothic','Trebuchet MS','Hiragino Sans GB',微软雅黑,'Microsoft Yahei',Tahoma,Helvetica,Arial,'SimSun',sans-serif;margin:50px auto;border:1px solid #eee;max-width:100%;background: #ffffff repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 1px 5px rgba(0, 0, 0, 0.15);"><div style="width:100%;background:#49BDAD;color:#ffffff;border-radius: 10px 10px 0 0;background-image: -moz-linear-gradient(0deg, rgb(67, 198, 184), rgb(255, 209, 244));background-image: -webkit-linear-gradient(0deg, rgb(67, 198, 184), rgb(255, 209, 244));height: 66px;"><p style="font-size:15px;word-break:break-all;padding: 23px 32px;margin:0;background-color: hsla(0,0%,100%,.4);border-radius: 10px 10px 0 0;">您在<a style="text-decoration:none;color: #ffffff;" href="${SITE_URL}"> ${SITE_NAME}</a>上的留言有新回复啦！</p></div><div style="margin:40px auto;width:90%"><p>${PARENT_NICK} 同学，您曾在文章上发表评论：</p><div style="background: #fafafa repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 2px 5px rgba(0, 0, 0, 0.15);margin:20px 0px;padding:15px;border-radius:5px;font-size:14px;color:#555555;">${PARENT_COMMENT}</div><p>${NICK} 给您的回复如下：</p><div style="background: #fafafa repeating-linear-gradient(-45deg,#fff,#fff 1.125rem,transparent 1.125rem,transparent 2.25rem);box-shadow: 0 2px 5px rgba(0, 0, 0, 0.15);margin:20px 0px;padding:15px;border-radius:5px;font-size:14px;color:#555555;">${COMMENT}</div><p>您可以点击<a style="text-decoration:none; color:#12addb" href="${POST_URL}#comments">查看回复的完整內容</a>，欢迎再次光临<a style="text-decoration:none; color:#12addb"                href="${SITE_URL}"> ${SITE_NAME}</a>。</p><style type="text/css">a:link{text-decoration:none}a:visited{text-decoration:none}a:hover{text-decoration:none}a:active{text-decoration:none}</style></div></div>

定时任务设置

目前实现了两种云函数定时任务：

  • (1) 自动唤醒，定时访问 Web APP 二级域名防止云引擎休眠；
  • (2) 每天定时检查 24 小时内漏发的邮件通知。

进入云引擎 - 定时任务中，创建定时器，创建两个定时任务。

  • 选择 self-wake 云函数，Cron 表达式为 0 0/30 7-23 * * ?，表示每天早 6 点到晚 23 点每隔 30 分钟访问云引擎，ADMIN_URL 环境变量务必设置正确
  • 选择 resend-mails 云函数，Cron 表达式为 0 0 8 * * ?，表示每天早 8 点检查过去 24 小时内漏发的通知邮件并补发

添加定时器后记得点击启动方可生效。

至此，Valine Admin 已经可以正常工作，更多以下是可选的进阶配置。

欢迎关注我的其它发布渠道

-----------本文结束感谢您的阅读-----------