网络与端口:连接地址、添加端口与对等端口
解释主端口、容器端口与外网端口的关系,如何在「网络」标签页添加自定义端口、申请对等端口、关闭端口,以及外网连不上时的排查方法。
平台面板 · 更新于
每个实例创建时,平台会自动为游戏所需的端口分配外网端口。玩家连接、远程管理、网页地图等功能都依赖这些端口。本文介绍「网络」标签页的使用方法。
先理解三个概念
| 概念 | 说明 |
|---|---|
| 容器端口 | 游戏或插件在服务器内部监听的端口,通常写在游戏配置文件中 |
| 外网端口 | 玩家从互联网访问时使用的端口,由平台自动分配 |
| 主端口 | 玩家在游戏客户端中填写的那个端口,带「主端口」标识 |
平台会把外网端口转发到容器端口,因此两者的数字通常不同。玩家连接时始终使用外网端口,也就是页面上显示的 主机:端口 地址。
查看端口列表
「网络」标签页中的「端口列表」卡片列出了实例的全部端口。每一行包含:
- 连接地址(
主机:外网端口),右侧有复制按钮。 - 标识:「主端口」、「镜像」(游戏自带)或「自定义」(你添加的),以及「对等」。
- 说明行:
协议 · 容器 X → 外网 Y;对等端口显示为协议 · 内外端口 Y。 - 你添加的端口还会显示备注,并带有删除按钮。
游戏自带的端口不可删除。同一个端口同时开放 TCP 和 UDP 时显示为 TCP+UDP。
「概览」标签页的「玩家连接地址」卡片也展示了同样的地址,主端口地址在最上方,方便复制,见 实例概览与资源监控。
添加自定义端口
当你安装了需要额外端口的插件(例如网页地图、语音插件、RCON 远程管理)时,可以自行添加端口。
- 打开「网络」标签页,找到「添加端口」卡片。
- 「容器内部端口」填写插件在容器内监听的端口,范围 1-65535,例如
8123。 - 「协议」选择 TCP、UDP 或 TCP+UDP,按插件文档要求选择。
- 「备注(可选)」填写用途,最多 40 个字符,例如“网页地图”。
- 点击「添加端口」。
- 如果实例正在运行,会弹出确认框,提示保存后会自动重启、在线玩家会短暂断开,点击「开放并重启」。如果实例未运行,端口会在下次启动时生效。
添加完成后,端口列表中会出现一条新的记录,显示平台分配的外网端口,通过该地址即可访问插件。
数量限制
每个实例可以添加的自定义端口数量有上限,卡片右上角会显示“已用 / 上限”,TCP+UDP 只计为 1 个。达到上限时会提示「已达到自定义端口上限,请先删除不再使用的端口。」
申请对等端口
有些游戏或插件要求容器内的监听端口与外网端口一致,例如 Rust+ 手机应用使用的 app.port。这时普通端口转发无法满足要求,需要申请对等端口:
- 在「添加端口」卡片中选择协议,无需填写容器端口。
- 点击「申请对等端口」。
- 确认对话框提示:平台会分配一个端口,容器内与外网使用同一端口号。实例正在运行时按钮为「申请并重启」,否则为「申请」。
- 分配完成后,在端口列表中查看带「对等」标识的端口号。
- 把游戏或插件的监听端口改成这个端口号,例如在配置文件或 环境变量 中修改,然后重启实例。
Rust+ 的具体配置见 Rust 配置。
关闭端口
- 在端口列表中点击自定义端口右侧的删除按钮。
- 确认对话框提示:该外网端口会被回收,之后可能分配给其他实例。实例正在运行时会自动重启。
- 点击「关闭端口」。
端口回收后无法找回原来的端口号,如果有玩家或工具保存了这个地址,需要更新。
不能调整端口的情况
| 情况 | 提示 |
|---|---|
| 实例已到期 | 实例已过期,续费后才能调整端口 |
| 实例创建中 | 实例创建中,完成后才能调整端口 |
| 实例安装中 | 实例安装中,完成后才能调整端口 |
另外请注意,「切换游戏」后端口映射可能变化,你自行添加的端口也会被移除,见 重新安装与切换游戏。
在启动命令和配置中引用端口
如果需要在启动参数中使用端口号,可以用以下变量引用,避免手动填写数字:
| 写法 | 含义 |
|---|---|
{{SERVER_PORT}} |
主端口对应的容器端口 |
{{server.port.1}}、{{server.port.2}} … |
按分配顺序第 1、2 … 个端口的外网端口,{{server.port}} 等同于第 1 个 |
{{server.container_port.1}} … |
按分配顺序第 1、2 … 个端口的容器端口 |
{{server.host}} |
节点的公网地址 |
详见 启动设置。
连不上服务器时的排查
- 确认实例状态为「运行中」,并在控制台确认游戏已启动完成。
- 确认使用的是主端口地址,而不是 SFTP 端口或其他端口。
- 确认游戏配置中的监听端口没有被改动。如果你在配置文件中修改了游戏端口,平台的端口转发就对不上了,请改回原值。
- 对于自定义端口,确认插件实际监听的端口与「容器内部端口」一致,协议也正确。
- 各游戏的连接说明见 Minecraft 连接、Rust 连接、饥荒连接、灵魂面甲连接 等文档。
