一、项目简介

Hexo Pro 是专为 Hexo 静态博客框架打造的后台管理系统插件，为博客作者提供更强大、更便捷的内容管理体验。通过 Hexo Pro，你可以告别传统的 Markdown 文件编辑方式，通过可视化界面高效**管理博客内容。

核心功能：**

  • 文章管理与 Front-matter 可视化编辑
  • 页面管理
  • 图床集成（支持图片粘贴上传）
  • Hexo 配置文件可视化编辑
  • 全局搜索
  • 一键部署
  • 多主题支持（暗黑/明亮模式）
  • 多用户权限管理

二、安装与启动

2.1 环境要求

  • Node.js 16+
  • Hexo 7.x

2.2 安装步骤

1
2
3
4
5
6
7
8
9
10
11
# 1. 进入你的 Hexo 博客目录
cd your-hexo-blog

# 2. 安装 Hexo Pro 插件
npm install --save hexo-pro

# 3. 启动 Hexo 服务器
hexo server

# 4. 访问后台管理页面
open http://localhost:4000/pro/

2.3 桌面客户端（可选）

**如果需要更强大的桌面端体验，可以下载 **Hexo Pro Desktop 预构建版本，支持：

  • 多项目管理
  • 自动认证
  • 原生菜单
  • 离线管理

三、登录与初始化

3.1 首次登录

**启动服务后，访问 **http://localhost:4000/pro/ 进入登录页面。

默认账号：

  • 用户名：admin
  • 密码：hexo-pro

⚠️ 首次登录后请及时修改默认密码！

3.2 修改密码

登录后进入「设置」页面，可修改登录密码。

四、核心功能使用

4.1 文章管理

创建新文章

  1. 点击左侧菜单「文章」
  2. 点击右上角「新建文章」按钮
  3. 填写文章标题和内容
  4. 在右侧面板配置 Front-matter 参数：
    • 标题 (title)
    • 日期 (date)
    • 分类 (categories)
    • 标签 (tags)
    • 封面图片 (cover)
    • 置顶 (top)
    • 草稿 (draft)
  5. 点击「保存」或「发布」

编辑文章

  1. 在文章列表中找到目标文章
  2. 点击文章标题进入编辑页面
  3. 支持 Markdown 语法编辑
  4. 右侧面板可实时预览和调整 Front-matter
  5. 点击「保存」更新内容

删除文章

  1. 选中目标文章
  2. 点击「删除」按钮
  3. 文章将移至回收站

文章搜索

支持按标题、日期、分类、标签筛选文章。

4.2 页面管理

用于管理 Hexo 静态页面（如「关于」页面）。

创建页面

  1. 点击左侧菜单「页面」
  2. 点击「新建页面」
  3. 填写页面标题和内容
  4. 设置页面链接别名（permalink）
  5. 保存发布

页面列表

展示所有已创建的页面，支持编辑和删除操作。

4.3 图床管理

Hexo Pro 内置图床功能，支持图片管理和粘贴上传。

上传图片

方式一：粘贴上传

  • 在文章编辑器中，直接 Ctrl + V 粘贴剪贴板中的图片
  • 图片将自动上传并插入文章

方式二：按钮上传

  • 点击编辑器工具栏的图片图标
  • 选择本地图片文件上传

图床管理

  1. 点击左侧菜单「图床」
  2. 查看所有已上传的图片
  3. 支持删除不需要的图片
  4. 点击图片可复制 Markdown 引用链接

4.4 配置管理

可视化编辑 Hexo 配置文件（_config.yml）。

编辑配置

  1. 点击左侧菜单「配置」
  2. 找到需要修改的配置项
  3. 直接在输入框中修改值
  4. 点击「保存」应用更改

常用配置项：

  • 博客标题、描述
  • 主题设置
  • 部署配置
  • 评论功能
  • 网站地图等

⚠️ 修改配置前建议备份原文件！

4.5 全局搜索

基于 Fuse.js 的全文检索功能。

搜索文章

  1. 点击顶部搜索栏或使用快捷键
  2. 输入关键词
  3. 实时显示搜索结果
  4. 点击结果快速跳转

4.6 一键部署

支持多种部署方式，快速将博客发布到线上。

配置部署

在「配置」-「部署」中设置：

  • 部署类型：GitHub Pages、Netlify、Vercel 等
  • 仓库地址
  • 分支名称
  • 认证信息

执行部署

  1. 点击左侧菜单「部署」
  2. 选择部署目标
  3. 点击「部署」按钮
  4. 等待部署完成

💡 v1.2.6 新增「快速部署模式」，开启后可直接推送到仓库，跳过静态文件生成。

4.7 主题设置

切换主题

  1. 在「配置」中找到主题设置
  2. 选择需要的主题
  3. 保存并重启服务

暗黑模式

点击界面右上角主题切换按钮，一键切换暗黑/明亮模式。

4.8 用户管理

管理员可以管理后台用户账号。

添加用户

  1. 进入「设置」-「用户管理」
  2. 点击「添加用户」
  3. 填写用户名和密码
  4. 设置用户权限

修改密码

在「设置」中可修改当前账号密码。

五、桌面客户端使用

5.1 启动

下载并安装 Hexo Pro Desktop 后：

  1. 首次启动选择 Hexo 博客项目目录
  2. 系统自动启动 Hexo Pro 服务
  3. 打开管理界面

5.2 多项目管理

支持同时管理多个 Hexo 博客项目，通过顶部切换器快速切换。

5.3 自动认证

首次登录后自动保存认证信息，后续启动无需重复登录。

六、常见问题

Q1: 忘记管理员密码怎么办？

**A: 删除数据文件 **users.db 后重启服务，将重置为默认密码。

Q2: 如何开启 HTTPS？

A: 可通过 Nginx 反向代理或使用 Hexo 插件实现。

Q3: 部署失败怎么办？

A: 检查部署配置是否正确，确保仓库认证信息有效。

Q4: 图片上传失败怎么办？

**A: 检查 **uploads 目录权限，确保有写入权限。

七、技术支持

文档最后更新：2026 年 3 月