Docker 部署 Qexo

Qexo 是一个快速、强大、美观的在线静态博客编辑器。使用 GPL3.0 开源协议。支持包括且不限于在 Vercel 等平台部署, 为您的静态博客添加动态的元素。本文使用 Docker 本地部署 Qexo。

1. 项目分析

1.1. 项目结构

数据库
Django

其中数据库支持多种数据库,官网有所介绍,这里不再赘述,我们制作镜像,肯定镜像越轻量越好,所以我们选择轻量级的sqlite3数据库，然后就是django环境,我们可以直接使用python:3.11.3-alpine镜像进行构建,alpine镜像体积小,比较适合我们的需求

1.2. 资源准备

需要构建镜像的Dockerfile文件
需要一个db文件夹,用于存放数据库文件,在里面创建一个空的db.sqlite3文件
准备一个configs.py文件存放数据库连接配置信息
Qexo的源码,这里我们不需要拷贝到本地,不对代码进行侵入式修改,直接使用git clone命令拉取代码即可,这样我们的镜像就是一个纯净的Qexo项目

1.3. 本地环境

Docker 环境
Ubuntu 22.04

2. 项目构建

2.1. 构建 Dockerfile

1
2
3

mkdir /data/qexo
cd /data/qexo
vim Dockerfile

FROM python:3.11.3-alpine
# 维护者信息
LABEL maintainer="whb@yyds.space"
# 设置生产模式环境变量 
# ENV APP_ENV production
# pipy源设置
RUN pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple/
# 设置时区
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories && \
    apk --no-cache add tzdata && \
    cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
    apk --no-cache del tzdata && \
    apk --no-cache add git && \
    mkdir /app
# 设置工作目录
WORKDIR /app
# 拷贝数据
RUN git clone https://ghproxy.com/https://github.com/Qexo/Qexo.git /app
# 安装依赖
RUN pip install --upgrade pip 
RUN apk --no-cache add build-base python3-dev libffi-dev
RUN pip install Django==3.2.18
RUN pip install PyMySQL==1.0.2
RUN pip install boto3==1.26.94
RUN pip install requests==2.28.2
RUN pip install PyGithub==1.58.1
RUN pip install python-gitlab==3.13.0
RUN pip install html2text==2020.1.16
RUN pip install PyYAML
RUN pip install urllib3==1.26.15
RUN pip install Markdown==3.4.1
RUN pip install djongo==1.3.6
RUN pip install django-cors-headers==3.14.0
RUN pip install pymongo==3.13.0
RUN pip install dnspython==2.2.1
RUN pip install sqlparse==0.2.4
RUN pip install psycopg2-binary==2.9.5
RUN pip install cryptography==39.0.2
RUN pip install pyopenssl==23.0.0
RUN pip install oss2==2.17.0
RUN pip install beautifulsoup4==4.11.2
# 拷贝启动脚本
COPY . /app/
RUN chmod +x /app/run.sh
# 暴露端口
EXPOSE 8000
# 挂载目录
VOLUME ["/app/db", "/app/data"]
# 启动django
ENTRYPOINT ["/bin/sh", "/app/run.sh"]

FROM python:3.11.3-alpine使用python:3.11.3-alpine镜像作为基础镜像,前面有介绍
pipy源设置,这里我使用的是腾讯云的pypi/simple,你也可以使用其他的,比如阿里云的pypi/simple,注意即使是服务器,这里最好请使用公网的源,不要使用内网的源,否则可能会出现不可预知的错误
时区设置,这就不用多说了,不设置时区,可能会导致时间不正确,比如django的admin后台,时间显示不正确
然后我创建了app目录用来存放项目
git clone拉取Qexo项目源代码,如果有网络问题可以使用https://ghproxy.com/代理加速,这个请自行选择
拉取代码后,源代码仓库有requirements.txt直接使用就好，但是本人遇到了一些环境问题导致镜像构建失败，所以安装了开发环境后，手动重新部署依赖。
拷贝相关文件到镜像中,configs.py和db文件夹等需要放进去,可以使用拷贝,或者挂载方式,这里我使用的是拷贝方式(为了省事)。
我最后运行使用的是run.sh脚本,所以一定记得给脚本赋予可执行权限!!!
一定记得给脚本赋予可执行权限!!!
VOLUNE挂载目录,这里我挂载了/app/db, /app/data两个目录,/app/db是数据库目录,/app/data是静态文件目录。
app/db目录是数据库目录,这个目录一定要挂载出来,否则重启镜像会导致配置的数据丢失,这个目录实现数据持久化
app/data目录是静态文件目录,这个目录也需要挂载出来,用来存放hexo的项目,也就是说请把这个目录挂载给hexo目录,非本地搭建hexo,可不挂载

2.2. 配置 run.sh

#!/bin/bash

python3 manage.py makemigrations
python3 manage.py migrate
python3 manage.py runserver 0.0.0.0:8000 --noreload

makemigrations创建数据库迁移文件
migrate执行数据库迁移
runserver启动django服务
这些是django的基本操作,当然生产环境还是建议使用gunicorn、uwsgi等工具

2.3. 配置 configs.py

# 数据库配置
import pymysql,os

DOMAINS = ["127.0.0.1", "qexo.yyds.space", "101.43.253.61"]
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join('/app/db' , 'db.sqlite3'),
    }
}