810 字
4 分钟
给 Hexo 加个后台,轻松实现博客在线管理
Hexo 作为一个静态博客生成器,因其快速和简洁而深受开发者喜爱。然而,每次写文章都要打开本地编辑器、手动推送 Git 的流程,对于想在手机或平板上临时记笔记的博主来说并不友好。
Qexo 恰好解决了这个问题。它是一个轻量级、美观的开源 Hexo 后台管理系统。通过它,你可以直接在浏览器里写 Markdown、管理友情链接、上传图床,并一键部署。
一、 核心原理解析
在开始部署前,理解 Qexo 的工作流能帮你更好地进行配置:
- 管理端 (Vercel):Qexo 程序运行在 Vercel 上。
- 存储端 (MongoDB):存放后台配置、登录账号及部分缓存。
- 数据源 (GitHub):当你保存文章时,Qexo 会通过 API 自动将
.md文件提交到你的博客仓库,从而触发 Hexo 的自动部署(如 GitHub Actions)。
二、 部署步骤详解
1. 申请 MongoDB(持久化存储)
Qexo 需要数据库来存储你的账号密码。
- 访问 MongoDB Atlas。
- 创建集群:选择 Free (Shared) 套餐,地区建议选
us-east-1(与 Vercel 保持一致以降低延迟)。 - 安全配置:
- 在 Database Access 中创建一个专用用户。
- 在 Network Access 中添加
0.0.0.0/0(允许任意 IP 访问),否则 Vercel 的动态 IP 无法连接。
- 获取连接串:点击 Connect -> Drivers,复制类似
mongodb+srv://<username>:<password>@cluster0.xxx.mongodb.net的链接。
2. Vercel 部署 Qexo
你可以直接使用 Qexo 的一键部署功能。
- 项目克隆:进入 Qexo GitHub 仓库 并 Fork。
- 环境变量设置:在 Vercel 部署面板中,必须配置以下变量:
| 变量名 | 示例值 / 说明 |
|---|---|
MONGODB_HOST | 你的 MongoDB 连接地址(不带前缀) |
MONGODB_USER | 数据库用户名 |
MONGODB_PASS | 数据库密码 |
DOMAINS | ["你的域名", ".vercel.app"](允许跨域的域名列表) |
VERCEL_ACCESS_TOKEN | (可选) Vercel 的 API Token,用于实现自动化部署。 |
3. 初始化配置
部署完成后,访问你的 Vercel 域名,会进入初始化向导。
- 仓库信息:填写你的 Hexo 博客所在的 GitHub 仓库名和分支。
- Token:需要提供一个具有写入权限的 GitHub Personal Access Token (PAT)。
- 发布方式:建议选择
Github Actions或Vercel触发构建。
三、 功能亮点
- 在线编辑器:支持即时预览,并能直接从剪切板粘贴图片到配置好的图床。
- 配置管理:无需手动修改
_config.yml,可以在 UI 界面直接修改博客名称、关键词。 - 统计面板:直观查看博客文章数量、字数分布和访问情况。
四、 安全性建议 (2026 补充)
为了确保你的博客不被黑客入侵,请务必注意:
- 两步验证:开启 GitHub 的 2FA。
- 环境变量安全:不要将 MongoDB 密码或 PAT 泄露在
gulpfile.js或非安全的环境变量之外。 - 定期备份:虽然 Qexo 很稳定,但定期手动备份你的 MongoDB 数据和 GitHub 仓库依然是良好习惯。
总结
引入 Qexo 后的 Hexo 博客,兼具了静态博客的安全与极速,以及动态博客的便捷。对于长期经营博客的人来说,这种“随时随地记录灵感”的能力是非常珍贵的。
给 Hexo 加个后台,轻松实现博客在线管理
https://sw.rscclub.website/posts/hexoht/