高级配置（环境变量、开机命令）

「高级配置」包含环境变量和开机命令两项，在以下两个场景中出现：

使用场景

环境变量

传入密钥与账号信息：如 API Key、访问令牌等，不写入镜像、不落在命令里。
区分运行环境：通过 APP_ENV 等变量区分测试 / 生产环境。
同镜像多实例差异化配置：同一镜像开多个实例，用不同变量值区分，避免为每个实例单独做镜像。
配合开机命令使用：变量值可在开机命令中通过 $变量名 引用，如端口、路径等参数。

开机命令

启动即运行服务：容器启动后自动执行服务启动命令，如 python -m http.server "$PORT"、启动推理服务等。
覆盖镜像默认入口：镜像自带入口不满足需求时，用自定义命令替代。
参数化启动：结合环境变量，同一条命令通过不同变量值适配不同实例。

一、创建容器实例时的高级配置

下单页中展开 「高级配置（环境变量、开机命令）」。

环境变量

最多添加 10 项，点击 「+ 添加环境变量」 新增；
变量名（例如 APP_ENV）、变量值均可留空；
自定义变量优先于镜像中的同名变量。

开机命令

容器启动后先执行 shell 命令，随后由其覆盖镜像中指定的入口命令；
默认选中 「使用镜像默认命令」，可切换为 「自定义命令」；
输入的命令将以 /bin/sh -c "你的命令" 的方式执行，覆盖镜像入口命令；
直接输入命令内容即可，无需自行包裹 /bin/sh -c；运行环境提供 /bin/sh；
可通过 $变量名 引用环境变量，例如：python -m http.server "$PORT"；
命令长度上限 8192 字符。

二、更换镜像时的高级配置

⚠️ 替换镜像后，原先系统盘数据将被清除；更换镜像后，端口信息需要重新配置。

环境变量

最多添加 10 项，点击 「+ 添加环境变量」 新增；
自定义变量优先于镜像同名变量，变量名、变量值均可留空；
未配置自定义环境变量时，将使用镜像默认值。

开机命令

默认选中 「使用镜像默认命令」，保持镜像默认入口与命令，无需额外配置；
如需覆盖，可切换为 「自定义命令」，执行方式与创建实例时一致。

注意事项

更换镜像会清除原系统盘数据，操作前请确认重要数据已保存至数据盘（/data）或文件存储；
更换镜像后端口信息需要重新配置，如需调整对外端口，可配合「查看/更换端口」功能操作；
开机命令若配置错误可能导致容器无法正常启动，建议先在实例内手动验证命令可执行。