在Icarus主题下开启评论模块

Valine

Valine评论插件的漏洞会导致此评论服务暴露所有评论者的IP地址 ([xCss/Valine#336](https://github.com/xCss/Valine/issues/336)) 请更换其他评论服务

何为 valine 评论?

Valine 诞生于 2017 年 8 月 7 日,是一款基于 LeanCloud 的快速、简洁且高效的无后端评论系统。 理论上支持但不限于静态博客,目前已有 Hexo、Jekyll、Typecho、Hugo、Ghost 等博客程序在使用 Valine。

和其他评论模块的优势

  • 属于国内的评论模块,在网站加载速度和人性化方面略优
  • LeanCloud 背书,有一定保障性
  • 无意义上后端,接入便捷
  • MarkDown 全语法支持,并支持 Emoji

注册 LeanCloud 并创建应用

注册 LeanCloud 成功后创建应用

点击设置-应用 Key 获得 App key 即创建成功,由于 LeanCloud 对免费用户开发版进行一系列限制,接下来开始对该应用进行设置。

设置 - API 访问域名

绑定自己已有在国内备案过的域名,在设置-域名绑定-API 访问域名设置。

  • 注意不可以填入自己的 GitHub page 的 URL,github.io 也不行会引起 403 ERROR
  • 国际版可以使用免费的二级域名,这里不推荐使用,因为体验过后不太佳,尽量还是使用自有域名

设置 - 云引擎、ClientEngine 域名

同上,绑定域名,显示已绑定即成功绑定。

配置 Icarus 的 config

打开部署的 Hexo 根目录,在 theme 下的 Icarus 文件夹里vi _config.yml开始配置配置项,示例如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# Comment plugin configurations
# https://ppoffice.github.io/hexo-theme-icarus/categories/Plugins/Comment/
comment:
type: valine
app_id: W3zVbpO*****gzGzoHsz
app_key: DUKL************Lb1hNyD5q3
placeholder: "欢迎留言…"
notify: false
verify: false
avatar: 'retro'
meta: ["nick", "mail"]
page_size: 10
highlight: true
record_ip: false

附带 - 参数解释

参数 配置 说明
type changyan,disqus,disqusjs,facebook,gitalk,gitment,isso,livere,utterances,valine [必填] 这里默认 valine
app_id W3zVbpO*****gzGzoHsz [必填] 为 LeanCloud 应用的 AppID
app_key DUKL************Lb1hNyD5q3 [必填] 为 LeanCloud 应用的 AppKey
placeholder 欢迎留言… [可选] 评论前提示语
notify false [可选]notify 邮件提醒无论 true 和 false 都是不生效的,因为 valine 评论自带的邮件提醒功能将在 v1.4.0 发布时下线
verify false [可选]评论时是否有验证码,如为 true 需要在 Leancloud 设置->安全中心 中打开图形验证码服务
avatar mp,identicon,monsterid,wavatar,retro,robohash,hide [可选]评论发表时,不填入邮箱 email 或无Gravatar 头像显示的头像类型,详细见Valine 针对 avatar 头像的说明
meta [“nick”, “mail”, “link”] [可选]分别对应评论栏所供填入的昵称、邮箱地址和个人网站
page_size 10 [可选]分页配置
highlight true [可选]是否开启高亮代码
record_ip false [可选]是否评论后显示 IP

至此,键入hexo clen & g重启服务即可看到评论模块生效成功。

申请推送流服务

QMsg

因某些原因,Qmsg 酱将要停业,并关闭新用户登录通道,原有用户可以继续使用到完全停业。感谢您一直以来对 Qmsg 酱的支持!

由于 QMsg 已经关闭注册入口,现在新增国内另外一家提供推送消息服务 ServerChan

ServerChan

「Server 酱」,英文名「ServerChan」,是一款「程序员」和「服务器」之间的通信软件。
说人话?就是从服务器推报警和日志到手机的工具。

进入ServerChan官网,按流程注册获取到SCKEY,在下方测试正常推送到关注好到微信公众号收到测试消息,即可成功。

安装 Valine-admin

首先确保上面流程走完且评论正常,方可展开 valine 后台部署,然后进入 LeanCloud 对应的应用,点击 云引擎 -> 部署 -> 部署项目 -> Git 部署 -> Git 配置 填写 GIt 代码库并保存:[https://github.com/sviptzk/Valine-Admin-Server](https://github.com/sviptzk/Valine-Admin-Server) 然后再次点击 Git 部署 第一次部署请勾选不使用缓存,最后点击部署,查看日志无报错且部署完成就此部署第一阶段完成。

配置部署后台的环境变量

点击 云引擎 -> 设置 -> 添加新变量:

变量名 示例 说明
SITE_NAME My_blog [必填] 网站名称
SITE_URL https:/bk.catooilg.com [必填] 网站地址,最后不要加 /
SMTP_USER postmaster@catooilg.com [必填] SMTP 服务用户名,一般为邮箱地址。
SMTP_PASS password [必填] SMTP 密码,一般为授权码或者是邮箱的登陆密码,请自行查询对应邮件服务商的获取方式
SMTP_SERVICE qiye.aliyun 邮件服务提供商,请查询对应到邮件服务商参数
填入
SENDER_NAME Yuki [必填] 寄件人名称。
TEMPLATE_NAME default [必填] 设置提醒邮件的主题,默认为
default,可以选择填入 default,rainbow,custom1,custom2
DISABLE_EMAIL true [可选],填写则代表停止发送邮件
SCKEY xxx [可选] 填入 ServerChan 的 SCKEY
FAVICON https://img.catooilg.com/catooilg/2016/07/valine_favicon.ico [可选] 网页 favicon 图标

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

初始化后台管理

第一次打开绑定的域名会提示需要登录,在域名后补上 /sign-up,先注册你的登录信息,即可进入后台进行管理操作。

设置防休眠

点击 云引擎 -> 定时任务,新增定时器,配置如图所示:

保存后运行即可。

常见问题

Q:提示 undefined is not a valid value
自定义环境变量没有配置好,请再次检查

Q:提示 Invalid status code: { favicon: ‘https://cdn.jsdelivr.net/gh/sviptzk/StaticFile_HEXO@v3.2.3/butterfly/img/favicon.ico‘ }
自定义环境变量网页 favicon 图标没有配置好,注意是否 ico 图标(尺寸为 48 × 48)

Waline

✖ Project framework failed to execute:
ERROR:
Please provide existed ossBucket under your account when code size is greater than 50M.

致谢与引用声明

Hexo 优化 — Valine 扩展之邮件通知
Valine 评论之 Valine-admin 配置攻略
Valine 官方文档
Qmsg 酱-您的专属 QQ 消息推送服务小姐姐
Server 酱 | 网站小帮手

作者

Catooilg

发布于

2020-08-06

更新于

2023-02-05

许可协议

评论