# ============================================================ # Codex2API Docker 环境变量配置 # 复制此文件为 .env 并修改对应值 # ============================================================ # HTTP 服务端口 # Note: the standard compose files bind to all interfaces (0.0.0.0). # Set BIND_HOST=127.0.0.1 in .env to restrict to localhost only. # BIND_HOST=0.0.0.0 CODEX_PORT=8080 # 监听地址(默认 0.0.0.0,兼容 Docker 端口映射 / 反向代理 / 公网部署) # 如希望仅本机访问,可设置为 127.0.0.1 # CODEX_BIND=0.0.0.0 # 管理后台登录密钥 # - 未设置时,首次访问 /admin 会进入“首次初始化”页面,请在浏览器内设置一个强随机密钥并妥善保存 # - 未初始化之前,所有 /api/admin/* 接口(除 bootstrap 端点外)均返回 503 # - 如需以环境变量方式下发(如 CI/CD),可取消下面设置后重启,环境变量优先于浏览器初始化 # ADMIN_SECRET=your-admin-password # /v1/* 匿名访问开关(默认 false,强烈建议保持默认) # 设置为 true 时:未配置任何对外 API Key 也允许 /v1/* 直接调用——仅限内网测试场景! # CODEX_ALLOW_ANONYMOUS=false # 可信反向代理 CIDR/IP(影响 X-Forwarded-For / X-Real-IP 真实客户端 IP 解析) # 默认信任本机回环与常见私有网段,兼容同机或 Docker 部署的雷池 WAF / Nginx / Caddy -> Codex2API。 # 如需收紧范围,请改成实际前置代理 IP/CIDR;设为 none 可完全禁用代理头。 # CODEX_TRUSTED_PROXIES=127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16 # 全局代理(可选) # CODEX_PROXY_URL=http://host.docker.internal:7890 # Codex 上游传输:默认 http;可设 ws 强制使用 WebSocket;auto 在 HTTP 入站下仍走 http # CODEX_UPSTREAM_TRANSPORT=http # 旧版 WebSocket 开关(兼容保留;推荐改用 CODEX_UPSTREAM_TRANSPORT=ws) # USE_WEBSOCKET=true # Codex HTTP TLS 指纹:默认 standard;如需回滚旧行为可设 utls_chrome # CODEX_TRANSPORT_MODE=standard # WS 握手默认不发送 User-Agent/Version;如需回滚旧行为可设 true # CODEX_WS_SEND_USER_AGENT=false # Codex 会话黏性 TTL,支持 Go duration(如 1h、90m)或秒数 # CODEX_SESSION_AFFINITY_TTL=1h # 脱敏输出 Codex 指纹策略诊断日志 # CODEX_FINGERPRINT_DEBUG=false # 快速调度器(可选,也可在管理后台运行时开启) # FAST_SCHEDULER_ENABLED=true # 生图工作台图库目录;Docker 标准版 compose 已将 /data 挂载为持久化卷 IMAGE_ASSET_DIR=/data/images # 日志目录;只允许写临时盘的平台可改为 /tmp/logs LOG_DIR=logs # 禁用文件日志(上游错误日志与安全审计日志);只读文件系统可设为 true LOG_DISABLED=false # 安全审计日志目录;留空则使用 LOG_DIR/security # SECURITY_LOG_DIR=/tmp/logs/security # ---- PostgreSQL ---- DATABASE_DRIVER=postgres DATABASE_HOST=postgres DATABASE_PORT=5432 DATABASE_USER=codex2api DATABASE_PASSWORD=codex2api DATABASE_NAME=codex2api # 可选:自定义 schema(适用于 Supabase 等多项目共享 database 的场景) # 启动时会自动 CREATE SCHEMA IF NOT EXISTS,并在所有连接上 SET search_path 到该 schema # 仅允许字母/数字/下划线,长度 ≤63;留空时使用数据库默认 search_path(通常是 public) # DATABASE_SCHEMA=codex2api # ---- Redis ---- CACHE_DRIVER=redis # 支持 host:port、redis://...、rediss://...;Aiven / Upstash 通常使用 rediss:// REDIS_ADDR=redis:6379 REDIS_USERNAME= REDIS_PASSWORD= REDIS_DB=0 REDIS_TLS=false REDIS_INSECURE_SKIP_VERIFY=false # ---- 时区 ---- TZ=Asia/Shanghai