# ccLoad Docker 环境配置示例
# 复制此文件为 .env 并根据需要修改配置

# ========================================
# 核心配置（必需）
# ========================================

# 管理后台密码（必需，未设置将导致程序退出）
# ⚠️ 密码含 $ 时必须用单引号包裹，例如 CCLOAD_PASS='abc$def'
#    不加引号会被 Docker Compose 当作变量插值，导致密码被截断
CCLOAD_PASS=your_secure_admin_password

# API 访问令牌可通过 Web 管理界面动态配置，也可在启动时预置
# 访问 http://localhost:8080/web/tokens.html 进行令牌管理
# 格式：token 或 token|描述，多个令牌用英文逗号分隔；已存在的 token 不会被覆盖
# CCLOAD_API_TOKENS=token1|production,token2|development

# ========================================
# 时区配置
# ========================================

# 容器时区（可选，默认: UTC）
# 镜像已内置 tzdata，设置此变量即可生效
TZ=Asia/Shanghai

# ========================================
# 数据库配置
# ========================================

# 数据库文件路径（容器内路径，通常不需要修改）
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

# 混合模式 SQLite 空库日志导入天数（可选，默认: 7）
# 后续启动只导入晚于 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

# ========================================
# 性能优化配置
# ========================================

# 并发上限、请求体上限与冷却时长已迁移到 Web 系统设置（数据库存储）：
#   max_concurrency / max_body_bytes / max_image_body_bytes
#   cooldown_auth_seconds / cooldown_server_seconds / cooldown_timeout_seconds
#   cooldown_rate_limit_seconds / cooldown_min_seconds / cooldown_max_seconds
# 对应的 CCLOAD_MAX_CONCURRENCY / CCLOAD_MAX_BODY_BYTES / CCLOAD_COOLDOWN_* 环境变量已废弃且不再生效。

# ========================================
# 运行模式配置
# ========================================

# Gin 运行模式（release/debug）
GIN_MODE=release

# Claude Code CLI 版本同步（可选，默认: true）
# 每小时从 GitHub 拉取最新 Claude Code 版本，作为 Anthropic OAuth 请求指纹的版本下限；
# 设为 false 关闭同步（如容器无法访问 GitHub），仅使用内置版本与已缓存版本
# CCLOAD_ANTHROPIC_CLI_VERSION_SYNC=true

# Claude Code CLI 版本缓存路径（可选，默认: /app/data/anthropic-cli-version.json）
# 须位于持久化卷内，否则容器重建后回落到内置版本
# CCLOAD_ANTHROPIC_CLI_VERSION_CACHE=/app/data/anthropic-cli-version.json

# ========================================
# 系统配置（已迁移到 Web 管理界面）
# ========================================
# 以下配置项已迁移到数据库，通过 Web 界面管理（保存后自动重启生效）：
# - 日志保留天数 (log_retention_days)
# - 单渠道最大Key重试次数 (max_key_retries)
# - 上游首字节超时 (upstream_first_byte_timeout)
#
# 访问 http://localhost:8080/web/settings.html 进行配置管理