启动设置:运行镜像、启动参数与自动续费
介绍「启动设置」标签页:切换运行镜像、修改启动参数(含 exec 规则和变量引用)、开关自动续费(仅按月计费的实例),以及删除实例的入口。
平台面板 · 更新于
「启动设置」标签页集中管理实例的运行环境和启动方式,包含四张卡片:运行镜像、启动参数、自动续费、危险操作。按小时计费的实例没有「自动续费」卡片。从「概览」标签页「启动参数」卡片中的「修改启动设置」也能跳转到这里。
运行镜像
运行镜像决定了服务器的运行环境,例如 Java 版本或游戏服务端版本。部分游戏提供多个运行镜像供选择,卡片右上角会显示“N 个可选”。
切换步骤
- 在下拉框中选择新的运行镜像。
- 点击「切换镜像」。
- 确认对话框提示:节点会拉取新镜像并重建容器,数据目录保留不变。运行中的服务会短暂中断,首次拉取大镜像可能需要几分钟。
- 点击「切换并重建」。
注意事项
| 提示 | 说明 |
|---|---|
| 该游戏只提供一个运行镜像。 | 无需也无法切换 |
| 切换前请先备份存档:部分游戏的新旧版本存档不兼容。 | 升级或降级版本可能导致存档无法读取,或被新版本转换后无法回退 |
| 该实例由整合包开服,切换到其他镜像可能导致整合包无法启动,请先备份存档。 | 整合包对运行环境有要求,一般不建议更换 |
| 实例正在安装,完成后才能切换镜像。 | 等待安装结束 |
切换运行镜像不会清空数据,也不会更换游戏。如果想换成另一款游戏,或者换到需要重新安装的版本,请使用「切换游戏」,见 重新安装与切换游戏。
启动参数
启动参数就是启动游戏服务端时执行的命令。一般情况下保持默认即可,只有在需要调整 JVM 参数、启动参数开关时才需要修改。
修改步骤
- 在「启动参数」输入框中修改命令。
- 点击「保存启动参数」。
- 保存后容器会按新参数重建,数据目录保留。页面提示“启动参数已保存,容器已按新参数重建。”
如果实例处于「安装失败」状态,此时没有可重建的容器,新参数只会先保存下来,要在下次「重新安装」后才生效。
关于 exec 前缀
输入框左侧会显示一个灰色的 exec,它由平台自动添加,不需要自己填写。它的作用是让游戏进程直接收到停止信号,在关机时能够正常保存并退出。
如果命令中包含 &&、;、| 等组合写法,平台不会自动添加 exec,并提示:检测到组合命令,请确认游戏能收到停止信号。此时关机可能无法让游戏正常保存,建议尽量使用单条命令。
引用变量
启动参数中可以用 {{变量名}} 引用环境变量和内置变量,例如:
java -Xms512M -Xmx{{SERVER_MEMORY}}M -jar server.jar nogui
| 写法 | 含义 |
|---|---|
{{变量名}} |
「环境变量」标签页中的变量,例如 {{MAX_PLAYERS}} |
{{SERVER_MEMORY}} |
套餐内存,单位 MB |
{{SERVER_IP}} |
监听地址 0.0.0.0 |
{{SERVER_PORT}} |
主端口对应的容器端口 |
{{server.port.N}} |
第 N 个端口的外网端口,N 从 1 开始 |
{{server.container_port.N}} |
第 N 个端口的容器端口 |
{{server.host}} |
节点的公网地址 |
引用不存在的变量,或者端口序号超过实例的端口数量时,保存会失败并给出原因。变量说明见 环境变量,端口说明见 网络与端口。
编写建议
- 内存参数建议使用
{{SERVER_MEMORY}},而不是写死的数字。这样 更换套餐 后会自动适配;同时建议给系统预留一部分内存,避免因内存不足被终止。 - 不要在启动参数中写入密码等敏感信息,密码类参数请使用环境变量。
- 启动参数最长 4096 个字符。
- 修改前先复制原命令保存一份,出问题时可以改回去。
启动参数被锁定
部分游戏版本的启动参数由平台统一维护,卡片会显示「该版本的启动参数由管理员锁定,无法修改」,此时只能查看。需要调整的参数通常可以在「环境变量」中修改。
自动续费
「自动续费」卡片只在按月计费的实例上显示。按小时计费的实例总是每小时自动从余额扣费,没有自动续费开关,也不需要手动续费,见 计费与续费。
按月实例的开关状态如下:
| 状态 | 说明 |
|---|---|
| 开启 | 卡片说明为“到期前使用账户余额自动支付下个月”,实际扣款发生在到达到期时间后的几分钟内,余额充足时实例不会停机。显示“已开启,余额不足时可能续费失败” |
| 关闭 | 显示“未开启,到期后实例可能停止” |
卡片中会显示「月费」和「余额」。开启自动续费但余额不足时,会提示“余额不足,还差 X”。建议保持余额充足,见 钱包充值 和 计费与续费。
危险操作
「危险操作」卡片中提供「删除实例」按钮。删除会停止容器,并可能删除关联数据。此操作不可撤销,请先备份重要文件。按小时计费的实例,卡片中还会注明「按小时计费实例删除不退款。」退款规则见 删除与退款。
不能修改的情况
- 实例创建中或安装中:等待完成后再修改。
- 实例已到期:页面会提示先续费再修改运行设置。按小时实例需要充值后在详情页点击「恢复计费」。
- 实例状态不支持切换镜像时,会提示“实例当前状态不支持切换镜像,请等待其运行或停止后再试”。
