环境变量:修改游戏参数

介绍「环境变量」标签页中变量的来源、可编辑与只读的区别、各种输入类型、保存与生效时机、校验规则,以及在启动参数中引用变量的写法。

平台面板 · 更新于

环境变量是游戏版本预先定义的一组参数,例如服务器名称、最大人数、游戏密码、地图种子等。修改环境变量是调整服务器设置最简单、最安全的方式。

变量从哪里来

每个游戏版本都定义了自己的一组变量:

  • 开服时:必须提前确定的变量会出现在开服面板的「游戏参数」中,例如世界名或管理员密码,见 开服流程。
  • 开服后:在实例详情页的「环境变量」标签页中查看和修改。

不同游戏提供的变量各不相同,具体含义请参考各游戏的配置文档,例如 Minecraft server.properties、Rust 配置、幻兽帕鲁配置、饥荒配置与模组。

界面说明

卡片标题旁的徽章显示“可编辑数量 / 总数 可编辑”。每个变量包括:

部分 说明
名称 变量的中文名称;带红色 * 的为必填项
变量名 等宽字体显示的英文变量名,例如 MAX_PLAYERS,在启动参数中引用时使用
输入框 根据类型显示文本框、下拉框或密码框
说明 输入框下方的灰色文字,说明用途和取值要求

标注「只读,由游戏版本设定」的变量只能查看,不能修改。如果版本没有提供任何变量,会显示「没有可查看的环境变量」。

输入类型

类型 说明
文本 直接输入内容
下拉 从给定选项中选择。非必填的下拉变量可以选择「未设置」,含义由游戏版本决定,常见的是保持配置文件中的原值
密码 输入内容以掩码显示,适合填写服务器密码、管理员密码等

修改并保存

  1. 打开实例详情页的「环境变量」标签页。
  2. 修改需要调整的变量。
  3. 点击「保存变量」。如果想放弃修改,点击「撤销修改」恢复为已保存的值。
  4. 保存成功后,页面提示“环境变量已保存,新的值将在下次重建或重新安装时生效”。

校验规则

保存时会检查每个变量的值,不符合要求的变量会标红,并提示「请先修正标红的变量」:

提示 原因
请填写 X 必填项为空
X 的格式不符合要求 不符合该变量的取值规则,例如要求纯数字
X 的值必须是可选项之一 下拉变量的值不在选项中
X 不能超过 1024 字节 内容过长
X 不能包含换行或控制字符 变量值只能是单行文本

不能修改的情况

  • 实例安装中:页面提示「实例正在安装,完成后才能修改环境变量。」
  • 实例创建中,或实例已到期:需要等待创建完成,或先续费,见 计费与续费。

什么时候生效

保存变量不会重启或重建当前正在运行的服务器,在线玩家不受影响。新的值会在以下时机使用:

变量用途 生效时机
写入游戏配置文件的变量 平台在每次开机或重启时,按变量值改写配置文件中的对应项,因此下次开机或重启后生效
用于启动命令的变量 容器重建时生效,例如保存启动参数、切换运行镜像、更换套餐,或者重新安装

如果不确定某个变量属于哪一种,修改后先重启一次。重启后仍未生效的,可以等下一次重建或重新安装时再观察。

注意:配置文件中的对应项会被覆盖

对于由环境变量控制的配置项,平台会在开机时用变量值写入配置文件。如果你只在 文件管理 中直接修改这些项,下次开机时就会被变量值覆盖。由环境变量控制的设置,请在「环境变量」标签页中修改。 没有对应变量的配置项,可以直接编辑配置文件。

在启动参数中引用变量

在「启动设置」的启动参数中,可以用 {{变量名}} 引用环境变量,例如:

java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar server.jar nogui

除了游戏版本定义的变量外,还可以使用以下内置变量:

写法 含义
{{SERVER_MEMORY}} 当前套餐的内存大小,单位 MB
{{SERVER_IP}} 服务器监听地址,固定为 0.0.0.0
{{SERVER_PORT}} 主端口对应的容器端口
{{server.host}} 节点的公网地址
{{server.port.N}} 第 N 个端口的外网端口,N 从 1 开始
{{server.container_port.N}} 第 N 个端口的容器端口

如果引用了不存在的变量,该位置会被替换为空,平台会给出提示。使用 {{SERVER_MEMORY}} 的好处是,更换套餐 后内存参数会自动跟着变化。

详见 启动设置。

常见问题

改了变量,游戏里没变化? 请按上面的“什么时候生效”判断,先重启一次。如果是写在启动命令中的参数,需要等容器重建或重新安装后才生效。

找不到想改的设置? 没有对应变量的设置,请直接在配置文件中修改,见 文件管理。

切换游戏后变量都变了? 不同游戏、不同版本的变量各自独立,切换后会使用新版本的变量,见 重新安装与切换游戏。