Hexo-Admin管理插件使用

本文最后更新于 2026年3月18日 晚上

Hexo-Admin 是一款为 Hexo 博客设计的后台管理插件,它能让你告枯燥的命令行,直接在浏览器里撰写文章、编辑草稿、管理标签,甚至直接发布。

这篇教程将带你从安装到进阶配置,全方位掌握这个插件。

1. 安装与启动

首先,确保你已经进入了 Hexo 博客的根目录。
执行安装命令:

1
npm install --save hexo-admin

启动 Hexo 服务器:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
hexo server```
访问后台:
打开浏览器,输入 http://localhost:4000/admin/。
### 2. 功能解析
进入后台后,你会看到一个简洁的界面
- Posts (已发布): 管理你所有的正式文章。
- Pages (页面): 管理如“关于我”、“友链”等独立页面。
- Deplay(部署):部署你的博客
#### 撰写体验
Hexo-Admin 提供了侧边预览模式。你在左侧输入 Markdown 源码,右侧会实时渲染出效果。

- 插入图片: 直接将图片粘贴到编辑器,插件会自动帮你把图片存入 source/images 文件夹并生成路径,非常方便。
- 管理元数据: 在侧边栏可以轻松修改 Categories、Tags 和 Date。

### 3. 安全配置(必做)
默认情况下,任何人访问 localhost:4000/admin/ 都能修改你的博客。虽然在本地开发没问题,但如果你将博客部署到了云服务器,必须设置密码。

在后台点击 `Settings -> Setup authentication`。

输入你的 Username、Password 和 Secret。

插件会自动生成一段配置代码,如下所示:

```YAML
admin:
username: my_username
password_hash: $2a$10$xxxxxxxxxxxx
secret: my_secret

将这段代码复制到你博客根目录的 _config.yml 文件末尾。

重启 Hexo 服务,再次访问后台就需要登录了。

4. 自动化部署 (Advanced)

Hexo-Admin 最强大的地方在于它支持一键部署。你可以配置一个脚本,让它在后台点击按钮后自动执行 hexo g -d。
在博客根目录下创建一个脚本文件
Linux / macOS 脚本 (deploy.sh)
在 Linux 环境下,我们通常使用 bash。为了确保脚本有执行权限,创建后请运行 chmod +x deploy.sh

1
2
3
4
5
6
7
8
9
10
11
#!/bin/bash
echo "--- 开始自动部署 ---"
# 清理缓存并生成静态文件
hexo clean
hexo generate
# 部署到远程仓库(如 GitHub/云服务器)
hexo deploy

echo "--- 部署完成! ---"```
**Windows 脚本 (deploy.bat)**
Windows 下使用批处理脚本。注意,如果你的 hexo 命令在某些环境下失效,可能需要使用 call hexo。

@echo off
echo — Starting Auto Deploy —

:: 清理并生成
call hexo clean
call hexo generate

:: 部署
call hexo deploy

echo — Deploy Finished! —
pause

#### 如何在 Hexo 中关联脚本
脚本准备好后,你需要修改博客根目录下的 _config.yml,找到(或添加)admin 配置项:

Linux 配置示例:
```YAML
admin:
  deployCommand: './deploy.sh'```
Windows 配置示例:
```YAML
admin:
  deployCommand: 'deploy.bat'```
这样,当你写完文章,直接在后台点一下 Deploy,文章就飞向服务器了。

💡 常见小贴士
图片路径问题: 如果你使用了资源文件夹(post_asset_folder),Hexo-Admin 的图片处理可能需要配合 hexo-asset-image 插件使用,以防路径失效。

进程守护: 如果你在服务器上运行,建议配合 pm2 来守护 Hexo 进程,确保后台一直在线。

避坑指南: Hexo-Admin 主要是为了本地或私有服务器协作设计的。如果你使用的是 GitHub Pages 静态托管,你还是需要在本地电脑上运行管理界面,生成后再推送到 GitHub。

卸载执行命令并删除_config.yml里的相关配置:
'''
npm uninstall --save hexo-admin
'''

Hexo-Admin管理插件使用
https://blog.quickso.cn/2026/03/18/Hexo-Admin管理插件使用/
作者
木子欢儿
发布于
2026年3月18日
许可协议