环境变量覆盖

配置文件里的每一项都可以用环境变量覆盖，环境变量的优先级高于 config.yml。适合 Docker、systemd，或者不想把密码写进文件的情况。

命名规则

text

ZS__<段名>__<键名>

配置文件	环境变量
`server.port: 9000`	`ZS__SERVER__PORT=9000`
`database.url: postgres://…`	`ZS__DATABASE__URL=postgres://…`
`log.level: debug`	`ZS__LOG__LEVEL=debug`
`app.secret_key: …`	`ZS__APP__SECRET_KEY=…`
`jwt.secret: …`	`ZS__JWT__SECRET=…`
`reseller.enabled: true`	`ZS__RESELLER__ENABLED=true`
`security.login_rate_limit.max_attempts: 10`	`ZS__SECURITY__LOGIN_RATE_LIMIT__MAX_ATTEMPTS=10`
`integration.allow_private_addresses: true`	`ZS__INTEGRATION__ALLOW_PRIVATE_ADDRESSES=true`
`cors.allowed_origins: [a, b]`	`ZS__CORS__ALLOWED_ORIGINS=https://a.com,https://b.com`（逗号分隔）

true / false 和数字会自动识别类型。

在 [Service] 段加 Environment=，或者用一个只有 root 能读的文件：

ini

[Service]
EnvironmentFile=/etc/zebra-store.env

/etc/zebra-store.env：

bash

ZS__APP__SECRET_KEY=……
ZS__JWT__SECRET=……
ZS__USER_JWT__SECRET=……
ZS__DATABASE__URL=postgres://zebra:密码@127.0.0.1:5432/zebra

bash

chmod 600 /etc/zebra-store.env && systemctl daemon-reload && systemctl restart zebra-store

yaml

services:
  zebra:
    environment:
      ZS__LOG__LEVEL: debug
      ZS__DATABASE__URL: postgres://zebra:密码@db:5432/zebra