HunterXuan / Valine-Admin

一个 Valine 的拓展应用，用来增强 Valine 的邮件通知。

Valine Admin

简介

此项目是一个对 Valine 评论系统的拓展应用，可增强 Valine 的邮件通知功能。基于 Leancloud 的云引擎与云函数。可以提供邮件 通知站长 和 @ 通知 的功能，而且还支持自定义邮件通知模板。

点击查看演示

注：本项目修改于 panjunwen 的项目 : Valine-Admin，原作者博客: Valine Admin 配置手册, (部分逻辑于功能不同，还请读者不要搞混配置项.)

快速开始

首先需要确保 Valine 的基础功能是正常的，参考 Valine Docs。

然后进入 Leancloud 对应的 Valine 应用中。

点击 云引擎 -> 设置 填写代码库并保存：https://github.com/zhaojun1998/Valine-Admin

切换到部署标签页，分支使用 master，点击部署即可：

配置项

此外，你需要设置云引擎的环境变量以提供必要的信息，点击云引擎的设置页，设置如下信息：

必选参数

• SITE_NAME : 网站名称。
• SITE_URL : 网站地址, 最后不要加 / 。
• SMTP_USER : SMTP 服务用户名，一般为邮箱地址。
• SMTP_PASS : SMTP 密码，一般为授权码，而不是邮箱的登陆密码，请自行查询对应邮件服务商的获取方式
• SMTP_SERVICE : 邮件服务提供商，支持 QQ、163、126、Gmail、"Yahoo"、...... ，全部支持请参考 : Nodemailer Supported services。 --- 如这里没有你使用的邮件提供商，请查看自定义邮件服务器
• SENDER_NAME : 寄件人名称。

高级配置

自定义邮件模板

自定义收件邮箱

自定义邮件服务器

Web 评论管理

Leancloud 休眠策略(必看)

更新历史

• 7.30 修复 @ 邮件通知出错 bug (需 Valine 1.3.0 支持)，优化发件逻辑，站长发的评论不再收到邮件通知。
• 7.7 兼容 valine v1.2.0-beta 版本对 at 的更改 点击查看
• 7.1 修复 Web 后台登录安全 bug
• 6.14 添加自定义邮件服务器功能. 点击查看

---

常见问题

为什么我收不到邮件？

• 请确认评论时留下的邮箱不是环境变量里的 SMTP_USER 或 TO_EMAIL 里的邮箱，原因详见 7.30 更新日志。
• 请确认修改环境变量后已重启容器。
• 对于 QQ / 163 邮箱，请确认你输入的是 SMTP 的授权码，而不是登陆密码。

为什么我刚开始测试的时候是正常的，但后面的邮件没有通知？

请确认已针对 LeanCloud 的免费容器休眠策略配置了定时器，详见：LeanCloud 休眠策略。

请耐心看一下休眠策略，逻辑并不复杂，配置定时器也很简单，没有机器配置的话，就在 issue 中留言，我帮你配置。

我自己有服务器/vps，应该如何配置定时器？

请确保机器能 24 小时开机，且可访问外网，并且你会使用 ssh 登陆服务器，会使用 vim 做基本的编辑和保存操作。

1. 登陆服务器
2. 输入 crontab -e，回车。
3. 进入 vim 编辑模式。(按 i)
4. 在最后另起一行输入 */20 7-23 * * * curl https://你配置的域名前缀.leanapp.cn
5. 保存退出。(按 esc 后，输入 :wq，回车)

如何重启容器？

注: 更新新版本与更改环境变量均需要重启容器后生效。