启动设置:运行镜像、启动参数与自动续费

介绍「启动设置」标签页:切换运行镜像、修改启动参数(含 exec 规则和变量引用)、开关自动续费(仅按月计费的实例),以及删除实例的入口。

平台面板 · 更新于

「启动设置」标签页集中管理实例的运行环境和启动方式,包含四张卡片:运行镜像、启动参数、自动续费、危险操作。按小时计费的实例没有「自动续费」卡片。从「概览」标签页「启动参数」卡片中的「修改启动设置」也能跳转到这里。

运行镜像

运行镜像决定了服务器的运行环境,例如 Java 版本或游戏服务端版本。部分游戏提供多个运行镜像供选择,卡片右上角会显示“N 个可选”。

切换步骤

  1. 在下拉框中选择新的运行镜像。
  2. 点击「切换镜像」。
  3. 确认对话框提示:节点会拉取新镜像并重建容器,数据目录保留不变。运行中的服务会短暂中断,首次拉取大镜像可能需要几分钟。
  4. 点击「切换并重建」。

注意事项

提示 说明
该游戏只提供一个运行镜像。 无需也无法切换
切换前请先备份存档:部分游戏的新旧版本存档不兼容。 升级或降级版本可能导致存档无法读取,或被新版本转换后无法回退
该实例由整合包开服,切换到其他镜像可能导致整合包无法启动,请先备份存档。 整合包对运行环境有要求,一般不建议更换
实例正在安装,完成后才能切换镜像。 等待安装结束

切换运行镜像不会清空数据,也不会更换游戏。如果想换成另一款游戏,或者换到需要重新安装的版本,请使用「切换游戏」,见 重新安装与切换游戏。

备份方法见 文件管理 或 SFTP 连接。

启动参数

启动参数就是启动游戏服务端时执行的命令。一般情况下保持默认即可,只有在需要调整 JVM 参数、启动参数开关时才需要修改。

修改步骤

  1. 在「启动参数」输入框中修改命令。
  2. 点击「保存启动参数」。
  3. 保存后容器会按新参数重建,数据目录保留。页面提示“启动参数已保存,容器已按新参数重建。”

如果实例处于「安装失败」状态,此时没有可重建的容器,新参数只会先保存下来,要在下次「重新安装」后才生效。

关于 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”。建议保持余额充足,见 钱包充值 和 计费与续费。

危险操作

「危险操作」卡片中提供「删除实例」按钮。删除会停止容器,并可能删除关联数据。此操作不可撤销,请先备份重要文件。按小时计费的实例,卡片中还会注明「按小时计费实例删除不退款。」退款规则见 删除与退款。

不能修改的情况

  • 实例创建中或安装中:等待完成后再修改。
  • 实例已到期:页面会提示先续费再修改运行设置。按小时实例需要充值后在详情页点击「恢复计费」。
  • 实例状态不支持切换镜像时,会提示“实例当前状态不支持切换镜像,请等待其运行或停止后再试”。