环境变量
Hub 的全部配置都来自环境变量，修改后重启生效。控制台「配置与接入」页会列出每个变量的当前值（密钥类只显示是否已设置）。
核心
| 变量 | 默认值 | 说明 |
|---|---|---|
SECRET_KEY | 随机（每次启动不同） | 务必设置。 加密存库的上游 Key、对外 Key 和自定义 LLM Key，并签名控制台会话。未设置时重启后已存的 Key 无法解密。设置后不要更改 |
DATABASE_URL | 由 POSTGRES_* 拼接 | PostgreSQL 连接串，支持 postgres://、postgresql://、?sslmode=require |
POSTGRES_HOST / POSTGRES_PORT / POSTGRES_USER / POSTGRES_PASSWORD / POSTGRES_DB | db / 5432 / hub / hub / hub | 未设置 DATABASE_URL 时用于拼接连接串；Docker Compose 也用 POSTGRES_PASSWORD 初始化数据库 |
ADMIN_USERNAME | admin | 控制台用户名 |
ADMIN_PASSWORD | admin | 控制台密码，生产环境必须修改 |
SESSION_MAX_AGE | 604800 | 控制台登录有效期（秒），默认 7 天 |
SITE_NAME | AssemblyAI Hub | 站点名称 |
PORT | 8000 | 容器内监听端口 |
HUB_PORT | 18080 | 仅 Docker Compose：映射到宿主机的端口 |
HUB_IMAGE | ghcr.io/trageeker/assemblyai-hub:latest | 仅 Docker Compose：使用的镜像 |
LOG_LEVEL | INFO | 日志级别 |
ALLOW_OPEN_DOCS | true | /hub/docs 与 /hub/openapi.json 是否开放 |
回调与轮询
| 变量 | 默认值 | 说明 |
|---|---|---|
PUBLIC_BASE_URL | 空 | AssemblyAI 能访问到的 Hub 地址（如 https://hub.example.com）。设置后启用回调，否则只靠轮询 |
WEBHOOK_SECRET | 随机 | AssemblyAI 回调 Hub 时携带的 X-Hub-Webhook 头的值。建议固定，否则重启前提交的任务回调会校验失败（轮询仍会兜底） |
POLL_INTERVAL | 20 | 轮询未完成任务的间隔（秒） |
上游与账号池
| 变量 | 默认值 | 说明 |
|---|---|---|
MAX_RETRY_ACCOUNTS | 3 | 一次请求最多尝试几个账号 |
COOLDOWN_SECONDS | 60 | 账号遇到 429 后的冷却时间（秒） |
DEFAULT_MAX_CONCURRENCY | 5 | 新增账号的默认并发上限 |
DEFAULT_REGION | us | 新增账号的默认区域（us / eu） |
UPSTREAM_TIMEOUT | 300 | 上游请求超时（秒） |
AAI_ACCOUNTS | 空 | 启动时导入的上游账号：名称:Key[:区域[:权重[:并发]]]，逗号分隔 |
HUB_API_KEYS | 空 | 启动时导入的对外 Key：名称:完整Key，逗号分隔 |
控制台上传与 AI
| 变量 | 默认值 | 说明 |
|---|---|---|
MAX_UPLOAD_MB | 2048 | 控制台单个文件上传上限（MB） |
DEFAULT_SPEECH_MODELS | universal-3-5-pro,universal-2 | 控制台上传转写的默认模型，按顺序回退 |
DEFAULT_LLM_MODEL | claude-sonnet-4-6 | 任务页 AI 操作走 LLM 网关时的默认模型 |
LLM_BASE_URL | 空 | 自定义 OpenAI 兼容接口地址（到 /v1 为止），控制台可覆盖 |
LLM_API_KEY | 空 | 自定义 LLM 的 Key，控制台可覆盖 |
LLM_MODEL | 空 | 自定义 LLM 默认模型 |
LLM_TIMEOUT | 180 | 自定义 LLM 请求超时（秒） |
FFMPEG_BIN | ffmpeg | ffmpeg 路径（镜像已内置） |
COMPRESS_BITRATE | 32k | 上传压缩的 Opus 码率，语音 24k 到 48k 足够 |
网络代理
| 变量 | 默认值 | 说明 |
|---|---|---|
SINGBOX_BIN | sing-box | sing-box 路径（镜像已内置），SS / VMess / VLESS / Trojan / Hysteria2 / TUIC 节点需要 |
PROXY_PORT_BASE | 20000 | sing-box 本地端口起点，节点 N 监听 127.0.0.1:起点+N |
PROXY_TEST_URL | https://www.gstatic.com/generate_204 | 节点测速访问的地址 |
PROXY_TEST_TIMEOUT | 8 | 单个节点测速超时（秒） |
PROXY_TEST_CONCURRENCY | 24 | 同时测速的节点数 |
PROXY_SUB_UA | clash-verge/v2.2.3 | 拉取订阅时的 User-Agent |
PROXY_SUB_REFRESH_HOURS | 12 | 订阅自动更新间隔（小时），0 为仅手动 |