首页 / 配置参考
配置参考
全部变量放 .env(compose --env-file 注入);
生成命令以 openssl 为例。所有 secrets 权限 0600、不入 git、不入日志。
必填
| 变量 | 说明 / 生成 |
|---|---|
POSTGRES_PASSWORD | 数据库密码。openssl rand -hex 16 |
CONSOLE_SESSION_SECRET | 会话签名密钥。openssl rand -base64 32;轮换会使全部会话失效 |
MU_BOOTSTRAP_ADMIN_SUBJECT | 首任平台管理员绑定(rc8+ 开箱初始化):填 github-oauth:<GitHub数字id>(须带前缀),首次启动幂等建库并授权 |
MU_GITHUB_APP_ID / MU_GITHUB_APP_SLUG | GitHub App 的数字 id 与 URL slug |
MU_GITHUB_APP_PRIVATE_KEY | App 私钥 PEM 全文(含 BEGIN/END 行) |
MU_GITHUB_WEBHOOK_SECRET | webhook 签名密钥,须与 App 设置页一致。openssl rand -hex 32 |
MU_GITHUB_OAUTH_CLIENT_ID / ..._SECRET | OAuth App(用户登录用;与 GitHub App 是两个东西) |
MU_GITHUB_OAUTH_CALLBACK_URL | https://你的域名/api/mu/auth/oauth/github/callback |
MU_GITHUB_APP_INSTALL_CALLBACK_URL | https://你的域名/multiuser |
MU_LLM_PROVIDER/BASE_URL/MODEL/API_KEY | openai_compatible 端点四件套;key 仅存 env |
条件项
| 变量 | 说明 |
|---|---|
MERGEPILOT_MODEL_CACHE_DIR | cchain:模型缓存目录(默认卷内 /app/rag-models) |
MERGEPILOT_PROVIDER_ATTEST_URL | cchain:供应商证明端点(自建静态 nginx 即可) |
MERGEPILOT_RUN_BINDING_KEYSTORE | cchain:keystore 目录(默认卷内 /app/keystore) |
RAGTRIAL_EMBED_MODEL_ID / _DIMS / _ENDPOINT / _EXPECTED_MANIFEST | RAG 嵌入(默认指向 compose 内 bge-m3 sidecar) |
RAGTRIAL_ALLOWED_SCOPES | RAG 允许的仓库范围白名单 |
MU_GITEE_OAUTH_CLIENT_ID / _CLIENT_SECRET / _CALLBACK_URL | Gitee OAuth 登录(三项任一缺失则登录页不渲染 Gitee 入口) |
MU_GITEE_PAT | Gitee 连接 PAT(仓库连接/评论/应用与合并的 Gitee 侧凭据) |
可选
| 变量 | 说明 |
|---|---|
CONSOLE_PORT / WEBHOOK_INGRESS_PORT | 宿主端口(默认 48500 / 48590,均绑定 127.0.0.1) |
MU_EXECUTOR + MU_AGENTTEAMS_* | AgentTeams 执行器接入(不填则该面 NOT_WIRED 如实降级) |
MU_FIX_TEST_CMDS | 实际修复测试的预批准命令 JSON 映射(key=provider:owner/repo);唯一命令来源,未配置=如实「未执行」 |
MU_JOB_CONSUMER_ENABLED / MU_JOB_CONSUMER_INTERVAL_MS | 事件自动消费循环(默认开 / 45000ms;关闭后事件需人工 tick) |
MU_LLM_ALLOWED_MODELS | 模型白名单(逗号分隔;默认 deepseek-flash,deepseek-chat) |
首个平台管理员
rc8+ 推荐通过环境变量 MU_BOOTSTRAP_ADMIN_SUBJECT=github-oauth:<你的GitHub数字id>
在首次启动时自动完成建库与首任 platform_admin 绑定(幂等,无需手工 SQL)。
如需在既有空库中通过数据库直授或排障回退,完整 SQL 与硬校验见仓库 deploy/selfhost/README.md
「首个平台管理员初始化(生产)」。邀请永不授予 platform_admin(API 校验 / 认领守卫 / 数据库 CHECK 三层拒绝)。
MU_ALLOW_FIXTURE_LOGIN=1 仅限本机开发/测试临时使用,生产保持关闭(诊断会 WARN)。
compose 模板对
POSTGRES_PASSWORD 使用 :? 必填守卫——
缺失时 docker compose config 即失败,属预期防呆。