首页 / 配置参考

配置参考

全部变量放 .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_SLUGGitHub App 的数字 id 与 URL slug
MU_GITHUB_APP_PRIVATE_KEYApp 私钥 PEM 全文(含 BEGIN/END 行)
MU_GITHUB_WEBHOOK_SECRETwebhook 签名密钥,须与 App 设置页一致。openssl rand -hex 32
MU_GITHUB_OAUTH_CLIENT_ID / ..._SECRETOAuth App(用户登录用;与 GitHub App 是两个东西)
MU_GITHUB_OAUTH_CALLBACK_URLhttps://你的域名/api/mu/auth/oauth/github/callback
MU_GITHUB_APP_INSTALL_CALLBACK_URLhttps://你的域名/multiuser
MU_LLM_PROVIDER/BASE_URL/MODEL/API_KEYopenai_compatible 端点四件套;key 仅存 env

条件项

变量说明
MERGEPILOT_MODEL_CACHE_DIRcchain:模型缓存目录(默认卷内 /app/rag-models)
MERGEPILOT_PROVIDER_ATTEST_URLcchain:供应商证明端点(自建静态 nginx 即可)
MERGEPILOT_RUN_BINDING_KEYSTOREcchain:keystore 目录(默认卷内 /app/keystore)
RAGTRIAL_EMBED_MODEL_ID / _DIMS / _ENDPOINT / _EXPECTED_MANIFESTRAG 嵌入(默认指向 compose 内 bge-m3 sidecar)
RAGTRIAL_ALLOWED_SCOPESRAG 允许的仓库范围白名单
MU_GITEE_OAUTH_CLIENT_ID / _CLIENT_SECRET / _CALLBACK_URLGitee OAuth 登录(三项任一缺失则登录页不渲染 Gitee 入口)
MU_GITEE_PATGitee 连接 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 即失败,属预期防呆。