feat(deploy): add docker-compose with data persistence and .env support

Add docker-compose.yml with named volumes for cache/result/log,
healthcheck, and .env file support. Include .env.example template
and update README with Docker deployment instructions.

Author: X-Zero-L

.env.example

@@ -0,0 +1,41 @@
+# AutoPCR Docker Configuration
+# Copy this file to .env and modify as needed
+# cp .env.example .env
+
+# ---- Server Settings ----
+
+# HTTP server bind address (0.0.0.0 = all interfaces)
+AUTOPCR_SERVER_HOST=0.0.0.0
+
+# HTTP server port
+AUTOPCR_SERVER_PORT=13200
+
+# Enable debug logging (true/false)
+AUTOPCR_SERVER_DEBUG_LOG=false
+
+# Allow new user registration (true/false)
+AUTOPCR_SERVER_ALLOW_REGISTER=true
+
+# Superuser QQ number (has admin privileges, leave empty to disable)
+AUTOPCR_SERVER_SUPERUSER=
+
+# ---- Public Access (for QQ bot message links) ----
+
+# Public IP or domain for QQ bot to send access links
+# e.g., "example.com" or "1.2.3.4:13200"
+# Leave empty to auto-detect
+AUTOPCR_PUBLIC_ADDRESS=
+
+# Use HTTPS for public access links (true/false)
+AUTOPCR_USE_HTTPS=false
+
+# ---- Docker Settings ----
+
+# Host port to map (change if 13200 is occupied)
+HOST_PORT=13200
+
+# Container timezone
+TZ=Asia/Shanghai
+
+# Restart policy: no | always | on-failure | unless-stopped
+RESTART_POLICY=unless-stopped

README.md

@@ -25,14 +25,43 @@ python3 _httpserver_test.py
 
 渠道服需要自抓`uid`和`access_key`，作为用户名和密码。
 
+## Docker 部署
+
+```bash
+# 1. 复制环境变量模板并按需修改
+cp .env.example .env
+
+# 2. 一键启动
+docker compose up -d
+
+# 查看日志
+docker compose logs -f
+
+# 停止服务（数据不会丢失）
+docker compose down
+```
+
+数据持久化通过 Docker named volumes 实现，以下目录会被持久化保存：
+
+| 卷名 | 容器路径 | 说明 |
+|------|---------|------|
+| `autopcr_cache` | `/app/cache` | 用户账号配置、游戏数据库、session |
+| `autopcr_result` | `/app/result` | 任务执行结果 |
+| `autopcr_log` | `/app/log` | 应用日志 |
+
 ## 配置
 
-| 环境变量                          | 描述            | 默认值（留空则表示必填）     |
-|-------------------------------|---------------|------------------|
-| AUTOPCR_SERVER_PORT           | 自定义服务器启动端口    | 13200            |
-| AUTOPCR_SERVER_DEBUG_LOG      | 是否输出 Debug 日志 | False            |
-| AUTOPCR_SERVER_ALLOW_REGISTER | 是否允许注册        | True             |
-| AUTOPCR_SERVER_SUPERUSER      | 设置无条件拥有管理员的用户 | （可选，设置为登录使用的 QQ） |
+所有配置均可通过环境变量控制，Docker 部署时在 `.env` 文件中设置即可，参见 `.env.example`。
+
+| 环境变量 | 描述 | 默认值 |
+|---------|------|--------|
+| AUTOPCR_SERVER_HOST | 服务器绑定地址 | 0.0.0.0 |
+| AUTOPCR_SERVER_PORT | 服务器启动端口 | 13200 |
+| AUTOPCR_SERVER_DEBUG_LOG | 是否输出 Debug 日志 | False |
+| AUTOPCR_SERVER_ALLOW_REGISTER | 是否允许注册 | True |
+| AUTOPCR_SERVER_SUPERUSER | 设置无条件拥有管理员的用户 | （可选，设置为登录使用的 QQ） |
+| AUTOPCR_PUBLIC_ADDRESS | QQ bot 发送的公网访问地址 | （可选，留空自动检测） |
+| AUTOPCR_USE_HTTPS | 公网访问链接是否使用 HTTPS | False |
 
 ## Credits
 - aiorequests 来自 [HoshinoBot](https://github.com/Ice-Cirno/HoshinoBot)

docker-compose.yml

@@ -0,0 +1,34 @@
+services:
+  autopcr:
+    image: ghcr.io/cc004/autopcr:latest
+    container_name: autopcr
+    restart: ${RESTART_POLICY:-unless-stopped}
+    ports:
+      - "${HOST_PORT:-13200}:${AUTOPCR_SERVER_PORT:-13200}"
+    environment:
+      - AUTOPCR_SERVER_HOST=${AUTOPCR_SERVER_HOST:-0.0.0.0}
+      - AUTOPCR_SERVER_PORT=${AUTOPCR_SERVER_PORT:-13200}
+      - AUTOPCR_SERVER_DEBUG_LOG=${AUTOPCR_SERVER_DEBUG_LOG:-false}
+      - AUTOPCR_SERVER_ALLOW_REGISTER=${AUTOPCR_SERVER_ALLOW_REGISTER:-true}
+      - AUTOPCR_SERVER_SUPERUSER=${AUTOPCR_SERVER_SUPERUSER:-}
+      - AUTOPCR_PUBLIC_ADDRESS=${AUTOPCR_PUBLIC_ADDRESS:-}
+      - AUTOPCR_USE_HTTPS=${AUTOPCR_USE_HTTPS:-false}
+      - TZ=${TZ:-Asia/Shanghai}
+    volumes:
+      - autopcr_cache:/app/cache
+      - autopcr_result:/app/result
+      - autopcr_log:/app/log
+    healthcheck:
+      test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:${AUTOPCR_SERVER_PORT:-13200}/daily/login')"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+
+volumes:
+  autopcr_cache:
+    driver: local
+  autopcr_result:
+    driver: local
+  autopcr_log:
+    driver: local