PrimeEdge 快速安装指南
快速部署博客、后台管理和 Waline EdgeOne 评论服务
PrimeEdge 快速安装指南
PrimeEdge 完整方案由三个项目组成：
| 项目 | 作用 | 推荐域名示例 |
|---|---|---|
| PrimeEdge 博客 | Hugo 静态博客站点，承载文章、文档、相册、书签等内容 | https://www.example.com |
| Waline On EdgeOne | 评论服务，提供评论 API、Waline Admin 和 EdgeOne 设置页 | https://wl.example.com |
| PrimeEdge Admin | 博客后台，直接通过 Gitee / GitHub API 管理博客仓库 | https://admin.example.com |
建议先部署评论服务，再部署博客，最后部署后台管理。这样配置博客评论地址和后台评论管理时会顺很多。
一键部署 EdgeOne Pages
EdgeOne Pages 国内版
部署博客 PrimeEdge 主题
部署评论服务 Waline EdgeOne 版
部署后台管理 PrimeEdge Admin
EdgeOne Pages 国际版
部署博客 PrimeEdge 主题
部署评论服务 Waline EdgeOne 版
部署后台管理 PrimeEdge Admin
一键导入后仍需要检查项目构建目录、Functions 目录、KV 绑定和环境变量。改完这些设置后，通常需要重新部署一次才会生效。
博客部署设置
博客项目是 Hugo 静态站点：
| 配置项 | 推荐值 |
|---|---|
| 构建命令 | hugo --gc 或 hugo --gc --minify |
| 输出目录 | public |
| Functions 目录 | 留空 |
博客部署完成后，在 config.toml 中把 baseURL 改成自己的博客域名，并按实际情况配置 params.waline.serverURL。
Waline EdgeOne 版部署设置
绑定 KV 命名空间
在 Waline 项目设置中创建或选择一个 KV 命名空间，绑定名称必须为 WALINE_KV。
配置环境变量
在 EdgeOne Pages 控制台 -> 项目设置 -> 环境变量中添加：
| 变量名 | 必填 | 说明 |
|---|---|---|
JWT_SECRET | 是 | JWT 签名密钥，建议使用 32 位以上随机字符串 |
SECURE_DOMAINS | 建议 | 允许跨域访问评论 API 的域名，多个域名用英文逗号分隔，如 example.com,www.example.com |
OAUTH_URL | 否 | 自定义 OAuth 登录服务地址 |
WALINE_KV 是 KV 绑定名，不是环境变量。不要把它填成命名空间 ID。
首次初始化
部署后访问：
- 评论服务首页：
https://wl.example.com/ - Waline 管理后台：
https://wl.example.com/ui - EdgeOne 扩展设置：
https://wl.example.com/ui/worker-setting
第一次注册的账号会成为管理员。登录管理员账号后，进入 /ui/worker-setting 配置站点信息、评论策略、邮件通知、PushPlus、图片上传和极验验证。
PrimeEdge Admin 部署设置
部署目录
PrimeEdge Admin 不需要前端构建：
| 配置项 | 推荐值 |
|---|---|
| 构建命令 | 留空 |
| 输出目录 | public |
| Functions 目录 | functions |
绑定 KV 命名空间
后台项目至少需要绑定一个 KV：
| 绑定名 | 必填 | 用途 |
|---|---|---|
ADMIN_KV | 是 | 保存后台登录限流、Git 仓库设置、内容列表缓存、图床配置 |
WALINE_KV | 否 | 绑定到评论服务同一个 KV 后，后台内置的评论管理和评论设置才能使用 |
如果只想用 PrimeEdge Admin 管理博客内容，不在后台里管理评论，可以暂时不绑定 WALINE_KV。如果要使用左侧「评论系统」菜单，请把 WALINE_KV 绑定到 Waline 项目的同一个 KV 命名空间。
配置环境变量
在 EdgeOne Pages 控制台 -> 项目设置 -> 环境变量中添加：
| 变量名 | 必填 | 说明 |
|---|---|---|
ADMIN_PASSWORD | 是 | 后台登录密码 |
JWT_SECRET | 是 | JWT 签名密钥，建议使用 32 位以上随机字符串 |
ADMIN_PASSWORD_HASH | 否 | PBKDF2 密码哈希；配置后优先于 ADMIN_PASSWORD |
GIT_PLATFORM | 否 | gitee 或 github，可在后台系统设置中覆盖 |
GITEE_TOKEN / GITHUB_TOKEN | 否 | 仓库访问令牌，可在后台系统设置中保存 |
GITEE_OWNER / GITHUB_OWNER | 否 | 仓库所有者，可在后台系统设置中保存 |
GITEE_REPO / GITHUB_REPO | 否 | 博客仓库名，可在后台系统设置中保存 |
GIT_BRANCH | 否 | 博客仓库分支 |
生成 JWT_SECRET 的常用命令：
openssl rand -base64 32
绑定域名和博客接入
三套系统部署完成后，建议分别绑定域名：
- 博客域名绑定到 Hugo 项目。
- 评论域名绑定到 Waline 项目。
- 后台域名绑定到 PrimeEdge Admin 项目。
然后在博客 config.toml 中配置评论：
[params.comments]
provider = "waline"
[params.waline]
enable = true
serverURL = "https://wl.example.com"
geetestCaptchaId = ""
如果在 Waline 后台启用了极验验证，params.waline.geetestCaptchaId 必须填写同一个 Captcha ID；Captcha Key 只保存在 Waline 后台，不要写进博客配置。
后台管理初始化
访问 PrimeEdge Admin 域名并登录后，第一件事是进入「系统设置」填写 Git 仓库 API：
| 平台 | Token 权限 |
|---|---|
| Gitee | 私人令牌需要仓库读写权限 |
| GitHub | Personal Access Token 需要 repo 权限 |
保存并测试连接成功后，就可以可视化管理文章、笔记、文档、相册、友链、书签、分类、服务页、留言板和站点配置。
图床功能使用 GitHub 仓库存储图片，可在「系统 -> 图床配置」中填写独立的 owner/repo、分支、目录和 GitHub Token，也可以复用系统设置中的 GitHub Token。
常见问题
- 后台编辑内容后，博客仓库会产生提交；EdgeOne Pages 仍需要重新部署博客项目，线上页面才会更新。
- 后台通过 Git 平台 API 读写仓库，首次加载或全量扫描会比数据库后台慢一些，这是无服务器、零数据库方案的取舍。
- 评论服务的
SECURE_DOMAINS如果配置过窄，博客前端会出现跨域失败；请确认包含博客实际访问域名。 - Admin 评论管理提示
WALINE_KV 未绑定时，给 Admin 项目额外绑定评论服务同一个 KV 命名空间，绑定名为WALINE_KV。
评论