部署安装
PrimeEdge Admin 后台管理系统的部署教程
部署安装
本章介绍如何将 PrimeEdge Admin 部署到腾讯云 EdgeOne Pages。
前置要求
- 腾讯云 EdgeOne Pages 账号
- Gitee 或 GitHub 账号 + 私人访问令牌
- 一个 Hugo 博客仓库（托管在 Gitee 或 GitHub）
部署步骤
1. 获取后台源码
git clone https://gitee.com/k_ok/primeedge-admin.git
cd primeedge-admin
2. 部署到 EdgeOne Pages
- 登录 EdgeOne Pages 控制台
- 新建项目 → 导入 Git 仓库（关联你 fork 的 primeedge-admin 仓库）
- 部署配置：
- 构建命令: 留空（无需构建）
- 输出目录:
public - Functions 目录:
functions
- 绑定 KV 命名空间：在项目设置中创建 KV 命名空间，绑定名称为
ADMIN_KV
3. 配置环境变量
在 EdgeOne Pages 控制台 → 项目设置 → 环境变量中添加：
| 变量名 | 必填 | 说明 |
|---|---|---|
ADMIN_PASSWORD | 是 | 后台登录密码 |
JWT_SECRET | 是 | JWT 签名密钥（建议 32 位随机字符串） |
UPYUN_BUCKET | 否 | 又拍云服务名（图片上传需要） |
UPYUN_OPERATOR | 否 | 又拍云操作员 |
UPYUN_PASSWORD | 否 | 又拍云操作员密码 |
生成 JWT_SECRET 的方法：
openssl rand -base64 32
4. 首次登录
- 访问部署完成后的域名（如
https://your-project.edgeone.cool/） - 输入你设置的
ADMIN_PASSWORD登录 - 登录后系统会自动跳转到仪表盘
5. 配置仓库信息
登录后进入 系统设置 页面，填写以下信息：
选择 Gitee 平台
| 配置项 | 说明 |
|---|---|
| 托管平台 | 选择 Gitee |
| Access Token | 在 Gitee → 设置 → 私人令牌 中生成，需勾选 projects 权限 |
| 仓库所有者 | 你的 Gitee 用户名（如 k_ok） |
| 仓库名称 | Hugo 博客仓库名（如 kokblog） |
| 分支名称 | 默认 master，按实际情况填写 |
选择 GitHub 平台
| 配置项 | 说明 |
|---|---|
| 托管平台 | 选择 GitHub |
| Access Token | 在 GitHub → Settings → Developer settings → Personal access tokens 中生成，需勾选 repo 权限 |
| 仓库所有者 | 你的 GitHub 用户名或组织名 |
| 仓库名称 | Hugo 博客仓库名 |
| 分支名称 | 默认 main，按实际情况填写 |
填写完毕后点击 测试连接，显示"连接成功"即表示配置正确。点击 保存设置。
6. 版本检测配置（可选）
在你的 Hugo 博客仓库的 static/ 目录下创建 version.json 文件：
{
"theme": "1.0.0",
"admin": "1.0.0"
}
博客部署后，后台仪表盘会自动读取该文件并与内置版本号对比，有新版本时会提示更新。
安全说明
- 登录采用 JWT Token 认证，有效期由系统控制
- 连续登录失败 5 次后会锁定 15 分钟
- 密码使用哈希加密存储
- Git Token 存储在 EdgeOne KV 中，不会暴露给前端
- 所有 API 请求需携带有效的 JWT Token
数据存储
本系统不使用传统数据库：
| 数据类型 | 存储位置 |
|---|---|
| 文章/笔记/好物等内容 | Gitee 仓库（Markdown 文件） |
| 系统设置 | EdgeOne KV |
| 列表缓存 | EdgeOne KV |
| 登录状态 | 浏览器 localStorage (JWT) |
| 主题偏好 | 浏览器 localStorage |
常见问题
Q: 部署后访问白屏
A: 检查 EdgeOne Pages 的 Functions 目录是否正确设置为 functions，以及 KV 绑定名称是否为 ADMIN_KV。
Q: 登录失败提示"密码错误"
A: 确认环境变量 ADMIN_PASSWORD 设置正确。修改后需重新部署生效。
Q: 测试连接失败
A: 检查 Token 是否有效，仓库所有者和仓库名是否正确。Gitee Token 需要 projects 权限，GitHub Token 需要 repo 权限。确认所选平台与 Token 来源一致。
Q: 被锁定如何解除
A: 等待 15 分钟后自动解锁，或在 EdgeOne KV 中删除对应的锁定记录。
评论