【Vercel】Qexo | 为你的HEXO添加美观、强大的在线管理后台！

用GitHub actions部署Hexo：HEXO系列教程 | 使用GitHub Actions部署Hexo / GitHub Pages | 全流程详细介绍

1. 前言

GitHub：Qexo/Qexo: A Quick, Powerful and Pretty Online Manager for Hexo

官方文档：Qexo | 一个美观、强大的在线 静态博客 管理器

特色功能：

• 文章管理~全新界面
  • 3.0版本的 Qexo 重新设计了文章编辑页面, 您可以更优雅地进行文章编辑支持多种图床上传, 上传尽在弹指之间
• 缓存功能~速度至上
  • 支持将文章、页面、配置索引一键缓存至数据库, 保证您的高速访问Webhook 全自动清除缓存, 时刻保持数据最新
• 麻雀虽小~五脏俱全
  • 模块化架构
  • 支持多种 Hexo、Hugo、Valaxy 托管商 Github、Gitlab、本地
  • 多种图床协议支持 Github、S3、FTP、远程API
  • Markdown 语法 + 多种编辑界面, 所见即所得
  • 全新界面 黑夜/白天 一键切换
  • 多形式推送 Bark、Telegram、Pushdeer、Wechat…
  • reCaptcha 防止垃圾信息侵害
  • 友情链接 前端申请, 一键接入
  • 自动更新 简单方便, 保持最新
  • 自定字段 / 站点统计 / 页面管理 / 配置编辑
  • 评论通知 / 图片上传 / 标识生成 / API 拓展

2. QEXO部署

2.1 部署到vercel

根据作者写的文档，夜梦这里演示使用vercel部署（方便），点击：Deploy

首次部署会报错，我们不用管，继续即可（但最新的vercel默认使用nodejs20.x版本，所以肯定会报错，这个报错不属于正常范围，解决方法请参考本节3.5）：

2.2 申请 Vercel 数据库

进入Vercel Storage 界面，创建PostgreSQL数据库（限量免费）：

创建成功：

在Connect页面获取数据库连接信息。请注意在地区选择的位置选择与你上一步项目对应的地区（通常为 Washington, D.C., USA (East) – iad1，就是默认的地区）。

2.3 绑定项目

在左侧边栏选择Projects，点击Connect Project连接到我们第一步创建的项目：

2.4 部署

这个时候我们回到项目页面：

在Deployments中找到点击Redeploy开始重新部署：

如果重新部署的时候没有报错信息就可打开域名进入初始化引导。

2.5 报错解决

Vercel部署(PostgreSQL/Vercel)Redeploy时报错的解决方法：

./migrate.sh: line 1: pip: command not found

作者给出的解释：

解决方案：Using the Python Runtime with Serverless Functions (vercel.com)，也就是在项目设置中将Nodejs版本调整到18.x：

具体修改的位置：你的qexo项目——Settings——General——Node.js Version（选18.x）——Save。如下图：

修改完成后，我们保存，然后在deployments中redeploy即可。

2.6 部署成功

不出意外的话，到这里应该就部署成功了：

3. 配置

3.1 用户名密码

打开域名进入初始化引导（点击visit）（不用尝试访问下面这张图中的域名，夜梦已经删掉了）：

进入初始化界面：

设置用户名密码：

3.2 GitHub密钥

根据自己部署的配置进行填写，其中GitHub密钥的设置方法可以参考作者给出的方法：

于 Github 设置 生成的 Token (建议使用 Classical) 需要 Repo & Workflow 下的权限，不建议给出所有权限，如下图：

创建的token格式类似于ghp_EcJ44DIFRuqlj8xxxxxxxxxxxxxxxxx，把它复制到下面GitHub密钥中即可。

3.3 vercel密钥与项目ID

然后填入vercel相关的信息：

我们到vercel创建tokens：

项目ID可以在settings——general中找到：

然后我们就可以进入后台了！

4. 使用

鸽了，后面再写吧~