Docker 部署 Qiandao (QD-Today) 自动签到平台

本文介绍如何使用 Docker Compose 快速部署 Qiandao (基于 qdtoday 社区维护版)。该配置特别优化了网络设置，集成了代理服务以确保能顺利访问 Google、Telegram 等海外站点，并配置了 GitHub 加速以便快速拉取模板。

1. 准备工作

安装好 Docker 和 Docker Compose。
准备好代理服务器（Clash/V2Ray 等），并确保开启了 “允许局域网连接” (Allow LAN) 功能。
确认你的代理服务器局域网 IP（本例中为 192.168.31.221，请根据实际情况修改）。

2. 配置文件 (`docker-compose.yml`)

新建一个目录（例如 qd），创建 docker-compose.yml 文件并填入以下内容：

yaml
version: '3.8'

services:
  qd:
    # 使用 qdtoday 维护的最新版镜像，替代已停止更新的原版
    image: qdtoday/qd:latest
    container_name: qd
    
    # 端口映射：宿主机端口 16007 -> 容器端口 80
    # 访问地址：http://IP:16007
    ports:
      - "16007:80"
    
    # 数据持久化：将数据库和配置文件保存在宿主机，防止重启丢失
    # 请确保宿主机路径 /vol1/1000/qiandao 存在且有写入权限
    volumes:
      - /vol1/1000/qiandao:/usr/src/app/config
    
    environment:
      # 设置时区为上海，确保签到日志时间正确
      - TZ=Asia/Shanghai
      
      # 开启批量推送开关
      - PUSH_BATCH_SW=True
      
      # 配置 GitHub 加速代理，解决国内无法直接拉取公共模板库的问题
      - SUBSCRIBE_ACCELERATE_URL=https://ghfast.top/https://raw.githubusercontent.com
      
      # --- 代理配置 (关键) ---
      # 指向局域网内的代理服务器 IP 和端口
      # 注意：不要填 127.0.0.1，因为容器内的 localhost 并不是宿主机
      - HTTP_PROXY=http://192.168.31.221:20171
      - HTTPS_PROXY=http://192.168.31.221:20171
      
      # 设置不走代理的地址，防止容器内部通信或局域网通信异常
      - NO_PROXY=localhost,127.0.0.1,172.17.0.0/16
    
    # 容器崩溃或重启后自动重新启动
    restart: unless-stopped

3. 启动服务

在终端进入该文件所在目录，运行以下命令：

bash
# 启动容器并在后台运行
docker-compose up -d

# 查看运行日志（排查报错用）
docker-compose logs -f qd

4. 初始化设置

访问平台：打开浏览器访问 http://你的服务器IP:16007。
注册管理员：你需要注册第一个账号，该账号将自动获得管理员权限。请务必第一时间完成此步骤。
测试网络：登录后，进入“公共模板”，尝试点击“更新”或拉取一个需要翻墙的网站模板，如果速度正常且无报错，说明 HTTP_PROXY 配置生效。

⚠️ 注意事项

代理 IP：请务必将 192.168.31.221 替换为你自己宿主机的真实局域网 IP。
权限问题：如果启动报错 Permission denied，请检查挂载目录 /vol1/1000/qiandao 的权限，可以使用 chmod 777 /vol1/1000/qiandao 快速修复。