后台管理 - KOK博客

部署安装

Tue, 05 May 2026 00:00:00 +0000

部署安装

本章介绍如何将 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 中删除对应的锁定记录。

下一步

使用指南 - 学习如何使用各功能模块
编辑器使用 - 了解 Markdown 编辑器操作

使用指南

Tue, 05 May 2026 00:00:00 +0000

使用指南

登录后台后，左侧菜单栏可以访问所有功能模块。

仪表盘

仪表盘是登录后的默认页面，展示：

内容统计 - 文章、笔记、好物、投资笔记等各模块的数量
最近提交 - 博客仓库最近的 Git 提交记录
版本检测 - 对比当前版本与线上版本，提示是否需要更新

文章管理

文章列表

按发布时间倒序排列
支持搜索过滤（按标题搜索）
支持分类筛选
分页显示

创建/编辑文章

点击"新建文章"进入编辑器页面：

标题 - 填写文章标题（必填）
发布时间 - 选择发布日期和时间
分类 - 选择或创建分类
标签 - 添加标签，多个标签用回车分隔
摘要 - 可选，填写文章摘要
封面图 - 可选，输入图片 URL
正文 - Markdown 编辑器编写正文内容

编辑完毕后点击"发布"或"更新"按钮保存。

笔记管理

笔记列表

按时间倒序排列的表格展示
显示标题、日期、分类
支持分类筛选和搜索

创建/编辑笔记

笔记编辑器比文章更简洁：

标题 - 笔记标题（必填）
发布时间 - 发布日期时间
分类 - 选择分类
目录开关 - 是否在博客端显示目录
正文 - Markdown 内容

投资笔记

投资笔记分为两种类型：

盘前计划

用于记录每日开盘前的投资思路：

关注列表 - 今日关注的标的（代码、名称、理由）
持仓计划 - 现有持仓的操作预案
正文 - 其他盘前分析内容

盘后复盘

用于记录当日交易情况：

当日收益率 - 填写百分比（正数为盈利，负数为亏损）
交易记录 - 买入/卖出记录
重要新闻/消息 - 影响市场的消息
经验总结 - 今日反思
正文 - 详细复盘内容

列表中收益率显示规则：盈利为红色，亏损为绿色，持平为黑色（符合中国股市习惯）。

好物推荐

好物列表

表格形式展示，显示名称、日期、分类
支持分类筛选
支持全量扫描功能

创建/编辑好物

名称 - 产品名称（必填）
发布时间 - 发布日期时间
分类 - 选择分类
图片 URL - 产品图片地址
描述 - 简短描述
精选好物 - 勾选后在博客首页优先展示
正文 - 详细的使用体验和评测内容

文档管理

文档模块支持多层级的文档结构管理：

左侧树形导航 - 展示文档层级结构
右侧编辑器 - 编辑选中文档的内容
拖拽排序 - 支持拖拽调整文档顺序
新建/删除 - 支持在任意层级新建或删除文档

相册管理

照片网格展示
支持上传图片到图床
支持删除照片
上传后自动写入博客仓库对应的数据文件

友链管理

管理博客友情链接：

添加友链（名称、URL、描述、头像）
编辑已有友链信息
删除友链
调整友链排序

书签管理

管理分类书签网址：

按分组管理书签
添加/编辑/删除书签
书签包含：名称、URL、描述、图标

分类管理

统一管理所有内容类型的分类：

按模块分区展示（文章分类、笔记分类、好物分类）
支持新建分类
重命名分类 - 重命名后会自动同步更新所有关联文章的分类字段
删除分类

图片管理

基于 GitHub API 的图床管理，支持将图片直接托管在 GitHub 仓库中。

上传图片

支持三种上传方式：

拖拽上传 - 将图片拖拽到上传区域
粘贴上传 - 直接 Ctrl/Cmd+V 粘贴剪贴板中的图片
点击选择 - 点击上传区域选择本地文件

支持批量上传，支持 JPG / PNG / GIF / WebP / SVG 格式。

目录管理

支持创建多级目录
面包屑导航在目录间跳转
编辑器中上传的图片自动按 年/月 分目录存储（如 2026/05/image.png）

图片操作

复制链接 - 一键复制图片 URL
链接格式 - 支持 URL / Markdown / HTML / BBCode 四种格式
批量选择 - 勾选多张图片后可批量复制链接或删除
删除 - 单张或批量删除

图床配置

在"系统"菜单下的"图床配置"中设置：

仓库设置

配置项	说明
图床仓库	格式为 `owner/repo`，可与博客仓库相同或使用独立仓库
分支	仓库分支名，默认 `main`
存储目录	图片存放的根目录路径，留空表示仓库根目录
GitHub Token	需要 repo 权限，留空则复用系统设置中的 Token

命名规则

规则	说明
哈希化	自动生成唯一哈希文件名（默认）
保留原名	使用原始文件名
时间戳	以时间戳命名
前缀 + 原名	添加自定义前缀

图片压缩

上传前可选自动压缩（支持 JPG / PNG / WebP）
可调节压缩质量（0.1 ~ 1.0）

水印

可选添加文字水印
支持 5 个位置：左上、右上、中心、左下、右下
可调节水印透明度

链接规则

规则	URL 格式
GitHub Raw	`https://raw.githubusercontent.com/{owner}/{repo}/{branch}/{path}`
GitHub Pages	`https://{owner}.github.io/{repo}/{path}`
jsDelivr CDN	`https://cdn.jsdelivr.net/gh/{owner}/{repo}@{branch}/{path}`
Statically CDN	`https://cdn.statically.io/gh/{owner}/{repo}/{branch}/{path}`
自定义	使用 `{owner}`, `{repo}`, `{branch}`, `{path}` 变量

测试连接

点击"测试连接"按钮可验证仓库配置是否正确：

验证 Token 是否有效
验证仓库是否可访问
检测存储目录是否存在

配置编辑

在线编辑 Hugo 博客的 config.toml 配置文件：

表单模式 - 可视化编辑站点信息、首页风格、横幅、评论系统等
原始编辑模式 - 直接编辑 TOML 源码
保存后自动提交到 Git 仓库（Gitee 或 GitHub）

拖拽排序

配置页面中以下模块支持通过拖拽 ⠿ 图标调整顺序：

导航菜单 - 拖拽调整菜单项的显示顺序
社交链接 - 拖拽调整页脚社交图标顺序
热门文章推荐 - 拖拽调整侧边栏推荐文章的排列顺序

首页风格切换

在配置管理的"首页风格"区域，通过下拉菜单选择首页风格：

个人生活风格 - 横幅 + 文章卡片 + 侧边栏（默认）
简洁笔记风格 - 极简文章列表，可配置显示日期、分类、标签、摘要
技术博客风格 - 精选文章置顶 + 文章列表 + 侧边栏
工作室风格 - 多模块展示（文章、笔记、好物、投资、文档）

选择"简洁笔记风格"后，会展开子选项面板，可以分别控制列表中显示哪些信息。

投资提示文字

在"首页风格"区域底部可以自定义投资页面顶部的提示文字（如发布时间说明）。

系统设置

平台选择

系统支持两种 Git 托管平台：

平台	说明
Gitee	国内访问速度快，默认分支 `master`
GitHub	国际通用平台，默认分支 `main`

在系统设置页面顶部的"托管平台"下拉菜单中选择对应平台，系统会自动适配对应的 API。

仓库配置

配置项	说明
托管平台	选择 Gitee 或 GitHub
Access Token	平台的个人访问令牌
仓库所有者	用户名或组织名
仓库名称	Hugo 博客仓库名
分支名称	仓库默认分支（Gitee 默认 master，GitHub 默认 main）

功能操作

连接测试 - 一键测试 API 连通性（自动适配所选平台）
清除缓存 - 清除 KV 中的列表缓存数据
全量扫描 - 重新扫描仓库文件，重建缓存

缓存管理

后台使用 KV 缓存来提升性能：

列表数据首次加载时全量扫描并存入 KV
后续增删改操作自动增量更新缓存
如果数据异常，可在系统设置中手动清除缓存或重新扫描

下一步

编辑器使用 - 详细了解 Markdown 编辑器
版本更新 - 如何更新后台系统

编辑器使用

Tue, 05 May 2026 00:00:00 +0000

编辑器使用

PrimeEdge Admin 内置了功能完善的 Markdown 编辑器，支持实时预览和多种快捷操作。

工具栏

编辑器顶部工具栏提供以下快捷按钮：

按钮	功能	快捷键
H1	一级标题（仅文档编辑器）	-
H2	二级标题	-
H3	三级标题	-
B	粗体	Ctrl/Cmd + B
I	斜体	Ctrl/Cmd + I
S	删除线	-
Link	插入链接	Ctrl/Cmd + K
Image	插入图片	-
Code	行内代码	-
Block	代码块	-
Quote	引用	-
UL	无序列表	-
OL	有序列表	-
HR	分割线	-

预览模式

编辑器支持三种模式切换：

分屏模式（默认）

左侧编辑区，右侧实时预览
编辑内容时预览自动同步滚动
适合大屏幕使用

纯编辑模式

隐藏预览区域
编辑区占满整个宽度
适合专注写作

纯预览模式

隐藏编辑区
全屏查看渲染效果
适合检查最终效果

全屏编辑

点击全屏按钮或使用快捷键进入全屏编辑模式：

编辑器占满整个浏览器窗口
按 ESC 键退出全屏
手机端编辑器自动优化高度（最小 50vh）

保存快捷键

Ctrl/Cmd + S - 快速保存当前内容

图片插入

图床上传（推荐）

点击工具栏图片按钮，会弹出图片上传窗口：

拖拽图片 到上传区域
粘贴图片 - 直接 Ctrl/Cmd+V 粘贴剪贴板图片
点击选择 - 从本地文件选择图片

上传成功后自动插入 Markdown 图片标记到编辑器光标位置。

编辑器中上传的图片自动按 年/月 分目录存储，如 2026/05/image.png，无需手动管理目录。

粘贴上传

在编辑区直接按 Ctrl/Cmd+V 粘贴图片（如截图），系统会自动上传到图床并插入链接，无需手动操作。

手动输入 URL

也可以直接在 Markdown 中编写图片语法：

![图片描述](https://example.com/image.jpg)

图床配置

图片上传功能依赖图床配置，请确保已在"系统 > 图床配置"中完成以下设置：

图床仓库地址
GitHub Token（或在系统设置中已配置）
链接规则（决定生成的图片 URL 格式）

详见使用指南 - 图床配置。

手机端适配

在手机端使用编辑器时：

工具栏可横向滚动
编辑区最小高度 50vh，方便输入
建议使用纯编辑模式（隐藏预览以获得更大编辑空间）
全屏模式支持更好的输入体验

Markdown 语法参考

标题

## 二级标题
### 三级标题
#### 四级标题

文本格式

**粗体文本**
*斜体文本*
~~删除线文本~~
`行内代码`

列表

- 无序列表项 1
- 无序列表项 2

1. 有序列表项 1
2. 有序列表项 2

链接和图片

[链接文字](https://example.com)
![图片描述](https://example.com/image.jpg)

引用

> 这是一段引用文本
> 可以多行

代码块

```javascript
function hello() {
 console.log('Hello!');
}
```

表格

| 列1 | 列2 | 列3 |
|------|------|------|
| 内容 | 内容 | 内容 |

下一步

使用指南 - 查看各模块详细用法
版本更新 - 了解如何更新

版本更新

Tue, 05 May 2026 00:00:00 +0000

版本更新

PrimeEdge Admin 支持自动版本检测，当有新版本发布时仪表盘会提示更新。

版本检测机制

系统通过以下方式检测版本：

后台内置当前版本号
通过 Gitee API 读取博客仓库中的 static/version.json 文件
对比两个版本号，有差异时在仪表盘显示更新提示

配置版本文件

在 Hugo 博客仓库的 static/version.json 中维护版本号：

{
 "theme": "1.2.0",
 "admin": "1.1.0"
}

theme - 博客主题当前版本
admin - 后台管理系统当前版本

更新步骤

1. 检查更新内容

访问后台源码仓库查看更新日志，了解新版本变更内容。

2. 拉取最新代码

cd primeedge-admin
git pull origin main

3. 推送到部署仓库

git push

EdgeOne Pages 会自动检测到推送并触发重新部署。

4. 验证更新

部署完成后刷新后台页面，检查仪表盘版本号是否更新。

5. 更新版本文件

更新博客仓库中 static/version.json 的 admin 字段为新版本号，保持一致。

注意事项

更新前建议备份当前的环境变量配置

如果更新后出现问题，可以回退到上一个 commit：

git log --oneline -5 # 查看最近提交
git revert HEAD # 回退最近一次提交
git push

KV 中的数据（设置、缓存）在更新后会保留
如果新版本修改了 KV 数据结构，可能需要在系统设置中清除缓存

下一步

部署安装 - 回顾部署流程
使用指南 - 查看功能使用方法