How to

配置 Server 环境

当 Server 需要推理、调度、存储或部署设置时,使用显式环境文件。

1. 生成文件

powercontext config init --output .env

引导式命令会以 0600 权限写入私有文件。通过环境或 secret manager 提供 provider 凭据,不要把它们写入命令行参数。

2. 检查并校验

powercontext config show --env-file .env
powercontext config validate --env-file .env

config show 会隐藏已识别的凭据。校验接受只包含 Server 设置的最小环境文件;配置 inference model 或依赖 inference 的 Runtime 功能时,还会检查 Runtime 组装,但不会输出机密。

3. 使用同一份配置启动

powercontext server run --env-file .env

文件中的值会覆盖同名进程变量。文件中没有的继承 POWERCONTEXT_SERVER_* 变量会被忽略,因此校验和启动使用同一份 Server 设置。

Server 会按配置启动对应能力。使用 powercontext readypowercontext capabilities 查看就绪状态和已启用功能。

全部变量、默认值和优先级规则见配置

On this page