Reference Config

参考：配置与环境变量

权威来源：仓库根 .env.example + docker-compose.yml 里的 ${VAR:?…} 声明。 有门禁：scripts/check_compose_env.py —— compose 里声明的必填变量必须在 .env.example 出现。

两个来源，一处权威

来源	作用
.env.example	变量清单与说明（APP_SECRET、CHIRON_DATA_DIR 等）
docker-compose.yml 的 ${VAR:?…}	声明哪些是必填（缺了 compose 直接报错）

门禁保证两者不漂移 —— 所以想知道"到底有哪些变量"，读这两个文件，不要读本页。

初始化与自检

python scripts/init.py            # 交互式：生成 APP_SECRET、写 .env、自检 PostgreSQL/Redis
python scripts/init.py --check    # 只自检：必填项 + 连通性

几个容易配错的

变量	坑
REDIS_ADDR	网关读这个（host:port），不是 REDIS_URL
REDIS_URL	引擎与测试用（redis://host:port/db）—— 两个格式不同，别互抄
DATABASE_DSN	迁移与应用都要；库不在 compose 内，由云厂商/DBA 维护
CHIRON_BUILTIN_SKILLS_PATH	内置技能目录；容器部署必须挂载 market/skills/，缺了会告警且技能列表为空
MCP_POOL_ENABLED / MCP_MAX_* / MCP_OWNER_LEASE_ENABLED	MCP 连接池与 owner lease（多租户连接经济学）
CHIRON_TEST_POSTGRES_DSN / CHIRON_TEST_REDIS_ADDR	只给测试用：置上它们才会跑真实栈的 live 子集

校验配置本身

docker compose config --quiet     # compose 语法与变量插值校验

延伸阅读

• 部署 · 安装
• 多实例 —— 多副本下必须配对的变量

---

本页由仓库内 docs/wiki/ 同步生成（scripts/sync_github_wiki.py）。请不要直接编辑本 wiki —— 改动会下次同步时被覆盖；请改仓库里的对应文件。