Docker-QD(自动签到)

**相关链接：**
- QD：https://qd-today.github.io/qd/zh_CN/
- 官方文档：https://qd-today.github.io/qd/zh_CN/guide/what-is-qd.html
- GitHub：https://github.com/qd-today/qd/
- Docker：https://hub.docker.com/r/qdtoday/qd
- 官方手册：https://www.quchao.net/QianDaoEXP.html
- 公共模板：https://github.com/qd-today/templates
- HAR分析器：https://toolbox.googleapps.com/apps/har_analyzer/?lang=zh_CN

## Docker 版
```bash
docker run -d --name qd -p 8923:80 -v $(pwd):/usr/src/app/config qdtoday/qd
  # 若容器内部无法访问外部网络,尝试使用 Host模式创建容器,修改端口号8923(否则默认80)
  docker run -d --name qd --env PORT=8923 --net=host -v $(pwd):/usr/src/app/config qdtoday/qd
  # 注意: 使用该命令创建容器后, 请将模板里 http://localhost/ 形式的 api 请求, 手动改成 api:// 或 http://localhost:8923/ 后, 才能正常完成相关API请求。

# 支持邮箱通知
  docker run -d --name qd -p 8923:80 -v $(pwd):/usr/src/app/config --env MAIL_SMTP=STMP服务器 --env MAIL_PORT=邮箱服务器端口 --env MAIL_USER=用户名 --env MAIL_PASSWORD=密码 --env DOMAIN=域名 qdtoday/qd

# 更新QD
docker exec -it qd /bin/sh
wget https://gitee.com/qd-today/qd/raw/master/update.sh -O /usr/src/app/update.sh && \
sh /usr/src/app/update.sh
```

## ⭐docker-compose 版
```bash
mkdir {config,redis}  # 创建所需文件夹
wget https://fastly.jsdelivr.net/gh/qd-today/qd@master/docker-compose.yml  # 下载官方docker-compose.yml
nano docker-compose.yml  # 可以直接使用我添加注释的
docker-compose up -d  # 部署并启动服务

# 更新QD
docker-compose pull && \
docker-compose up -d
```
`docker-compose.yml` 对官方提供的 [docker-compose.yml](https://fastly.jsdelivr.net/gh/qd-today/qd@master/docker-compose.yml) 进行详细注释,并启用常用配置
```yaml
version: "3"
services:
  qd:
    image: qdtoday/qd:latest  # 使用最新版本的QD镜像
    # image: qdtoday/qd:lite-latest  # 使用精简版QD镜像（去除OCR功能）
    # image: qdtoday/qd:dev  # 使用开发版QD镜像
    #container_name: qd  # 容器名称为qd
    depends_on:
      - redis  # 依赖redis服务
    ports:
      - "8923:80"  # 将容器内的80端口映射到主机的8923端口
    volumes:
      - "./config:/usr/src/app/config"  # 将本地的config目录映射到容器内的/usr/src/app/config目录
    environment:
      # - QD_DEBUG=False  # 是否启用Debug模式
      # - BIND=0.0.0.0  # 监听地址
      # - PORT=80  # 监听端口(更改端口后 http://localhost/ 形式的 api请求,需改成 api:// 或 http://localhost:<新端口>/ 形式,才能正常完成相关API请求)
      # - EVIL_PASS_LAN_IP=True  # 是否允许内网IP通过
      # - MULTI_PROCESS=False  # 任务定时执行方式,(实验性)是否启用多进程模式,Windows平台无效
      # - AUTO_RELOAD=False  # 是否启用自动热加载,MULTI_PROCESS=True 时无效

- DOMAIN=nas.918178.xyz:8923  # 指定访问域名,(建议修改),否则通过邮件重置密码及邮箱推送等功能无效
      - MAIL_SMTP=smtp.qq.com  # 邮箱 SMTP 服务器
      - MAIL_PORT=587  # 邮箱 SMTP 服务器端口
      - MAIL_SSL=True  # 是否启用邮箱 SSL
      - MAIL_USER=773203918@qq.com  # 邮箱用户名
      - MAIL_PASSWORD=xxx  # 邮箱密码
      - MAIL_FROM=773203918@qq.com  # 发送邮件的邮箱地址
      #- MAIL_DOMAIN_HTTPS=True  # 邮件域名是否使用 HTTPS(若是https则要启用)
      # - MAIL_STARTTLS=False  # 是否启用邮箱 STARTTLS

- COOKIE_SECRET=zwzw  # cookie加密密钥,(强烈建议修改)
      - PBKDF2_ITERATIONS=400  # PBKDF2迭代次数
      - AES_KEY=zwzw  # AES加密密钥,(强烈建议修改)
      # - COOKIE_DAY=5  # Cookie在客户端中保留的天数
      # - COOKIE_SECURE_MODE=False  # 是否启用Cookie安全模式
      # - DISPLAY_IMPORT_WARNING=True  # 是否显示导入警告
      # - USER0ISADMIN=True  # 用户0是否为管理员

- REDISCLOUD_URL=redis://redis:6379  # Redis连接URL
      # - REDIS_DB_INDEX=1  # Redis数据库索引

# - DB_TYPE=sqlite3  # 数据库类型,默认 sqlite3/mysql
      # - JAWSDB_MARIA_URL=mysql://user:pass@localhost:3306/dbname?auth_plugin=  # 需要使用MySQL时,设置为(mysql://用户名:密码@hostname:port/数据库名?auth_plugin=)
      # - QD_SQL_LOGGING_NAME=QD.sql  # SQLAlchmey 日志名称
      # - QD_SQL_LOGGING_LEVEL=WARNING  # SQLAlchmey 日志级别
      # - QD_SQL_POOL_LOGGING_NAME=QD.sql.pool  # SQLAlchmey 连接池日志名称
      # - QD_SQL_POOL_LOGGING_LEVEL=WARNING  # SQLAlchmey 连接池日志级别
      # - QD_SQL_POOL_SIZE=5  # SQLAlchmey 连接池大小
      # - QD_SQL_MAX_OVERFLOW=10  # SQLAlchmey 连接池最大溢出
      # - QD_SQL_POOL_PRE_PING=True  # 是否预检查连接
      # - QD_SQL_POOL_RECYCLE=3600  # 连接池回收时间
      # - QD_SQL_POOL_TIMEOUT=30  # 连接池超时时间
      # - QD_SQL_POOL_USE_LIFO=True  # 是否使用后进先出的连接池

# - GZIP=True  # 是否启用GZIP压缩
      # - ACCESS_LOG=True  # 是否记录访问日志
      # - STATIC_URL_PREFIX=/static/  # 静态文件URL前缀
      # - QD_EVIL=1000  # 恶意请求的阈值

# - WORKER_METHOD=Queue  # 任务定时执行方式,默认 Queue,Batch 性能弱(不推荐,Queue无效再使用)
      # - QUEUE_NUM=50  # 队列数量
      # - CHECK_TASK_LOOP=500  # 检查任务循环时间间隔
      # - TASK_MAX_RETRY_COUNT=8  # 任务最大重试次数
      # - NEW_TASK_DELAY=1  # 新任务延迟时间
      # - TASK_WHILE_LOOP_TIMEOUT=900  # 任务循环超时时间
      # - TASK_REQUEST_LIMIT=1500  # 任务请求限制
      # - DOWNLOAD_SIZE_LIMIT=5242880  # 下载文件大小限制
      # - REQUEST_TIMEOUT=30.0  # 请求超时时间
      # - CONNECT_TIMEOUT=30.0  # 连接超时时间
      # - DELAY_MAX_TIMEOUT=29.9  # 最大延迟超时时间
      # - UNSAFE_EVAL_TIMEOUT=3.0  # 不安全的求值超时时间
      # - USE_PYCURL=True  # 是否使用pycurl进行请求
      # - ALLOW_RETRY=True  # 是否允许重试请求
      # - DNS_SERVER=  # 自定义DNS服务器
      # - CURL_ENCODING=True  # 是否使用CURL进行编码
      # - CURL_CONTENT_LENGTH=True  # 是否启用 Curl Content-Length 请求头

# - NOT_RETRY_CODE=301|302|303|304|305|307|400|401|403|404|405|407|408|409|410|412|415|413|414|500|501|502|503|504|599  # 不重试的 HTTP 状态码列表
      # - EMPTY_RETRY=True  # 是否允许空重试
      # - TRACEBACK_PRINT=False  # 是否在控制台打印异常的 TraceBack 信息
      # - PUSH_PIC_URL=https://gitee.com/qd-today/qd/raw/master/web/static/img/push_pic.png  # 推送图片的 URL
      # - PUSH_BATCH_SW=True  # 是否允许开启推送批量开关
      # - PUSH_BATCH_DELTA=60  # 推送批量时间间隔

# - WS_PING_INTERVAL=5  # WebSocket ping 间隔时间，单位为秒
      # - WS_PING_TIMEOUT=30  # WebSocket ping 超时时间，单位为秒
      # - WS_MAX_MESSAGE_SIZE=10485760  # WebSocket 单次接收最大消息大小，单位为字节
      # - WS_MAX_QUEUE_SIZE=100  # WebSocket 最大消息队列大小
      # - WS_MAX_CONNECTIONS_SUBSCRIBE=30  # WebSocket 公共模板更新页面最大连接数

# - SUBSCRIBE_ACCELERATE_URL=jsdelivr_cdn  # 订阅加速方式或地址
      # - PROXIES=  # 全局代理域名列表
      # - PROXY_DIRECT_MODE=  # 全局代理黑名单模式
      # - PROXY_DIRECT=  # 全局代理黑名单匹配规则
      # - NOTEPAD_LIMIT=20  # 单个用户拥有记事本的最大数量
      # - EXTRA_ONNX_NAME=  # 额外的 ONNX 文件名
      # - EXTRA_CHARSETS_NAME=  # 额外的字符集文件名
      # - MAILGUN_KEY=  # Mailgun API 密钥
      # - MAILGUN_DOMAIN=  # Mailgun 域名
      # - GA_KEY=  # Google Analytics 密钥
    restart: always

redis:
    image: redis:alpine
    #container_name: redis
    command: ["--loglevel warning"]
    # command: redis-server /usr/local/etc/redis/redis.conf
    volumes:
      # - ./redis/redis.conf:/usr/local/etc/redis/redis.conf:rw
      - ./redis:/data:rw
    restart: always
```

### NginxUI 反向代理
`docker-compose.yml`
```yaml
version: "3"
services:
  qd:
    image: qdtoday/qd:latest  # 使用最新版本的QD镜像
    # image: qdtoday/qd:lite-latest  # 使用精简版QD镜像（去除OCR功能）
    # image: qdtoday/qd:dev  # 使用开发版QD镜像
    container_name: qd_qd  # 容器名称
    # depends_on:
    #   - redis  # 依赖redis服务
    #expose:  # 开放给内部调用
    #  - "80"
    #ports:  # 使用Nginx反代
    #  - "8923:80"  # 将容器内的80端口映射到主机的8923端口
    volumes:
      - ./config:/usr/src/app/config  # 将本地的config目录映射到容器内的/usr/src/app/config目录
    environment:
      # - QD_DEBUG=False  # 是否启用Debug模式
      # - BIND=0.0.0.0  # 监听地址
      # - PORT=80  # 监听端口(更改端口后 http://localhost/ 形式的 api请求,需改成 api:// 或 http://localhost:<新端口>/ 形式,才能正常完成相关API请求)
      # - EVIL_PASS_LAN_IP=True  # 是否允许内网IP通过
      # - MULTI_PROCESS=False  # 任务定时执行方式,(实验性)是否启用多进程模式,Windows平台无效
      # - AUTO_RELOAD=False  # 是否启用自动热加载,MULTI_PROCESS=True 时无效

- DOMAIN=qd.918178.xyz:8443  # 指定访问域名,(建议修改),否则通过邮件重置密码及邮箱推送等功能无效
      - MAIL_SMTP=smtp.qq.com  # 邮箱 SMTP 服务器
      - MAIL_PORT=587  # 邮箱 SMTP 服务器端口
      - MAIL_SSL=True  # 是否启用邮箱 SSL
      - MAIL_USER=ai773203918@qq.com  # 邮箱用户名
      - MAIL_PASSWORD=xxx  # 邮箱密码
      - MAIL_FROM=ai773203918@qq.com  # 发送邮件的邮箱地址
      - MAIL_DOMAIN_HTTPS=True  # 邮件域名是否使用 HTTPS(若是https代理则启用)
      # - MAIL_DOMAIN_HTTPS=False  # 邮件域名是否使用 HTTPS

- COOKIE_SECRET=zwzw  # cookie加密密钥,(强烈建议修改)
      - PBKDF2_ITERATIONS=400  # PBKDF2迭代次数
      - AES_KEY=zwzw  # AES加密密钥,(强烈建议修改)
      # - COOKIE_DAY=5  # Cookie在客户端中保留的天数
      # - COOKIE_SECURE_MODE=False  # 是否启用Cookie安全模式
      # - DISPLAY_IMPORT_WARNING=True  # 是否显示导入警告
      # - USER0ISADMIN=True  # 用户0是否为管理员

# - REDISCLOUD_URL=redis://redis:6379  # Redis连接URL,如果出现更新模板失败尝试禁用
      # - REDIS_DB_INDEX=1  # Redis数据库索引

# - DB_TYPE=sqlite3  # 数据库类型,默认 sqlite3/mysql
      # - JAWSDB_MARIA_URL=mysql://user:pass@localhost:3306/dbname?auth_plugin=  # 需要使用MySQL时,设置为(mysql://用户名:密码@hostname:port/数据库名?auth_plugin=)
      # - QD_SQL_LOGGING_NAME=QD.sql  # SQLAlchmey 日志名称
      # - QD_SQL_LOGGING_LEVEL=WARNING  # SQLAlchmey 日志级别
      # - QD_SQL_POOL_LOGGING_NAME=QD.sql.pool  # SQLAlchmey 连接池日志名称
      # - QD_SQL_POOL_LOGGING_LEVEL=WARNING  # SQLAlchmey 连接池日志级别
      # - QD_SQL_POOL_SIZE=5  # SQLAlchmey 连接池大小
      # - QD_SQL_MAX_OVERFLOW=10  # SQLAlchmey 连接池最大溢出
      # - QD_SQL_POOL_PRE_PING=True  # 是否预检查连接
      # - QD_SQL_POOL_RECYCLE=3600  # 连接池回收时间
      # - QD_SQL_POOL_TIMEOUT=30  # 连接池超时时间
      # - QD_SQL_POOL_USE_LIFO=True  # 是否使用后进先出的连接池

# - GZIP=True  # 是否启用GZIP压缩
      # - ACCESS_LOG=True  # 是否记录访问日志
      # - STATIC_URL_PREFIX=/static/  # 静态文件URL前缀
      # - QD_EVIL=1000  # 恶意请求的阈值

# - WORKER_METHOD=Queue  # 任务定时执行方式,默认 Queue,Batch 性能弱(不推荐,Queue无效再使用)
      # - QUEUE_NUM=50  # 队列数量
      # - CHECK_TASK_LOOP=500  # 检查任务循环时间间隔
      # - TASK_MAX_RETRY_COUNT=8  # 任务最大重试次数
      # - NEW_TASK_DELAY=1  # 新任务延迟时间
      # - TASK_WHILE_LOOP_TIMEOUT=900  # 任务循环超时时间
      # - TASK_REQUEST_LIMIT=1500  # 任务请求限制
      # - DOWNLOAD_SIZE_LIMIT=5242880  # 下载文件大小限制
      # - REQUEST_TIMEOUT=30.0  # 请求超时时间
      # - CONNECT_TIMEOUT=30.0  # 连接超时时间
      # - DELAY_MAX_TIMEOUT=29.9  # 最大延迟超时时间
      # - UNSAFE_EVAL_TIMEOUT=3.0  # 不安全的求值超时时间
      # - USE_PYCURL=True  # 是否使用pycurl进行请求
      # - ALLOW_RETRY=True  # 是否允许重试请求
      # - DNS_SERVER=  # 自定义DNS服务器
      # - CURL_ENCODING=True  # 是否使用CURL进行编码
      # - CURL_CONTENT_LENGTH=True  # 是否启用 Curl Content-Length 请求头

# - NOT_RETRY_CODE=301|302|303|304|305|307|400|401|403|404|405|407|408|409|410|412|415|413|414|500|501|502|503|504|599  # 不重试的 HTTP 状态码列表
      # - EMPTY_RETRY=True  # 是否允许空重试
      # - TRACEBACK_PRINT=False  # 是否在控制台打印异常的 TraceBack 信息
      # - PUSH_PIC_URL=https://gitee.com/qd-today/qd/raw/master/web/static/img/push_pic.png  # 推送图片的 URL
      # - PUSH_BATCH_SW=True  # 是否允许开启推送批量开关
      # - PUSH_BATCH_DELTA=60  # 推送批量时间间隔

# - WS_PING_INTERVAL=5  # WebSocket ping 间隔时间，单位为秒
      # - WS_PING_TIMEOUT=30  # WebSocket ping 超时时间，单位为秒
      # - WS_MAX_MESSAGE_SIZE=10485760  # WebSocket 单次接收最大消息大小，单位为字节
      # - WS_MAX_QUEUE_SIZE=100  # WebSocket 最大消息队列大小
      # - WS_MAX_CONNECTIONS_SUBSCRIBE=30  # WebSocket 公共模板更新页面最大连接数

# - SUBSCRIBE_ACCELERATE_URL=jsdelivr_cdn  # 订阅加速方式或地址
      # - PROXIES=  # 全局代理域名列表
      # - PROXY_DIRECT_MODE=  # 全局代理黑名单模式
      # - PROXY_DIRECT=  # 全局代理黑名单匹配规则
      # - NOTEPAD_LIMIT=20  # 单个用户拥有记事本的最大数量
      # - EXTRA_ONNX_NAME=  # 额外的 ONNX 文件名
      # - EXTRA_CHARSETS_NAME=  # 额外的字符集文件名
      # - MAILGUN_KEY=  # Mailgun API 密钥
      # - MAILGUN_DOMAIN=  # Mailgun 域名
      # - GA_KEY=  # Google Analytics 密钥
    restart: always
    networks:
      - default
      - nginxui_default  # 加入nginx容器所在网络(仅需要反向代理的容器需要加入)

# 如果出现更新模板失败尝试禁用
  # redis:
  #   image: redis:alpine
  #   container_name: qd_redis
  #   command: ["--loglevel warning"]
  #   # command: redis-server /usr/local/etc/redis/redis.conf
  #   volumes:
  #     # - ./redis/redis.conf:/usr/local/etc/redis/redis.conf:rw
  #     - ./redis:/data:rw
  #   restart: always
  #   networks:
  #     - default
  #     # - nginxui_default  # 加入nginx容器所在网络

# 独立的 nginx(这里使用其他nginx代理故禁用)
  # nginx:
  #   image: nginx
  #   container_name: qd_Nginx
  #   ports:
  #     - '8923:8923'
  #   volumes:
  #     - ./nginx.conf:/etc/nginx/nginx.conf  # Nginx配置文件
  #     - ./key:/etc/nginx/key  # SSL路径
  #     #- .passwd:/etc/nginx/.passwd  # 密码文件路径
  #   depends_on:
  #     - qd  # 等待 qd 启动后再启动
  #   restart: always

# 加入nginx容器所在网络(否则无法使用nginx代理)
networks:
  nginxui_default:
    external: true  # 使用已存在的网络
    name: nginxui_default  # 使用名为 nginx 的网络
```
`NginxUI 配置`，需要设置  WebSocket、外部访问域名+端口 以解决 [Nginx 反代跨域](https://github.com/qd-today/qd/issues/467)
```bash
# QD 自动签到(必须要主路径,子路径功能有问题)
server {
    listen 8443 ssl;
    server_name qd.918178.xyz;  # 监听域名
    ssl_certificate /etc/nginx/ssl/*.918178.xyz_918178.xyz/fullchain.cer;
    ssl_certificate_key /etc/nginx/ssl/*.918178.xyz_918178.xyz/private.key;
    error_page 497 =307 https://$host:$server_port$request_uri;  # http自动转https
    # QD 必须从根/开始
    location / {
        proxy_pass http://qd_qd;
        # WebSocket 关键配置
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        #其他可选配置
        proxy_set_header  Host $host;
        proxy_set_header  X-Real-IP  $remote_addr;
        proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header  X-Forwarded-Proto  $scheme;
    }
}
```

### Nginx 反向代理(独立部署)
`docker-compose.yml`
```yaml
version: "3"
services:
  qd:
    image: qdtoday/qd:latest  # 使用最新版本的QD镜像
    # image: qdtoday/qd:lite-latest  # 使用精简版QD镜像（去除OCR功能）
    # image: qdtoday/qd:dev  # 使用开发版QD镜像
    #container_name: qd_qd  # 容器名称
    depends_on:
      - redis  # 依赖redis服务
    # ports:  # 使用Nginx反代
    #   - "8923:80"  # 将容器内的80端口映射到主机的8923端口
    volumes:
      - "./config:/usr/src/app/config"  # 将本地的config目录映射到容器内的/usr/src/app/config目录
    environment:
      #- QD_DEBUG=False  # 是否启用Debug模式
      # - BIND=0.0.0.0  # 监听地址
      # - PORT=80  # 监听端口(更改端口后 http://localhost/ 形式的 api请求,需改成 api:// 或 http://localhost:<新端口>/ 形式,才能正常完成相关API请求)
      # - EVIL_PASS_LAN_IP=True  # 是否允许内网IP通过
      # - MULTI_PROCESS=False  # 任务定时执行方式,(实验性)是否启用多进程模式,Windows平台无效
      # - AUTO_RELOAD=False  # 是否启用自动热加载,MULTI_PROCESS=True 时无效

- DOMAIN=blynk.space:8923  # 指定访问域名,(建议修改),否则通过邮件重置密码及邮箱推送等功能无效
      - MAIL_SMTP=smtp.qq.com  # 邮箱 SMTP 服务器
      - MAIL_PORT=587  # 邮箱 SMTP 服务器端口
      - MAIL_SSL=True  # 是否启用邮箱 SSL
      - MAIL_USER=ai773203918@qq.com  # 邮箱用户名
      - MAIL_PASSWORD=xxx  # 邮箱密码
      - MAIL_FROM=ai773203918@qq.com  # 发送邮件的邮箱地址
      - MAIL_DOMAIN_HTTPS=True  # 邮件域名是否使用 HTTPS(若是https代理则启用)
      # - MAIL_DOMAIN_HTTPS=False  # 邮件域名是否使用 HTTPS