Qexo - 快速部署您的静态博客管理工具

引言

Qexo 是一个基于Python的Hexo静态博客管理工具,支持在线编辑、实时预览、自动部署等功能。无需本地环境即可通过浏览器管理Hexo博客内容,适合追求轻量化和云端管理的用户。

项目地址

Qexo GitHub

一键部署到Vercel

Deploy with Vercel

点击上方按钮,按提示完成以下配置:

  1. 连接你的GitHub账号
  2. 填写环境变量(部署后也可修改):
    • DATABASE_URL: 数据库连接字符串(后文申请)
    • ALLOW_ACCOUNTS: 允许登录的GitHub用户名(多个用英文逗号分隔)

免费数据库申请教程

方案一:MongoDB Atlas(推荐)

  1. 访问 MongoDB Atlas
  2. 注册账号后创建免费集群(M0套餐)
  3. 创建数据库用户并设置密码
  4. 在Network Access中添加IP白名单 0.0.0.0/0
  5. 获取连接字符串:
    plaintext
    mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/?retryWrites=true&w=majority

方案二:PlanetScale(MySQL兼容)

  1. 访问 PlanetScale
  2. 创建免费数据库
  3. 获取连接字符串:
    plaintext
    mysql://<username>:<password>@<host>/<database>?sslaccept=strict

手动部署到Vercel

准备工作

  1. Fork项目仓库:https://github.com/am-abdj/Qexo
  2. 准备数据库连接字符串

部署步骤

  1. 登录 Vercel
  2. 新建Project → Import Git Repository
  3. 配置环境变量:
    plaintext
    DATABASE_URL = 你的数据库连接字符串
    ALLOW_ACCOUNTS = 你的GitHub用户名
  4. 点击Deploy等待完成(约2-5分钟)

初始化配置

  1. 访问部署完成的域名
  2. 首次访问需初始化:
    • 填写Hexo仓库地址(格式:github用户名/仓库名
    • 配置GitHub Token(需repo权限)
  3. 完成基础设置后即可开始使用

功能特性

✅ 可视化文章编辑
✅ 实时预览Markdown
✅ 自动同步到GitHub仓库
✅ 多用户权限管理
✅ 支持自定义域名


常见问题

如何更新版本?

  1. 进入Vercel项目的Git Integration设置
  2. 点击「Refresh Git Repository」
  3. 重新部署即可获取最新代码

数据库连接失败?

  1. 检查白名单设置是否允许所有IP
  2. 确认连接字符串中的用户名密码正确
  3. 尝试重启Vercel实例

通过本教程,您可以在10分钟内免费搭建完整的博客管理系统。Qexo+Vercel的组合提供了稳定的免费服务,配合MongoDB Atlas的512MB免费数据库,完全满足个人博客需求。

部署完成后,您可以通过 /admin 路径进入管理后台,开始发布内容管理您的Hexo博客!