结论
FastGPT Volume Manager的环境变量由projects/volume-manager/src/env.ts加载和校验。配置时需保证VMAUTHTOKEN与FastGPT侧OpenSandbox的AGENTSANDBOXOPENSANDBOXVOLUMEMANAGER_TOKEN保持一致，这些变量用于定义服务运行的核心参数。
具体怎么做
- 确定Volume Manager的运行时类型，可选docker或kubernetes。
- 配置必填的VMAUTHTOKEN，确保其与FastGPT侧OpenSandbox的对应Token完全一致。
- 根据所选运行时类型，配置对应专属环境变量：
| 变量名 | 默认值 | 适用场景 |
|---|---|---|
| PORT | 3000 | 所有场景 |
| VMAUTHTOKEN | 无，必填 | 所有场景 |
| VM_RUNTIME | kubernetes | 所有场景 |
| VMDOCKERSOCKET | /var/run/docker.sock | docker模式 |
| VMDOCKERAPI_VERSION | v1.44 | docker模式 |
| VMK8SNAMESPACE | opensandbox | kubernetes模式 |
| VMK8SPVCSTORAGECLASS | standard | kubernetes模式 |
| VMLOGLEVEL | info | 所有场景 |
注意事项
- VMAUTHTOKEN为必填项，未配置会导致服务鉴权失败。
- 仅docker运行模式需要配置VMDOCKERSOCKET和VMDOCKERAPI_VERSION，其他模式无需配置。
- 仅kubernetes运行模式需要配置VMK8SNAMESPACE和VMK8SPVCSTORAGECLASS，其他模式无需配置。
- 日志等级仅支持debug、info、none三种选项，配置其他值会触发校验失败。
- 所有环境变量需符合projects/volume-manager/src/env.ts的校验规则，否则服务无法正常启动。
来源：FastGPT 官方文档