Hub 配置项

Hub 从环境变量或 hub-backend/ 下私有的 .env 文件读取配置。变量名不区分大小写，本页统一用大写。源码启动器和 Docker 启动器会替你设置它们需要的值。

不要提交 .env。密钥请放在密钥管理工具或部署环境里。

环境与数据库

变量	默认值	说明
SODUWORK_ENV	development	设为 production 时启用生产环境检查
DATABASE_URL	sqlite+aiosqlite:///./box_hub.db	开发环境以外请用 postgresql+asyncpg://…
DB_MIGRATION_MODE	auto	auto 在启动时迁移（单实例）；check 要求先由发布任务完成迁移
DB_POOL_SIZE	10	1～100
DB_MAX_OVERFLOW	20	0～100
DB_POOL_TIMEOUT	15	秒，1～120
DB_POOL_RECYCLE	1800	秒，不小于 60
DB_STATEMENT_TIMEOUT_MS	30000	0 表示不限制

身份与访问

变量	默认值	说明
ADMIN_USER	admin	只在还没有任何用户时，用于创建第一个管理员
ADMIN_PASS	空	开发环境自动生成，其他环境必须设置
AUTH_SECRET	空	令牌的签名密钥。开发环境自动生成，其他环境必须设置
TOKEN_TTL_HOURS	168	7 天
CORS_ORIGINS	*	逗号分隔。生产环境不允许 *
DEVICE_AUTH_COMPAT	true	生产环境必须为 false。用于迁移期间接受旧的设备请求头
HUB_PUBLIC_URL	空	用户访问的 HTTPS 地址。生产环境必需，也用作 OAuth 回调地址
OIDC_HTTP_TIMEOUT_SECONDS	10	企业 SSO 请求的超时时间

执行

变量	默认值	说明
HUB_LOCAL_EXECUTION_ENABLED	true	Hub 自己是否可以运行 Agent。Docker 部署设为 false
CLOUD_EXECUTION_RUNNER_IDS	空	云端对话可用的执行机 ID 白名单，逗号分隔。留空则按常规路由
OFFLINE_AFTER_SECONDS	30	客户端多久没有响应视为离线

连接器

变量	默认值	说明
CONNECTOR_OAUTH_KEY	空	加密连接器授权的 Fernet 密钥
CONNECTOR_GOOGLE_CLIENT_ID、CONNECTOR_GOOGLE_CLIENT_SECRET	空	Google 应用
CONNECTOR_MICROSOFT_CLIENT_ID、CONNECTOR_MICROSOFT_CLIENT_SECRET	空	Microsoft 应用
CONNECTOR_MICROSOFT_TENANT	organizations
REPOSITORY_SYNC_INTERVAL_SECONDS	900	仓库目录的刷新间隔；0 表示不刷新

见集成。

文件

变量	默认值	说明
ATTACH_MAX_MB	20	单个任务附件的大小上限
LIBRARY_STORAGE_BACKEND	local	local、remote 或 auto
LIBRARY_STORAGE_DIR	uploads/library	local 时使用
LIBRARY_MAX_MB	0	0 表示应用不限制，反向代理仍可设置上限
VIDEO_MAX_MB	256	20～2048

资料库的远程存储（S3 兼容或 NFS）在 hub-backend/app/config.py 里有各自的 LIBRARY_MINIO_* 和 LIBRARY_NFS_* 配置。

客户端更新

变量	默认值	说明
CLIENT_UPDATE_PUBLIC_KEYS	空	受信任的 Ed25519 公钥（JSON）。留空则使用仓库里的信任文件

签名私钥不要放在长期运行的 Hub 上，只挂载到负责签名发布的地方。

其他配置项

hub-backend/app/config.py 列出了全部配置项及其默认值和取值范围。本页没有列出的，用于集群、可选集成或内部功能，大多数部署用不到。