
端口映射
端口映射将游戏服务器的内部端口暴露在其主机的公共地址上,以便玩家可以访问。当多台服务器共享一台机器时,每台服务器都需要拥有自己的外部端口。正是这种映射关系,让“容器正在运行”变成了“玩家可以连接到它”。
又称
容器端口映射、端口发布
,
端口映射对游戏服务器有什么作用?
游戏服务器在其容器内部的一个端口上进行监听:该端口号在其构建或启动参数中设置,例如 Unreal Engine 默认的 7777(Epic Games)。玩家通常无法直接访问该端口号。他们所连接的主机拥有一个公网地址,该地址通常由在其上运行的所有服务器共享,而端口映射就是将到达主机某个端口的流量发送到特定容器端口的规则。
在传入过程中,玩家的数据包至少在两处经历地址转换:
在玩家端:家用路由器以及通常互联网服务提供商(ISP)也会使用网络地址转换(NAT)在多个设备之间共享一个公网地址。正如 Highwire Games 的 Michal Buras 所说,“你的公网 IP 并不是你专有的公网 IP”:提供商将“多个用户归入单个 IP 下”,而用于区分他们的端口是“临时分配的”(Live Service Game Summit, 2024)。所有这些都处于工作室的控制范围之外。
在游戏服务器的主机端:主机会将其公网端口之一映射到容器的内部端口。这正是工作室或其编排器所控制的映射。
由于是由玩家发起连接,因此其路由器会允许回复数据包进入,所以即使在共享地址之后,加入托管服务器通常也无需在玩家端进行任何设置。共享地址主要在玩家自行建主托管时才会产生影响(请参阅下方的常见问题解答)。
文章的核心洞察
构建并发布 您的代码/游戏到容器包中,并将其作为新应用版本推送到 Edgegap。这就像为您的构建创建一个 Dockerfile 并让 Edgegap 处理其余工作一样简单。
在线测试,而非本地! 无需再为“在我的机器上能运行 <此处插入海绵宝宝表情包>”而头疼,只需数秒即可部署到 Edgegap 的实际边缘网络。这种方法消除了开发环境与生产环境之间的差异,就像拥有一个暂存环境而无需支付第二个环境的费用。您将立即知晓您的应用是否在全球 615+ 个地点实际正常运行,从而发现本地测试遗漏的问题。
添加您的开发人员工具 部署与您的应用并存的辅助工具——无论是 Web 工具、用于测试的网络信标、代理服务、数据库,还是任何其他能保持您开发工作流顺畅且高效的工具。
快速测试单个组件 独立部署和测试特定组件或服务,而无需启动新集群或影响您的生产堆栈。非常适合在实时边缘环境中使用“虚拟”后端测试新 API、验证微服务或尝试配置更改。
为什么每个游戏服务器都会分配不同的公共端口?
多个对局可以共享一台主机,而在同一个地址上,两台服务器不能直接监听相同的公共端口和协议。因此,每台服务器都会获得自己的外部端口,而每个容器则继续监听相同的内部端口。构建保持完全相同,只有映射发生改变。
一些编排器还会为其启动的每台服务器选择一个新的外部端口。无论哪种方式,公共端口都是正在运行的某台服务器的属性,而不是游戏本身的属性。
始终拨打本地测试中所用端口的客户端,只有在公共端口恰好等于默认端口时才能正常工作,而在两者不一致时都会失败。解决办法在于客户端:从告知对局位置的信息中获取端口,而不是使用代码中的常量。
玩家如何获取正确的地址和端口?
外部端口通常只有在服务器启动后才会存在,因此它必须传递给玩家:
服务器有时也需要这种映射关系,例如使用玩家实际使用的端口将自身注册到服务器列表中。如果服务器报告其内部端口,只要两者不同,就会将玩家引导至错误的端口。
在 Edgegap 上,部署就绪后,其每个内部端口都会获得一个外部端口,服务器可以从环境变量(ARBITRIUM_PORT_<NAME>_INTERNAL 和 ARBITRIUM_PORT_<NAME>_EXTERNAL)中读取两者。出于安全考虑,每次部署的外部端口都是随机分配的;对于新的部署,可以通过编辑应用版本来更改映射,而无需重新构建服务器(Edgegap 文档)。
游戏服务器需要映射哪些端口?
一个用于游戏进程,通常还会更多。每个端口都是独立映射的,且端口由一个数字加上一种协议组成(参见UDP 与 TCP),因此每个映射都必须指明服务器实际使用的协议。一组常见配置:
端口 | 协议 | 承载内容 |
|---|---|---|
游戏进程 | 通常为 UDP | 比赛期间的输入和状态更新 |
查询 (Query) | 通常为 UDP | 用于服务器列表的服务器名称、地图和玩家人数 |
远程管理 (RCON) | 通常为 TCP | 来自服务器管理员的命令 |
浏览器连接 | 通常为 TCP (WebSocket) | 在 Web 浏览器中运行的版本其游戏进程 |
协议不匹配很容易被忽视:为 TCP 设置的映射允许 UDP 游戏服务器正常启动,但玩家的数据包却完全无法送达。容器工具的默认设置各不相同,因此请检查每个映射的协议,而不要依赖默认项(Docker 的情况请参见下文常见问题解答)。
浏览器版本无法打开原始 UDP 套接字,因此它们通常通过 TCP 端口上的 WebSocket 进行连接。同时发布原生版本和浏览器版本的游戏可能需要为每种版本各设置一个映射。
来自我们的赞助商(其实就是我们自己!)的寄语
区域只是对玩家所在地的一种预测。Edgegap 的边缘云(Edge Cloud)是一个分布式、多云网络,由 17+ 家服务商提供的 615+ 个节点组成,可按需使用。当游戏对局开始时,每个服务器都会在网络中最合适的可用节点上启动,而不是在仅有的几个区域中选择最近的一个。
为什么玩家无法连接到我的游戏服务器?
当首次部署启动但无人能够加入时,原因通常是以下几项之一,大致可按此顺序进行排查:
服务器未就绪:客户端在服务器完成启动前尝试连接,或者服务器在启动时崩溃。请先查看服务器日志。
内部端口不匹配:构建版本网络设置或启动参数中的端口与映射中的内部端口不一致。
服务器仅侦听本地主机:绑定到
127.0.0.1的服务器仅接受来自其自身网络命名空间(其容器或 Kubernetes Pod)的流量。它需要侦听所有接口(0.0.0.0)。协议错误:映射配置为 TCP 但游戏使用的是 UDP,反之亦然。
客户端使用了内部端口:客户端或服务器公布的地址使用了内部端口,而非外部端口。
在工作室自行管理的机器上,主机或云网络上的防火墙规则也可能会阻止外部端口。浏览器构建版本还需要进行另一项检查,详见下文的要点说明。
Edgegap 的观点(仅代表个人意见,姑且听之即可!)
在首次公开测试之前,请为您的网页构建版本配置安全的 WebSocket 端口
浏览器版本让玩家只需点击链接即可加入对局,无需安装任何内容。但它也引入了一种原生客户端不会遇到的连接失败情况。
通过 HTTPS 提供的游戏页面通常无法打开普通的 ws:// 连接:浏览器会将其作为混合内容阻止(websocket.org)。玩家看不到任何提示;唯一的迹象是浏览器控制台中的错误。在本地 http:// 页面上测试的版本可能通过所有测试,但对所有真实玩家来说依然会失败。
在首次公开试玩之前,一个有用的检查步骤是:从玩家将使用的 HTTPS 地址打开游戏版本,加入对局,并在浏览器控制台中查看 WebSocket 是否被阻止或失败。每当托管页面或服务器地址发生变化时,都应重复此检查。
在 Edgegap 上,WebSocket 端口可以使用托管证书:将端口设置为启用 TLS 升级的 WS,并让客户端使用 wss:// 连接到部署的 Edgegap URL。拥有自己域名的工作室可以使用自己的证书配置 WSS(Edgegap 文档)。关于浏览器游戏背后的传输协议选择,请参阅 UDP 与 TCP。
,










