部署 ​

Docker 容器部署 ​

Docker 容器部署是部署 QD 的最简单方式。

操作前请一定要记得备份数据库!!!

容器 ​

DockerHub 网址：https://hub.docker.com/r/qdtoday/qd

Tag 含义:

• latest: 最新 Release 版本
• lite-latest: 去除 OCR 相关功能的最新 Release 版本
• ja3-latest: 集成 curl-impersonate 解决 ja3 指纹被识别为 curl 的问题, 不支持 http3 和 Quic 连接
• 20xxxxxx: 指定 Release 版本, 版本号表示为 Release 发布日期
• dev: 最新开发版, 同步最新源码, 不保证稳定性

部署方法 ​

1. Docker Compose（推荐） ​

# 创建并切换到 QD 目录。
mkdir -p $(pwd)/qd/config && cd $(pwd)/qd
# 下载 docker-compose.yml
wget https://fastly.jsdelivr.net/gh/qd-today/qd@master/docker-compose.yml
# 根据需求和配置说明修改配置环境变量
vi ./docker-compose.yml
# 执行 Docker Compose 命令
docker-compose up -d

配置描述见下文 Configuration

如不需要OCR功能或者硬盘空间不大于600M, 请使用 qdtoday/qd:lite-latest 镜像, 该镜像仅去除了OCR相关功能, 其他与主线版本保持一致。

请勿使用 阿里云镜像源 拉取 Docker 容器, 会导致无法拉取最新镜像

2. 1Panel 部署 ​

2.1. 在 1Panel 中创建一个新的应用

不同 1Panel 版本显示 QD 框架名称可能不同, 但均为 QD 图标.

2.2. 配置相关设置

如需设置环境变量请点击 编辑 Compose 文件

配置描述见下文 Configuration

如不需要OCR功能或者硬盘空间不大于600M, 请使用 qdtoday/qd:lite-latest 镜像, 该镜像仅去除了OCR相关功能, 其他与主线版本保持一致。

2.3. 点击 确认 即可通过 1Panel 安装 QD

3. Docker 运行 ​

docker run -d --name qd -p 8923:80 -v $(pwd)/qd/config:/usr/src/app/config qdtoday/qd

容器内部无法连通外部网络时尝试该命令:

# 使用 Host 网络模式创建容器, 端口号: 8923
docker run -d --name qd --env PORT=8923 --net=host -v $(pwd)/qd/config:/usr/src/app/config qdtoday/qd

注意: 使用该命令创建容器后, 请将模板里 http://localhost/ 形式的 api 请求, 手动改成 api:// 或 http://localhost:8923/ 后, 才能正常完成相关API请求。

请勿同时运行新旧版 QD 框架, 或将不同运行中的 QD 容器数据库映射为同一文件。

源码部署 ​

1. Version >= python3.9

   sh

   # 请先cd到框架源码根目录
   pip3 install -r requirements.txt

2. 修改相关设置

   sh

   # 执行以下命令复制配置文件
   # 修改 local_config.py 文件的内容不受通过 git 更新源码的影响
   cp config.py local_config.py
   # 根据需求和配置说明修改配置文件或环境变量值
   vi local_config.py

3. 启动

   sh

   python ./run.py

4. 访问

   sh

   # 访问网页
   http://localhost:8923/

   如果您使用的是源码部署方式，请手动将模板中 http://localhost/ 形式的 api 请求改为 api:// 或 http://localhost:8923/ ，以便正确完成相关API 请求。

   模板需要发布才会在「公开模板」中展示, 你需要管理员权限在「我的发布请求」中审批通过。

设置管理员 ​

python ./chrole.py your@email.address admin

首位注册用户默认为管理员, 需要先登出再登陆后才能获得完整管理员权限

配置环境变量 ​

详细信息请查阅config.py