环境变量:修改游戏参数
介绍「环境变量」标签页中变量的来源、可编辑与只读的区别、各种输入类型、保存与生效时机、校验规则,以及在启动参数中引用变量的写法。
平台面板 · 更新于
环境变量是游戏版本预先定义的一组参数,例如服务器名称、最大人数、游戏密码、地图种子等。修改环境变量是调整服务器设置最简单、最安全的方式。
变量从哪里来
每个游戏版本都定义了自己的一组变量:
- 开服时:必须提前确定的变量会出现在开服面板的「游戏参数」中,例如世界名或管理员密码,见 开服流程。
- 开服后:在实例详情页的「环境变量」标签页中查看和修改。
不同游戏提供的变量各不相同,具体含义请参考各游戏的配置文档,例如 Minecraft server.properties、Rust 配置、幻兽帕鲁配置、饥荒配置与模组。
界面说明
卡片标题旁的徽章显示“可编辑数量 / 总数 可编辑”。每个变量包括:
| 部分 | 说明 |
|---|---|
| 名称 | 变量的中文名称;带红色 * 的为必填项 |
| 变量名 | 等宽字体显示的英文变量名,例如 MAX_PLAYERS,在启动参数中引用时使用 |
| 输入框 | 根据类型显示文本框、下拉框或密码框 |
| 说明 | 输入框下方的灰色文字,说明用途和取值要求 |
标注「只读,由游戏版本设定」的变量只能查看,不能修改。如果版本没有提供任何变量,会显示「没有可查看的环境变量」。
输入类型
| 类型 | 说明 |
|---|---|
| 文本 | 直接输入内容 |
| 下拉 | 从给定选项中选择。非必填的下拉变量可以选择「未设置」,含义由游戏版本决定,常见的是保持配置文件中的原值 |
| 密码 | 输入内容以掩码显示,适合填写服务器密码、管理员密码等 |
修改并保存
- 打开实例详情页的「环境变量」标签页。
- 修改需要调整的变量。
- 点击「保存变量」。如果想放弃修改,点击「撤销修改」恢复为已保存的值。
- 保存成功后,页面提示“环境变量已保存,新的值将在下次重建或重新安装时生效”。
校验规则
保存时会检查每个变量的值,不符合要求的变量会标红,并提示「请先修正标红的变量」:
| 提示 | 原因 |
|---|---|
| 请填写 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}} 的好处是,更换套餐 后内存参数会自动跟着变化。
详见 启动设置。
常见问题
改了变量,游戏里没变化? 请按上面的“什么时候生效”判断,先重启一次。如果是写在启动命令中的参数,需要等容器重建或重新安装后才生效。
找不到想改的设置? 没有对应变量的设置,请直接在配置文件中修改,见 文件管理。
切换游戏后变量都变了? 不同游戏、不同版本的变量各自独立,切换后会使用新版本的变量,见 重新安装与切换游戏。
