5.1 KiB
后台设置
管理后台用于审核评论、删除评论和管理评论设置。
设置
头像服务前缀
常用的 Gravatar 镜像服务：
| 服务 | 前缀地址 |
|---|---|
| Gravatar 官方 | https://gravatar.com/avatar |
| Cravatar (国内) | https://cravatar.cn/avatar |
| 自定义镜像 | https://your-mirror.com/avatar |
显示博主标签
开启是否显示博主标签，配置博主邮箱和标签文字，即可在评论中显示博主标签；关闭为不显示。
管理员评论密钥
设置管理员评论密钥后，博主在前台发布评论时需要输入此密钥进行身份验证，评论将被直接通过，不受"先审核再显示"设置的影响。
注意：
- 同一 IP 连续验证失败 3 次后，该 IP 将被锁定 30 分钟
- 失败次数记录有效期为 1 小时
评论置顶
在评论管理页面，点击"编辑"按钮可修改评论的置顶权重：
1：不置顶（默认值）2或更高：数值越大，该评论在列表中排序越靠前
置顶后的评论会在前台评论列表中优先显示。
邮件通知配置
在设置页面可以配置邮件通知功能，包括：
全局开关
控制是否启用邮件通知功能。
SMTP 配置
| 字段 | 说明 | 示例 |
|---|---|---|
| 主机 | SMTP 服务器地址 | smtp.qq.com |
| 端口 | SMTP 服务器端口 | 465 |
| 用户名 | 发件邮箱 | noreply@qq.com |
| 密码 | 邮箱密码或授权码 | your_password |
| 安全连接 | 是否使用 SSL/TLS | true |
邮件模板
支持自定义 HTML 邮件模板，包含以下变量：
回复评论模板变量：
| 变量名 | 说明 |
|---|---|
${toEmail} |
收件人邮箱 |
${toName} |
收件人昵称 |
${postTitle} |
文章标题 |
${parentComment} |
被回复的评论内容 |
${replyAuthor} |
回复者昵称 |
${replyContent} |
回复内容 |
${postUrl} |
文章链接 |
新评论通知模板变量：
| 变量名 | 说明 |
|---|---|
${postTitle} |
文章标题 |
${postUrl} |
文章链接 |
${commentAuthor} |
评论者昵称 |
${commentContent} |
评论内容 |
测试邮件
配置完成后，可以使用"测试邮件"功能发送一封测试邮件到指定邮箱，验证配置是否正确。
使用官方管理后台
使用官方提供的管理后台（最新版本）https://cwd.zishu.me
登陆时填入你的 api 地址、账号和密码。
评论数据修改
支持单条评论的修改，包括状态、内容等。
Warning
如若批量修改评论信息，请前往 Cloudflare D1 SQL 控制台执行 SQL 语句。
高危操作，请保证你熟悉 SQL 语句，避免对评论数据造成不可逆的损失。建议使用前先导出评论数据备份。
自部署
cd cwd-admin
# 安装依赖
npm install
# 开发环境启动（默认端口见 vite.config.ts，一般为 1226）
npm run dev
# 生产环境构建
npm run build
# 本地预览生产构建结果
npm run preview
将 /cwd-admin/dist 目录部署到任意静态站点托管服务（如 Cloudflare Pages、Vercel、Netlify 等），并确保浏览器可以访问到后端 API 地址。
-
管理后台（admin）：基于 Vite + Vue 3 的单页应用，用于管理评论和系统配置。
-
/cwd-admin：管理后台源码- 运行环境：浏览器
- 构建工具：Vite + Vue 3
环境变量与多环境配置
评论组件本身不依赖打包时的环境变量，只需要在运行时传入 apiBaseUrl 即可。
管理后台使用 Vite 环境变量进行多环境配置，推荐按以下方式区分开发 / 测试 / 生产环境：
在 /cwd-admin 目录下创建对应的环境文件：
# 开发环境
cp .env.example .env
每个环境文件中可配置以下变量：
| 变量名 | 说明 | 示例 |
|---|---|---|
VITE_API_BASE_URL |
后端 API 地址（Cloudflare Worker 域名或自定义） | https://cwd-api.test.com |
VITE_ADMIN_NAME |
登录页默认管理员账号占位值 | admin@example.com |
VITE_ADMIN_PASSWORD |
登录页默认密码占位值 | 123456 |
说明：
VITE_API_BASE_URL会作为管理后台的默认 API 地址，实际请求地址可以在登录页修改，并持久化到localStorage。VITE_ADMIN_NAME和VITE_ADMIN_PASSWORD仅用于自动填充登录表单，真正的认证信息以后端环境变量ADMIN_NAME、ADMIN_PASSWORD为准。