810 字
4 分钟
给 Hexo 加个后台,轻松实现博客在线管理

Hexo 作为一个静态博客生成器,因其快速和简洁而深受开发者喜爱。然而,每次写文章都要打开本地编辑器、手动推送 Git 的流程,对于想在手机或平板上临时记笔记的博主来说并不友好。

Qexo 恰好解决了这个问题。它是一个轻量级、美观的开源 Hexo 后台管理系统。通过它,你可以直接在浏览器里写 Markdown、管理友情链接、上传图床,并一键部署。


一、 核心原理解析#

在开始部署前,理解 Qexo 的工作流能帮你更好地进行配置:

  1. 管理端 (Vercel):Qexo 程序运行在 Vercel 上。
  2. 存储端 (MongoDB):存放后台配置、登录账号及部分缓存。
  3. 数据源 (GitHub):当你保存文章时,Qexo 会通过 API 自动将 .md 文件提交到你的博客仓库,从而触发 Hexo 的自动部署(如 GitHub Actions)。

二、 部署步骤详解#

1. 申请 MongoDB(持久化存储)#

Qexo 需要数据库来存储你的账号密码。

  1. 访问 MongoDB Atlas
  2. 创建集群:选择 Free (Shared) 套餐,地区建议选 us-east-1 (与 Vercel 保持一致以降低延迟)。
  3. 安全配置
  • Database Access 中创建一个专用用户。
  • Network Access 中添加 0.0.0.0/0 (允许任意 IP 访问),否则 Vercel 的动态 IP 无法连接。
  1. 获取连接串:点击 Connect -> Drivers,复制类似 mongodb+srv://<username>:<password>@cluster0.xxx.mongodb.net 的链接。

2. Vercel 部署 Qexo#

你可以直接使用 Qexo 的一键部署功能。

  1. 项目克隆:进入 Qexo GitHub 仓库 并 Fork。
  2. 环境变量设置:在 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 ActionsVercel 触发构建。

三、 功能亮点#

  • 在线编辑器:支持即时预览,并能直接从剪切板粘贴图片到配置好的图床。
  • 配置管理:无需手动修改 _config.yml,可以在 UI 界面直接修改博客名称、关键词。
  • 统计面板:直观查看博客文章数量、字数分布和访问情况。

四、 安全性建议 (2026 补充)#

为了确保你的博客不被黑客入侵,请务必注意:

  1. 两步验证:开启 GitHub 的 2FA。
  2. 环境变量安全:不要将 MongoDB 密码或 PAT 泄露在 gulpfile.js 或非安全的环境变量之外。
  3. 定期备份:虽然 Qexo 很稳定,但定期手动备份你的 MongoDB 数据和 GitHub 仓库依然是良好习惯。

总结#

引入 Qexo 后的 Hexo 博客,兼具了静态博客的安全与极速,以及动态博客的便捷。对于长期经营博客的人来说,这种“随时随地记录灵感”的能力是非常珍贵的。

给 Hexo 加个后台,轻松实现博客在线管理
https://sw.rscclub.website/posts/hexoht/
作者
杨月昌
发布于
2017-01-18
许可协议
CC BY-NC-SA 4.0