2026 自动化全能王：Docker 部署 QD 签到框架完全指南

在自动化签到、打卡或定时任务管理领域，开源签到框架 QD 是一个成熟、易部署的选择。它基于 HAR 编辑器 + Tornado，支持模板化 HTTP 请求和定时执行，非常适合自托管使用。本文将带你一步步通过 Docker 部署 QD，并讲解访问、配置与常见问题解决方案。

1. 前期准备#

系统与资源要求#

Linux 服务器（如 Ubuntu / Debian）
已安装 Docker 和 Docker Compose
推荐至少 1 核 CPU + 1GB 内存（任务量大可适当增加）

如果尚未安装 Docker，可使用以下命令（以 Ubuntu 为例）：

1
sudo apt update
2
sudo apt install -y docker.io docker-compose
3
sudo systemctl enable --now docker

Tip：Docker Compose Plugin 也可以使用 docker compose 命令。

2. 创建工作目录#

在服务器上创建用于 QD 的工作目录，并建立配置文件夹以便持久化数据：

1
mkdir -p ~/qd
2
cd ~/qd
3
mkdir config

这里 config 目录将存放模板、任务和日志，确保容器重建时数据不会丢失。

3. Docker Compose 配置#

在部署目录新建 docker-compose.yml 文件：

1
version: "3"
2

3
services:
4
  qd:
5
    image: qdtoday/qd:latest
6
    container_name: qd
7
    restart: unless-stopped
8
    ports:
9
      - "8923:80"
10
    volumes:
11
      - ./config:/usr/src/app/config
12
    environment:
13
      PHOTOPRISM_ADMIN_PASSWORD: "你的管理员密码" # 替换为实际密码

说明：

8923:80：容器 80 端口映射到宿主机 8923 端口，可根据需要修改
./config：挂载本地配置目录
PHOTOPRISM_ADMIN_PASSWORD：首次管理员密码

Tip：初次部署可使用 SQLite 内置数据库，轻量免配置；如果需要 MySQL，可通过环境变量配置连接字符串。

4. 启动 QD 容器#

在部署目录执行：

1
docker compose up -d

Docker 会拉取最新镜像并启动容器
默认监听 8923 端口

查看运行状态：

1
docker ps
2
docker compose logs -f

5. 访问 Web 控制台#

浏览器访问：

1
http://服务器IP:8923

首次访问需要注册管理员账号，可用于管理模板、添加定时任务、查看日志等。

在管理界面，你可以：

上传 HAR 模板
创建定时任务
管理账号和权限

6. 持久化与备份#

所有模板和任务数据保存在挂载的 config 文件夹中
建议定期备份 ~/qd/config 目录，确保容器升级或重建时数据安全

7. 可选配置#

7.1 修改访问端口#

如果端口冲突，可以在 docker-compose.yml 中修改：

1
ports:
2
  - "8000:80"

7.2 配置反向代理与 HTTPS#

如果希望通过域名访问，并启用 HTTPS，可使用 Nginx 反向代理：

1
server {
2
    listen 80;
3
    server_name qd.example.com;
4

5
    location / {
6
        proxy_pass http://127.0.0.1:8923;
7
        proxy_set_header Host $host;
8
        proxy_set_header X-Real-IP $remote_addr;
9
    }
10
}

配合 Let’s Encrypt 证书即可实现安全访问。

7.3 使用 MySQL 数据库#

默认使用 SQLite
如需 MySQL，可在 environment: 中设置数据库连接字符串
数据库挂载与备份同样需要注意持久化

8. 常用命令#

1
docker compose logs -f         # 查看日志
2
docker compose down            # 停止容器
3
docker compose pull            # 更新镜像
4
docker compose up -d           # 启动容器

9. 常见问题及解决#

问题	排查方法
容器未启动	检查 Docker 服务、端口占用情况
无法访问 Web 界面	检查端口映射、防火墙设置和容器日志
HAR 模板上传失败	确认文件格式正确、请求信息完整
定时任务不执行	检查模板参数填写是否正确，并查看控制台日志

Tip：日志 + 配置核对 + 持久化目录权限是排查问题的关键。

10. 升级容器#

升级 QD 镜像操作步骤：

1
docker compose down
2
docker compose pull
3
docker compose up -d

升级前建议备份 config 目录。

11. 总结#

通过 Docker 部署 QD 可以快速搭建自托管的签到框架，核心步骤包括：

安装 Docker 与 Compose
创建工作目录与配置目录
配置 docker-compose.yml 并启动容器
访问 Web 控制台管理模板和定时任务
持久化数据并做好备份

音乐