Valine-Admin 使用教程

Valine-Admin 使用教程

Valine-Admin🔥A simple comment system based on LeanCloud and Valine. 项目地址:https://gitcode.com/gh_mirrors/val/Valine-Admin

项目介绍

Valine-Admin 是 Valine 评论系统的扩展和增强，主要实现评论邮件通知、评论管理、垃圾评论过滤等功能。支持完全自定义的邮件通知模板，基于 Akismet API 实现准确的垃圾评论过滤。此外，使用云函数等技术解决了免费版云引擎休眠问题，支持云引擎自动唤醒、漏发邮件自动补发。

项目快速启动

1. 克隆项目

git clone https://github.com/panjunwen/Valine-Admin.git
cd Valine-Admin

2. 安装依赖

npm install

3. 配置环境变量

在项目根目录下创建 .env 文件，并添加以下内容：

SITE_NAME=你的博客名称
SITE_URL=你的博客地址
SMTP_SERVICE=邮件服务提供商
SMTP_USER=SMTP用户名
SMTP_PASS=SMTP授权码
SENDER_NAME=发件人名称
SENDER_EMAIL=发件邮箱

4. 部署到 LeanCloud

1. 登录 LeanCloud 并创建一个新应用。
2. 进入应用的设置页面，找到 云引擎 -> 部署，选择 Git 部署。
3. 输入你的 Git 仓库地址并保存。
4. 手动部署：

git push lean master

5. 设置定时任务

进入 云引擎 -> 定时任务，创建两个定时任务：

• self-wake 云函数，Cron 表达式为 0 */30 0-16 * * *，表示每天早 0 点到晚 16 点每隔 30 分钟访问云引擎。
• resend-mails 云函数，Cron 表达式为 0 0 0 * * *，表示每天 0 点检查过去 24 小时内漏发的通知邮件并补发。

应用案例和最佳实践

应用案例

Valine-Admin 已被广泛应用于个人博客、技术社区等场景，提供了强大的评论管理和邮件通知功能，极大地提升了用户体验。

最佳实践

1. 自定义邮件模板：根据需求自定义邮件通知模板，使邮件内容更加个性化。
2. 垃圾评论过滤：利用 Akismet API 进行垃圾评论过滤，减少手动管理的工作量。
3. 定时任务优化：合理设置定时任务，确保云引擎稳定运行，避免因休眠导致的邮件漏发问题。

典型生态项目

Valine

Valine 是一个快速、简洁且高效的无后端评论系统，适用于静态博客。Valine-Admin 作为其扩展，提供了更多的管理功能。

LeanCloud

LeanCloud 是一个强大的后端云服务，提供了数据存储、云引擎等功能，是 Valine-Admin 运行的基础平台。

Akismet

Akismet 是一个知名的垃圾评论过滤服务，Valine-Admin 集成了 Akismet API，提供了准确的垃圾评论过滤功能。

通过以上步骤，你可以快速启动并使用 Valine-Admin，享受其强大的评论管理和邮件通知功能。

Valine-Admin🔥A simple comment system based on LeanCloud and Valine. 项目地址:https://gitcode.com/gh_mirrors/val/Valine-Admin