网络与端口:连接地址、添加端口与对等端口

解释主端口、容器端口与外网端口的关系,如何在「网络」标签页添加自定义端口、申请对等端口、关闭端口,以及外网连不上时的排查方法。

平台面板 · 更新于

每个实例创建时,平台会自动为游戏所需的端口分配外网端口。玩家连接、远程管理、网页地图等功能都依赖这些端口。本文介绍「网络」标签页的使用方法。

先理解三个概念

概念 说明
容器端口 游戏或插件在服务器内部监听的端口,通常写在游戏配置文件中
外网端口 玩家从互联网访问时使用的端口,由平台自动分配
主端口 玩家在游戏客户端中填写的那个端口,带「主端口」标识

平台会把外网端口转发到容器端口,因此两者的数字通常不同。玩家连接时始终使用外网端口,也就是页面上显示的 主机:端口 地址。

查看端口列表

「网络」标签页中的「端口列表」卡片列出了实例的全部端口。每一行包含:

  • 连接地址(主机:外网端口),右侧有复制按钮。
  • 标识:「主端口」、「镜像」(游戏自带)或「自定义」(你添加的),以及「对等」。
  • 说明行:协议 · 容器 X → 外网 Y;对等端口显示为 协议 · 内外端口 Y。
  • 你添加的端口还会显示备注,并带有删除按钮。

游戏自带的端口不可删除。同一个端口同时开放 TCP 和 UDP 时显示为 TCP+UDP。

「概览」标签页的「玩家连接地址」卡片也展示了同样的地址,主端口地址在最上方,方便复制,见 实例概览与资源监控。

添加自定义端口

当你安装了需要额外端口的插件(例如网页地图、语音插件、RCON 远程管理)时,可以自行添加端口。

  1. 打开「网络」标签页,找到「添加端口」卡片。
  2. 「容器内部端口」填写插件在容器内监听的端口,范围 1-65535,例如 8123。
  3. 「协议」选择 TCP、UDP 或 TCP+UDP,按插件文档要求选择。
  4. 「备注(可选)」填写用途,最多 40 个字符,例如“网页地图”。
  5. 点击「添加端口」。
  6. 如果实例正在运行,会弹出确认框,提示保存后会自动重启、在线玩家会短暂断开,点击「开放并重启」。如果实例未运行,端口会在下次启动时生效。

添加完成后,端口列表中会出现一条新的记录,显示平台分配的外网端口,通过该地址即可访问插件。

数量限制

每个实例可以添加的自定义端口数量有上限,卡片右上角会显示“已用 / 上限”,TCP+UDP 只计为 1 个。达到上限时会提示「已达到自定义端口上限,请先删除不再使用的端口。」

申请对等端口

有些游戏或插件要求容器内的监听端口与外网端口一致,例如 Rust+ 手机应用使用的 app.port。这时普通端口转发无法满足要求,需要申请对等端口:

  1. 在「添加端口」卡片中选择协议,无需填写容器端口。
  2. 点击「申请对等端口」。
  3. 确认对话框提示:平台会分配一个端口,容器内与外网使用同一端口号。实例正在运行时按钮为「申请并重启」,否则为「申请」。
  4. 分配完成后,在端口列表中查看带「对等」标识的端口号。
  5. 把游戏或插件的监听端口改成这个端口号,例如在配置文件或 环境变量 中修改,然后重启实例。

Rust+ 的具体配置见 Rust 配置。

关闭端口

  1. 在端口列表中点击自定义端口右侧的删除按钮。
  2. 确认对话框提示:该外网端口会被回收,之后可能分配给其他实例。实例正在运行时会自动重启。
  3. 点击「关闭端口」。

端口回收后无法找回原来的端口号,如果有玩家或工具保存了这个地址,需要更新。

不能调整端口的情况

情况 提示
实例已到期 实例已过期,续费后才能调整端口
实例创建中 实例创建中,完成后才能调整端口
实例安装中 实例安装中,完成后才能调整端口

另外请注意,「切换游戏」后端口映射可能变化,你自行添加的端口也会被移除,见 重新安装与切换游戏。

在启动命令和配置中引用端口

如果需要在启动参数中使用端口号,可以用以下变量引用,避免手动填写数字:

写法 含义
{{SERVER_PORT}} 主端口对应的容器端口
{{server.port.1}}、{{server.port.2}} … 按分配顺序第 1、2 … 个端口的外网端口,{{server.port}} 等同于第 1 个
{{server.container_port.1}} … 按分配顺序第 1、2 … 个端口的容器端口
{{server.host}} 节点的公网地址

详见 启动设置。

连不上服务器时的排查

  1. 确认实例状态为「运行中」,并在控制台确认游戏已启动完成。
  2. 确认使用的是主端口地址,而不是 SFTP 端口或其他端口。
  3. 确认游戏配置中的监听端口没有被改动。如果你在配置文件中修改了游戏端口,平台的端口转发就对不上了,请改回原值。
  4. 对于自定义端口,确认插件实际监听的端口与「容器内部端口」一致,协议也正确。
  5. 各游戏的连接说明见 Minecraft 连接、Rust 连接、饥荒连接、灵魂面甲连接 等文档。