Files
cwd/docs/function/admin-panel.md
2026-01-21 10:53:11 +08:00

2.7 KiB
Raw Blame History

后台设置

管理后台用于审核评论、删除评论和管理评论设置。

设置

头像服务前缀

常用的 Gravatar 镜像服务:

服务 前缀地址
Gravatar 官方 https://gravatar.com/avatar
Cravatar (国内) https://cravatar.cn/avatar
自定义镜像 https://your-mirror.com/avatar

显示博主标签

开启是否显示博主标签,配置博主邮箱和标签文字,即可在评论中显示博主标签;关闭为不显示。

使用官方管理后台

使用官方提供的管理后台(最新版本)https://cwd.zishu.me

登陆时填入你的 api 地址、账号和密码。

自部署

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_NAMEVITE_ADMIN_PASSWORD 仅用于自动填充登录表单,真正的认证信息以后端环境变量 ADMIN_NAMEADMIN_PASSWORD 为准。