| # ccLoad Docker 环境配置示例 | |
| # 复制此文件为 .env 并根据需要修改配置 | |
| # ======================================== | |
| # 核心配置（必需） | |
| # ======================================== | |
| # 管理后台密码（必需，未设置将导致程序退出） | |
| CCLOAD_PASS=your_secure_admin_password | |
| # API 访问令牌可通过 Web 管理界面动态配置，也可在启动时预置 | |
| # 访问 http://localhost:8080/web/tokens.html 进行令牌管理 | |
| # 格式：token 或 token|描述，多个令牌用英文逗号分隔；已存在的 token 不会被覆盖 | |
| # CCLOAD_API_TOKENS=token1|production,token2|development | |
| # ======================================== | |
| # 数据库配置 | |
| # ======================================== | |
| # 数据库文件路径（容器内路径，通常不需要修改） | |
| SQLITE_PATH=/app/data/ccload.db | |
| # MySQL DSN（可选，设置后启用 MySQL 存储） | |
| # 格式: user:password@tcp(host:port)/dbname?charset=utf8mb4&parseTime=True&loc=Local | |
| # 示例: CCLOAD_MYSQL=root:password@tcp(mysql:3306)/ccload?charset=utf8mb4&parseTime=True&loc=Local | |
| # 混合存储模式（可选，默认: 0） | |
| # 需要同时设置 CCLOAD_MYSQL 和此变量为 1 | |
| # 混合模式：MySQL 作为主存储，SQLite 作为本地缓存（适用于 HuggingFace Spaces 等场景） | |
| # CCLOAD_ENABLE_SQLITE_REPLICA=1 | |
| # 混合模式日志恢复天数（可选，默认: 7） | |
| # 启动时从 MySQL 恢复多少天的日志到 SQLite | |
| # -1=全量恢复，0=不恢复日志 | |
| # CCLOAD_SQLITE_LOG_DAYS=7 | |
| # SQLite Journal 模式（可选，默认: WAL） | |
| # 可选值: WAL | DELETE | TRUNCATE | PERSIST | MEMORY | OFF | |
| # - WAL（默认）：Write-Ahead Logging，高性能，适合本地文件系统 | |
| # - TRUNCATE：传统回滚日志，适合 Docker/K8s 环境或网络存储（NFS等） | |
| # - DELETE：与 TRUNCATE 类似，但删除日志文件而非截断 | |
| # ⚠️ 容器环境建议：SQLITE_JOURNAL_MODE=TRUNCATE（避免WAL文件损坏风险） | |
| # SQLITE_JOURNAL_MODE=TRUNCATE | |
| # ======================================== | |
| # 网络配置 | |
| # ======================================== | |
| # HTTP 服务端口（容器内端口，通常不需要修改） | |
| PORT=8080 | |
| # ======================================== | |
| # 安全配置 | |
| # ======================================== | |
| # 禁用上游 TLS 证书校验（可选，默认: 0） | |
| # ⚠️ 仅用于临时排障或受控内网环境，生产环境严禁启用 | |
| # CCLOAD_ALLOW_INSECURE_TLS=0 | |
| # ======================================== | |
| # 性能优化配置 | |
| # ======================================== | |
| # 最大并发请求数（可选，默认: 1000） | |
| # 限制同时处理的代理请求数量，防止goroutine爆炸 | |
| # CCLOAD_MAX_CONCURRENCY=1000 | |
| # 请求体最大字节数（可选，默认: 10485760，即 10MB） | |
| # 限制单个API请求体的大小，防止大包打爆内存 | |
| # CCLOAD_MAX_BODY_BYTES=10485760 | |
| # ======================================== | |
| # 运行模式配置 | |
| # ======================================== | |
| # Gin 运行模式（release/debug） | |
| GIN_MODE=release | |
| # ======================================== | |
| # 系统配置（已迁移到 Web 管理界面） | |
| # ======================================== | |
| # 以下配置项已迁移到数据库，通过 Web 界面管理，支持热重载： | |
| # - 日志保留天数 (log_retention_days) | |
| # - 单渠道最大Key重试次数 (max_key_retries) | |
| # - 上游首字节超时 (upstream_first_byte_timeout) | |
| # | |
| # 访问 http://localhost:8080/web/settings.html 进行配置管理 | |