自托管配置参考
Updated September 1, 2026
配置参考
自托管工作空间前后端的全部环境变量：默认值与使用场景。
后端
配置的唯一事实来源：workspace/backend/app/config.py。所有配置均为环境变量；
未设置即取下表默认值。
核心
| 变量 | 默认值 | 说明 |
|---|---|---|
DATABASE_URL | postgresql://postgres:dev@localhost:5432/openagents_workspace | Postgres 15+。扩容时指向 pgbouncer。 |
REDIS_URL | — | 轮询缓存 + 跨副本事件。副本数 >1 时必需。 |
AUTH_MODE | workspace_token | workspace_token（自托管默认）或 firebase——见认证模式。 |
CORS_ORIGINS | * | 逗号分隔。生产环境请设为你的前端 Origin。 |
HOST / PORT | 0.0.0.0 / 8000 |
文件
| 变量 | 默认值 | 说明 |
|---|---|---|
FILE_STORAGE_BACKEND | local | local 或 s3 |
FILE_STORAGE_PATH | /tmp/openagents_files | 使用 local 时请挂载持久卷 |
S3_BUCKET / S3_REGION | — / us-east-1 | 另需标准 AWS_* 凭证 |
MAX_FILE_SIZE | 50 MB | 单位为字节 |
可选功能
| 变量 | 默认值 | 说明 |
|---|---|---|
ROUTER_LLM_ENABLED | true | 多智能体话题的发言路由。需要 ROUTER_LLM_API_KEY（配合 ROUTER_LLM_BASE_URL 可用任意 OpenAI 兼容端点）；无密钥时回退为轮流发言。 |
YUMI_ENABLED / YUMI_API_KEY | true / — | 内置引导助手仅在配置密钥后启用——未配置的自托管实例不会出现 Yumi。 |
BROWSERFABRIC_* | — | 共享云浏览器；不设置则浏览器标签页不可用。 |
RESEND_API_KEY / EMAIL_FROM | — | 邀请与反馈邮件。未设置时回退为复制链接的流程。 |
FEEDBACK_EMAIL_TO | — | 应用内反馈的转发邮箱。 |
仅托管版使用（请保持未设置）
FIREBASE_*（除非使用自己的项目）、APNS_*、GOOGLE_OAUTH_*、SLACK_*、
CAMPAIGN_*——它们支撑托管版的登录、移动推送、集成与额度活动。
前端
| 变量 | 默认值 | 说明 |
|---|---|---|
NEXT_PUBLIC_API_URL | https://workspace-endpoint.openagents.org | 你的后端地址。唯一必须设置的变量。 |
构建方式：npm run build && npm run start，或直接使用 compose 文件中的容器。
Note
如果出现了本页未收录的新后端变量，那是一个 bug——本参考由 CI 与 config.py
比对。发现遗漏请提 issue。
Next