Valine评论之Valine-admin配置攻略

前言

这篇文章所用的Valine-admin是小康根据懒人大佬及其他两位valine-admin的作者进行二次开发版本。可能会与大佬保持更新(~~其实就是抄代码~~)，也可能不会。但需要注意的是：此版本中的设定可能与你之前用的有些出入，如果无法接受，那么可以关掉这个页面。没人强迫你用。

项目重大历史：

2020-02-16

第一次版本发布，这是仅有微信提醒功能
2020-04-19

基于懒人大佬，弃用request
2020-04-20

添加qq提醒
2020-05-15

适配国际版时区问题（beta）

最初修改这个项目的原因是因为不在电脑旁的时候，如果有人评论会发送邮件，但手机有时候不会提醒（~~可能手机垃圾吧~~）。 -小康博客

于是我便想到了曾经好友向我展示的server酱，只不过当时是以聊天室的形式展示的（其实也有人向我展示过评论通知的）。于是我便突发奇想，决定试试这个微信server酱。

这样就可以给我发微信通知了，从此再也不会看不到评论了！

部署前需要获取的密钥

这部分主要介绍QQ提醒，微信提醒及垃圾评论检测的密钥获取途径。如果不需要可以直接跳过，看后边的部署Valine-admin部分。

Service酱SCKEY获取

首先需要到server的官网，开启微信提醒并获取SCKEY。官网写的很详细，这里不在过多赘述。相信能动手搭Hexo博客的小伙伴都能看懂server酱官方的教程。小伙伴开启微信通知后顺便在官方那里测试下能否接到通知哦。

Qmsg密钥获取

Qmsg的官网为：https://qmsg.zendee.cn/,进入官网，登录账号（qq或者神邸用户都可以）。

选择并添加一个消息发送者，并填写你接受消息的qq号。（可以使用小号登录，大号接收）

不要问为什么收不到消息，你不加他当然收不到了。选择哪个添加哪个即可。
获取密钥

点击右上角的文档，然后你会看到一个网址。这个网址里边会有一串奇怪的字母数字组合，我们复制他（也就是图中被我马赛克的地方）

AKISMET_KEY获取

Akismet (Automattic Kismet)是应用广泛的一个垃圾留言过滤系统，其作者是大名鼎鼎的WordPress 创始人 Matt Mullenweg，Akismet也是WordPress默认安装的插件，其使用非常广泛，设计目标便是帮助博客网站来过滤留言Spam。有了Akismet之后，基本上不用担心垃圾留言的烦恼了。
启用Akismet后，当博客再收到留言会自动将其提交到Akismet并与Akismet上的黑名单进行比对，如果名列该黑名单中，则该条留言会被标记为垃圾评论且不会发布。

如果你用过 WordPress 你应该有 Akismet Key；如果还没有，你可以去 AKISMET FOR DEVELOPERS 免费申请一个；如果你不需要反垃圾评论，Akismet Key 环境变量可以忽略。

为了实现较为精准的垃圾评论识别，采集的判据除了评论内容、邮件地址和网站地址外，还包括评论者的IP地址、浏览器信息等，但仅在云引擎后台使用这些数据，确保隐私和安全。

如果使用了本站最新的Valine和Valine Admin，并设置了Akismet Key，可以有效地拦截垃圾评论。被标为垃圾的评论可以在管理页面取消标注。

部署valine-admin

这一步主要是告诉你如何快速部署这个项目。

登录LeanCloud的官网。（如何注册就不介绍了。）

登录无论是国际版还是国内版都是可以的。

成功登录后，会看到如下界面。右上角可以看到你当前是你的登录节点是国内还是国外，比如我的是国内华北节点。
创建应用并进入应用
开始部署项目

依次点击左侧的云引擎->部署->项目部署->Git部署->配置Git。然后Git的地址填写：https://github.com/sviptzk/Valine-Admin-Server。然后再次点击Git部署->部署即可
绑定评论管理的域名
- 国区版
  
  LeanCloud不给予免费的二级域名了，因此必须绑定备案域名。
- 国际版
  
  LeanCloud给予一个免费的二级域名。当然也可以绑定自己的（方式与国区版相同）。
设置域名白名单

域名可设置多个，一行一个。需要写协议头。如果使用的是默认端口号可以省略，但协议头一定要写。例如我的设置如图：

设置环境变量

此变量表只针对此项目，如果使用原项目可能不生效

变量名	说明	示例
SITE_NAME	[必填]网站名称	小康博客
SITE_URL	[必填]网站地址，最后不要加`/`	https://www.antmoe.com
SMTP_USER	[必填]SMTP 服务用户名，一般为邮箱地址。	admin@antmoe.com
SMTP_PASS	[必填]SMTP 密码，一般为授权码，而不是邮箱的登陆密码，请自行查询对应邮件服务商的获取方式	123
SMTP_SERVICE	[新版支持]邮件服务提供商,内置支持	163
SENDER_NAME	[必填]寄件人名称。	小康博客
TO_EMAIL	[可选]博主通知收件地址，默认使用SMTP_USER	admin@antmoe.com
BLOGGER_EMAIL	[可选]如果设置则作为后台管理员邮箱（`/sign-up`页面设置），不设置则默认以`SMTP_USER`	admin@antmoe.com
TEMPLATE_NAME	[必填]设置提醒邮件的主题	custom2
AKISMET_KEY	[可选]Akismet Key 用于垃圾评论检测，设为MANUAL_REVIEW开启人工审核，留空不使用反垃圾	xxxx
ADMIN_URL	[可选]后台管理地址	https://xxxx.leanapp.cn/
COMMENT	[可选]评论div的ID名	#post-comment
SCKEY	[可选]server酱的SCKEY	xxx
AKISMET_KEY	[可选]Akismet Key 用于垃圾评论检测	xxxxxxxxxxxx
QMSG_KEY	[可选]Qmsg酱的密钥	xxxxx
QQ	[可选]Qmsg酱发送的qq，不填为全部。支持多个，用英文逗号分隔即可	535668586
DISABLE_EMAIL	[可选]，填写则代表停止发送邮件	true
QQ_SHAKE	[可选]，填写代表发送QQ戳一戳	true

当使用自定义邮件服务器时（需将SMTP_SERVICE变量删掉哦！）

变量名	说明	示例
SMTP_HOST	邮件服务提供商 SMTP 地址，此项需要自行查询或询问其服务商。	`smtp.ym.163.com`
SMTP_PORT	邮件服务提供商 SMTP 端口, 此项需要自行查询或询问其服务商。	994
SMTP_SECURE	是否启用加密, 默认为 `true`，一般不需要设置，如有特殊请自行配置。此项需要自行查询或询问其服务商。	true

此项目的主题字段

主题	说明
default	默认主题
rainbow	原版的rainbow
custom1	基于🎉梨花町の肾兄さん🎉的模板
custom2	对custom1的改进版

添加完成后，点击保存。并且重新部署实例。

我这里以最简设置为例，请各位博主认真看每个变量的含义最后决定要不要设置。
初始化后台管理

如果你没有设置后台域名，即没有做第四步。那么也可以跳过这一步。

打开绑定的域名+/sign-up，例如我的域名为https://xiaokang.avosapps.us/，那么我访问的地址就是https://xiaokang.avosapps.us/sign-up。接下来设置你的登录信息。
登录后台

接下来就可以用刚才的邮箱或者登录名登录了。
基本完成了设置

到这里基本上完成了valine-admin的基本设置。如果你觉得我的项目还不错，可以为我点个star哦！