feat: 添加可选的代理功能支持

新增功能:
- 集成 Cloudflare WARP socks5 代理服务
- 通过环境变量 USE_PROXY 控制代理开关
- 支持自定义 HTTP/HTTPS/SOCKS5 代理服务器
- 使用 docker compose profile 管理 proxy 服务

配置方式:
- USE_PROXY=true 启用代理
- ALL_PROXY/HTTP_PROXY/HTTPS_PROXY 自定义代理
- docker compose --profile proxy up 启动 warp 服务

文件变更:
- docker-compose.yaml: 添加 warp-proxy 服务
- playwright-auth.ts: 添加代理配置逻辑
- example.env: 添加代理环境变量
- PROXY.md: 使用文档

PROXY.md

@@ -0,0 +1,158 @@
+# DSAS CCA Backend - Proxy Configuration
+
+## 代理功能说明
+
+本应用支持可选的代理配置，用于绕过网络限制访问 engage.nkcswx.cn。
+
+## 使用 Cloudflare WARP 代理
+
+### 1. 启动带代理的服务
+
+```bash
+# 启动包含 warp-proxy 的服务
+docker compose --profile proxy up -d
+```
+
+### 2. 配置环境变量
+
+在 `.env` 文件中设置：
+
+```bash
+# 启用代理
+USE_PROXY=true
+
+# 使用 warp-proxy 服务（默认配置，无需修改）
+# 或者自定义代理服务器
+ALL_PROXY=socks5://warp-proxy:9091
+```
+
+### 3. 验证代理工作
+
+```bash
+# 查看日志确认代理已启用
+docker compose logs -f app | grep "Using proxy"
+```
+
+## 使用自定义代理服务器
+
+### HTTP/HTTPS 代理
+
+```bash
+USE_PROXY=true
+HTTP_PROXY=http://your-proxy:8080
+HTTPS_PROXY=http://your-proxy:8080
+```
+
+### SOCKS5 代理
+
+```bash
+USE_PROXY=true
+ALL_PROXY=socks5://your-proxy:1080
+```
+
+### 需要认证的代理
+
+```bash
+USE_PROXY=true
+ALL_PROXY=socks5://username:password@your-proxy:1080
+```
+
+## 环境变量说明
+
+| 变量名 | 说明 | 默认值 |
+|--------|------|--------|
+| `USE_PROXY` | 是否启用代理 | `false` |
+| `ALL_PROXY` | 通用代理服务器 | - |
+| `HTTP_PROXY` | HTTP 代理服务器 | - |
+| `HTTPS_PROXY` | HTTPS 代理服务器 | - |
+
+## Warp Proxy 服务配置
+
+### 启动 Warp 服务
+
+```bash
+# 单独启动 warp-proxy
+docker compose --profile proxy up warp-proxy
+
+# 查看所有服务（包括 warp-proxy）
+docker compose --profile ps
+```
+
+### Warp 服务端口
+
+- **内部端口**: 9091 (SOCKS5 + HTTP 混合模式)
+- **访问方式**: `socks5://warp-proxy:9091`
+
+### 自定义 Warp 配置
+
+可以在 `docker-compose.yaml` 中添加环境变量：
+
+```yaml
+warp-proxy:
+  image: ghcr.io/mon-ius/docker-warp-socks:v5
+  environment:
+    # 自定义 Warp 配置
+    # WARP_MODE=premium  # 如果需要 premium 模式
+```
+
+## 故障排除
+
+### 代理未生效
+
+1. 检查 `USE_PROXY=true` 是否已设置
+2. 确认 warp-proxy 服务正在运行：
+   ```bash
+   docker compose ps
+   ```
+3. 查看应用日志：
+   ```bash
+   docker compose logs app | grep proxy
+   ```
+
+### Warp 连接失败
+
+1. 检查网络连接
+2. 重启 warp-proxy 服务：
+   ```bash
+   docker compose --profile proxy restart warp-proxy
+   ```
+3. 查看 warp 日志：
+   ```bash
+   docker compose logs warp-proxy
+   ```
+
+### 性能问题
+
+如果代理导致请求变慢：
+
+1. 考虑关闭代理（如果不需要）：
+   ```bash
+   USE_PROXY=false
+   ```
+2. 或者使用更快的代理服务器
+
+## 不启用代理的使用
+
+默认情况下代理是关闭的。正常使用：
+
+```bash
+# 正常启动（不使用代理）
+docker compose up -d
+
+# 或者明确指定不使用代理
+USE_PROXY=false docker compose up -d
+```
+
+## 注意事项
+
+1. **首次启动**: 如果使用代理，首次启动可能会慢一些，因为需要建立 Warp 连接
+2. **cookies 刷新**: 启用代理后，建议重新获取 cookies：
+   ```bash
+   docker exec dsas-cca-backend bun run test/get-cookies.ts
+   ```
+3. **网络要求**: Warp 需要访问 Cloudflare 服务器，确保网络可达
+
+## 参考
+
+- [Docker Warp Socks GitHub](https://github.com/Mon-ius/Docker-Warp-Socks)
+- [Docker Hub](https://hub.docker.com/r/monius/docker-warp-socks)