Qexo - 一个快速、强大、漂亮的在线 Hexo 编辑器

Qexo 是一个快速、强大、漂亮的在线 Hexo 编辑器

快速开始

Github 开源仓库:https://github.com/am-abudu/Qexo
Wiki:https://github.com/am-abudu/Qexo/wiki

特色功能

  • 自定义图床上传图片
  • 在线配置编辑
  • 在线文章管理
  • 在线页面管理
  • 较为完善的缓存功能
  • Webhook 清除缓存
  • 自动检查更新
  • 实验性的在线更新
  • 开放的 API

无服务器部署

申请 MongoDB

注册 MongoDB 账号 创建免费 MongoDB 数据库,区域推荐选择 AWS / N.
Virginia (us-east-1) 在 Clusters 页面点击 CONNECT,按步骤设置允许所有 IP 地址的连接),创建数据库用户,并记录数据库连接信息,密码即为你所设置的值

Fork 本项目

打开 项目主页 点击 Fork 将项目复刻到您的账户下

创建 Vercel 项目

打开 Vercel 注册账号并绑定 Github 新建一个项目并绑定 Fork 的仓库

部署

在项目部署界面添加环境变量 Environment Variables

点击 Deploy 开始部署,若没有 Error 信息即可打开域名进入初始化引导

常见问题

什么是 API 密钥

在您完成初始化之后可在设置界面修改/创建 API 密钥,用于 Webhook 中的身份验证。若留空系统会随机生成一个 API 密钥

Webhook 是什么

Qexo 中的 Webhook 指 /api/webhook 用于自动化操作,目前可用于自动清除缓存

安装后出现 504 Time out

出现这个问题表示您的数据库没有正确配置或没有允许所有 IP 白名单访问,可在 MongoDB 控制台进行修改,修改完成后一定要重新部署

安装/更新后出现 5xx 错误

Qexo 每个 Release 都经过 Dev 分支的测试,一般情况下不会出现较大问题,如果你遇到了500等错误,请尝试以下步骤

  1. 检查数据库配置
  2. 清除浏览器缓存
  3. 保留数据库配置的环境变量并重新 Fork 仓库部署
  4. 重新部署整个程序

AssertionError(“xxx object … its id attribute is set to None.”)

请检查你是否曾使用过0.01或0.1版本,这两个版本有严重问题,请重新创建数据库并部署

如何创建子目录下的文章

在文章名一栏填写 dir/filename 例如您希望创建 source/_posts/about/me.md 则需要输入 about/me

Vercel 用量问题

Vercel 的无服务器函数用量远高于 腾讯云SCF 等服务,但这依然抵挡不住有心之人的攻击行为,所以要保护好自己后台地址,不过好在 Vercel 不会随意扣费,所以在资源用完之后并不会产生费用,若依然不放心可以考虑部署在自己的服务器上 #服务器部署#

在线更新失败了

若在线更新失败,可检查 token 是否可用以及当前是否有新的 commit。 Qexo 的在线更新仍是实验性的,若确保没有问题可发 issue 寻求帮助

其他问题

如果还有问题,可以发 issue 或加入 HexoPlusPlus交流群 询问

如何更新

在线更新(实验性)

  • 在 Settings 页完成在线更新相关设置 -> 远程分支可为master(较稳定)/dev(最新)
  • 刷新页面 点击“同步更新”

手动更新

  • 打开 Pull requests 创建页面 , 点击 compare across forks
  • base repository 修改为您的仓库
  • 点击 Create pull request 创建 PR
  • 在接下来的页面中点击 merge 合并 Pull request

鸣谢

Qexo 的诞生离不开这些项目的付出

Qexo - 一个快速、强大、漂亮的在线 Hexo 编辑器

http://www.oplog.cn/archives/59651.html

作者

啊不都

发布于

2021-11-21

更新于

2022-06-23

许可协议

CC BY 4.0

评论

查看更多