本文最后更新于：2024年4月13日凌晨

Qexo 博客管理后台搭建

1. 前言

Qexo 是一个快速、强大、美观的在线 静态博客编辑器。使用 GPL3.0 开源协议。支持包括且不限于在 Vercel 等平台部署, 为您的静态博客添加动态的元素。使用Qexo可以管理Hexo友链、文章管理、站点统计、发布说说等多种功能，这篇文章是用其中一种方式部署，采用Vercel（PostgreSQL/SupaBase）的方式进行部署，想了解更多功能介绍和部署方式可以查看官方文档。

Qexo优势：

支持多种方式部署
在线Markdown编辑界面
多种形式消息推送
友情链接前端申请, 一键接入
图片上传、访客统计、Hexo配置编辑
开源免费、项目长期维护

不过使用Qexo后台的前提是 Hexo 需要搭建Github Action自动化部署^[1]，这里就不做介绍了，看着篇文章实现即可：https://cloud.tencent.com/developer/article/2277577

具体的执行流程如下：

流程图

2. 部署

方式一：直接点击下面这个按钮一键部署到vercel

方式二：首先将Qexo的GIthub仓库fork到自己Github中，仓库地址：https://github.com/Qexo/Qexo

然后到 vercel 选择项目引入

首次部署会报错, 请无视并进行接下来的步骤~

申请 Vercel 数据库

创建项目

设置项目名字、密码和选择区域

设置 vercel 的环境变量，将你设置的密码和上面的 URL 分别填到 PG_PASS 和 PG_HOST 其他保持不变即可。

名称	意义	示例
PG_HOST	PostgreSQL 数据库连接地址	db.xxx.supabase.co
PG_PORT	PostgreSQL 数据库通信端口默认应填写 5432	5432
PG_USER	PostgreSQL 数据库用户名	postgres
PG_DB	PostgreSQL 数据库名	postgres
PG_PASS	PostgreSQL 数据库密码	password

3.找到 vercel 项目在 Deployments 点击 Redeploy 开始部署, 若没有 Error 信息即可，看到下面这个样子就是部署成功了。

本地 docker 部署

由于supabase数据库的认证方式更改了，所以没办法用vercerl的方式，我将 Qexo 部署到docker并使用自己服务器上的Mysql。

下载Qexo 项目压缩包上传到服务器 -> https://github.com/Qexo/Qexo/releases/tag/3.1.0
在manage.py的同级目录下创建并修改 configs.py，修改docker file文件内容

import pymysql
pymysql.install_as_MySQLdb()
DOMAINS = ["127.0.0.1", "yoursite.com"]
DATABASES = {
    'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': 'qexo',
            'USER': 'root',
            'PASSWORD': 'password',
            'HOST': '127.0.0.1',
            'PORT': '3306',
            'OPTIONS': {
                "init_command": "SET sql_mode='STRICT_TRANS_TABLES'"
            }
    }
}

FROM python:3.11
WORKDIR /root
COPY . .

ARG CN=true
RUN if [ "$CN" = "true" ]; then \
        pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/ && \
        pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn; \
    fi

RUN python -m pip install --upgrade pip && \
    pip install -r requirements.txt && \
    python3 manage.py makemigrations && \
    python3 manage.py migrate

EXPOSE 3000 8000

CMD ["python3", "manage.py", "runserver", "0.0.0.0:8000", "--noreload" ]

构建 docker 镜像

1	`docker build -t qexo:3.1.0 .`

运行容器

1	`docker run -d -p 8000:8000 --name qexo qexo:3.1.0`

3.配置

点击域名跳转到页面，需要开魔法不然访问不了，或者绑定成自己的域名访问如下操作：

找到 vercel 项目 Settings -> Domains 配置自己的域名
然后将自己的域名解析到vercel 这的配置成 cname-china.vercel-dns.com

然后访问自己的域名到管理界面就行啦，初次访问要设置管理账户和密码。

博客配置

Github 密钥：于 Github 设置生成的 Token (建议使用 Classical) 需要 Repo & Workflow 下的权限 不建议给出所有权限
Github 仓：库您博客源码 自动化部署所在的仓库
项目分支：您博客源码自动化部署所在仓库的分支
博客路径：您博客源码自动化部署所在仓库的路径若为根目录请留空