了解Edgegap的工作原理

了解Edgegap的工作原理

LightNet Relay

部署至 Edgegap

适用于 Unity 的 LightNet 中继:如何在专属服务器上运行可扩展中继服务,支持房间代码与可选游戏逻辑

已发布

已发布

最近一次准确性审核

最近一次准确性审核

LightNet 中继集成指南:在适用于 Unity 的 Edgegap 专属服务器上运行开源 LightNet 中继

本指南将向您展示如何运行 Edgegap 复刻版的 LightNet。LightNet 是一款开源中继服务,您可以在 Edgegap 的专用服务器上运行它,并可以使用您自己的游戏逻辑对其进行扩展,以便让您主机-客户端(host-client)架构 Unity 游戏中的玩家能够主持比赛并通过房间代码加入,或者通过 Edgegap 可选的配对系统进行匹配。该示例适用于 Mirror、Fish-Networking、PurrNet 和 Netcode for GameObjects,只需一项设置即可选择所用的网络代码。

您可以将其视为升级版的点对点(P2P)连接。开箱即用状态下,中继负责转发流量,主机的游戏客户端拥有该场比赛的控制权。加入游戏逻辑后,它就能在相同的代码和部署下,变成一个具备中继般资源效率的多房间专用服务器。从一开始就发生改变的是流量的流向。每个玩家都向外连接到您位于所选位置的中继,因此没有人需要开放端口,没有任何玩家能看到其他玩家的 IP 地址,也没有共享的中继网络来决定您的网络路由。Edgegap 的复刻版本还允许玩家通过 WebSocket 进行连接(包括从浏览器中的 Unity WebGL 构建版本连接),而上游的 LightNet 以及 Steam 和 Epic 的中继并不支持该功能。

一旦您的中继完成容器化,Edgegap 即可通过简单的 API 调用将其部署——可部署在边缘云(Edge Cloud)上用于测试,或部署在 Private Fleets 上以实现持续运行的中继。单个中继即可同时为多个房间提供服务。

本指南涵盖:

  1. 开始前的准备工作

  2. 将您的编码智能体连接到 Edgegap(可选)

  3. 在示例中选择您的网络代码

  4. 将中继容器化并创建应用版本

  5. 部署中继并连接玩家

  6. 使用房间代码对玩家进行分组

  7. 使用 Edgegap 配对系统匹配玩家,包括加入正在进行的比赛(可选)

  8. 双人测试

您可以通过两种方式进行操作,也可以结合使用:

  • 使用编码智能体:连接到 Edgegap MCP 服务器 及其 智能体技能 后,您的智能体可以构建并推送中继镜像、创建应用版本、进行部署、读取其日志并停止它。

  • 手动操作:以下每个步骤在没有智能体的情况下也同样适用。

在此,我们使用 Edgegap 的 LightNet 中继示例:包含中继本身,以及基于全部四种网络代码通过该中继运行的 Mirror Tanks 游戏。

无需信用卡。免费版包含部署真实游戏服务器所需的资源。

无需信用卡。免费版包含部署真实游戏服务器所需的资源。

哪种配置适合你的游戏?

可扩展中继(extensible relay)是将玩家聚集在同一场比赛中的六种方式之一。它们在谁拥有比赛以及比赛在何处运行方面存在差异:

配置

比赛归属方

最适合

点对点(Peer-to-peer)

玩家的设备

本地或局域网模式的游戏

共享中继服务(Steam、Epic Online Services、Unity Relay)

房主玩家

连接失败时的快速解决方案

专用服务器上的可扩展中继(本指南)

房主玩家

互相信任的玩家之间的合作模式和私人房间,或使用 Edgegap 的撮合系统配合专属中继与路由进行快速匹配;可添加游戏逻辑以将其扩展为多房间游戏服务器

多房间游戏服务器

服务器

对延迟容忍度高的游戏,例如即时战略(RTS)、卡牌和回合制游戏,在一个中央进程中运行多场比赛

小型专用服务器

服务器

注重公平性的比赛,每场比赛都在部署在离玩家最近的分数型 vCPU 服务器上运行

完整专用服务器

服务器

全物理/逻辑模拟、大型比赛和反作弊

可扩展中继能为您带来什么:

  • 隐藏玩家的 IP 地址:所有人都对外连接到中继,因此玩家之间绝不会直接建立连接。这就杜绝了针对玩家连接的攻击(例如泛洪攻击房主),而点对点网络则无法防范此类风险。

  • 无需端口转发,无 NAT 问题:包括直接点对点连接经常失败的移动网络环境。

  • 自主掌握路由与节点位置:将中继部署在玩家所在的位置。使用免费中继服务时,多家工作室反馈“完全无法控制这些玩家的路由走向”(2024 年 9 月在线服务游戏峰会演讲)。

  • 无共享网络干扰:其他中继网络上的路由变更或中断故障不会波及您的游戏。

  • 无需重写:您的主机-客户端网络代码保持原样,无需在游戏中引入任何中继供应商的 SDK。

  • 自主扩展:您拥有中继代码的所有权,因此可以添加自己的业务逻辑:房间密码或玩家验证、速率限制、踢人与封禁、房间数据、遥测、大厅钩子(hooks)。Steam 和 Epic 等共享中继服务不允许您添加自定义代码。

  • 扩展为游戏服务器:加入游戏逻辑后,它就能在相同的代码和部署架构上,变成一个具备中继级资源效率的多房间专用服务器。

  • 匹配,支持 Edgegap 或自定义方案:借助 Edgegap 的可选撮合系统,点击“查找比赛”的玩家会优先加入附近中继(进入有空位的房间或在其上新建房间),然后才会部署新的中继。或者也可以保留房间代码,通过您自己的大厅、好友列表或 Steam 及 Epic 邀请进行分发。

  • WebSocket(仅限 Edgegap 分支):玩家可以通过单个 WebSocket 连接,而非 TCP 和 UDP;配合 Edgegap 的 TLS 升级使用 wss://,无需管理证书,甚至支持浏览器中的 Unity WebGL 构建版本。两种类型的玩家可以共享同一个房间。上游的 LightNet 不支持 WebSocket,Steam 和 Epic 的中继同样不支持。

它的局限性:

  • 无法开箱即用地防止作弊:谁持有比赛状态,谁就能修改它;在默认交付形式下,房主的游戏客户端持有该状态。作弊者会破坏所有人的比赛体验,无论休闲模式还是排位模式。服务器权威(Server authority)可以制止这种行为:添加游戏逻辑以使中继掌管比赛(由于中继仅能看到原始网络代码流量,这意味着需要在服务器上重构游戏规则),或者为每场比赛迁移到小型专用服务器。多房间服务器在单一地点运行,因此需要每个区域部署一个:远离服务器的玩家在延迟和公平性方面会劣于靠近服务器的玩家。

  • 房主离开时无法维持比赛:中继会关闭房间并断开其他玩家的连接。

  • 与陌生人对战时无法保证比赛公平:示例包含可选的匹配功能。Edgegap 撮合系统会将地理位置相近的玩家编组,并将他们的比赛分配到附近的某个中继上,但房主的游戏客户端仍然掌握着比赛所有权。对于与陌生人进行的公开比赛(无论是休闲还是排位),请将比赛交由服务器托管。

  • 无法实现端到端加密:默认传输采用明文 TCP 和 UDP。带有 Edgegap TLS 升级的可选 wss:// 连接会对每个玩家与 Edgegap 之间的流量进行加密,但中继和房主的游戏客户端依然能够看到这些内容。对于房间代码模式,在您添加自定义玩家验证之前,任何拥有中继地址和有效代码的人都可以加入。使用撮合系统时,中继仅将房间代码发放给完成匹配的玩家票据。

  • 无法在后台标签页中保持浏览器房主的房间持续运行:浏览器会限制隐藏标签页的资源,因此在浏览器中托管的房间会冻结,直到该标签页被重新切回。建议优先选用桌面端作为主机。关于由服务器掌管比赛所有权的网页浏览器游戏,请参阅 Browser Games、Colyseus 或 Manus AI。

适用场景:

  • 主要适用:合作游戏、包括超休闲在内的移动游戏、好友间或私人房间内的实时 PvP、即时战略(RTS)和集换式卡牌游戏(TCG),以及浏览器中的 Unity WebGL 游戏——所有这些均无需服务器逻辑。其他游戏类型也可能适用。

  • 有关合作模式的具体分析,请参阅为什么休闲合作游戏也需要专用游戏服务器。

  • 有关各种网络模型的横向对比,请参阅权威服务器、中继与点对点。

分步指南

详细集成步骤

1. 开始之前

  • 一个免费的 Edgegap 账户。请验证您的电子邮箱。测试无需信用卡。

  • Unity 6000.0.54f1 (Unity 6),示例所使用的版本。PurrNet 需要 Unity 2022.3 或更高版本。

  • 用于构建中继镜像的 Docker。此处不涉及其他容器化工具。仅在 Docker 之外构建中继时才需要 .NET 8 SDK。

  • 针对代理路径:一个 Edgegap API 令牌,获取自 控制面板 → 用户设置 → 令牌。它是组织级别的,因此请像对待密码一样对待它:切勿将其放入您的项目中、游戏客户端或聊天中。

Git:Unity 需要在 PATH 中配置 Git 客户端(2.14.0 或更高版本),以便从 Git URL 安装软件包,例如本示例中的 PurrNet 和 Edgegap Unity SDK(由可选的匹配系统使用)。macOS 通常已经内置了一个(Xcode 命令行工具);在 Windows 上,请安装 Git。

克隆示例:git clone https://github.com/edgegap/server-sample-lightnet-relay.git

2. 将您的代码代理连接到 Edgegap

如果您全程手动操作,请跳过此步骤。

Edgegap MCP 服务器允许您的智能体对您的账户执行操作:推送镜像、创建应用版本、部署、读取日志以及停止部署。这些技能包含了经过测试的工作流。一旦上线,MCP 服务器还可以检查实例集健康状况、跨部署搜索日志并在回滚前对比两个版本。

Claude Code:安装 Edgegap 插件。它会同时添加 MCP 服务器和技能,并在安装期间提示输入您的 API 令牌(存储在系统的凭据存储中):

运行 /plugin marketplace add edgegap/llm-agent-skills,然后运行 /plugin install edgegap@edgegap。重启会话。

如果只需要 MCP 服务器而不需要插件?请在您自己的终端中运行以下命令:claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp -H "Authorization: token YOUR_EDGEGAP_API_TOKEN" --scope user。请勿同时执行这两种操作,否则会出现两个 edgegap 服务器。

Cursor、VS Code 以及其他支持发送请求头的客户端:添加 https://mcp.edgegap.dev/mcp 并附带请求头 Authorization: token YOUR_EDGEGAP_API_TOKEN,然后使用 npx skills add edgegap/llm-agent-skills --skill "*" 安装技能。对于监控类智能体,还可以添加请求头 X-Edgegap-Read-Only: 1:它只具有读取权限,无法更改任何内容。

Claude Desktop:自定义连接器无法发送请求头,因此请改用本地服务器(需要 Node 18+):{ "mcpServers": { "edgegap": { "command": "npx", "args": ["-y", "@edgegap/mcp"] } } }。它会在首次使用时请求输入令牌。

检查是否正常运行:

列出我的 Edgegap 应用。

返回空列表是正常的。您的智能体可能还会指出专用服务器将为您的游戏服务器提供权威控制权(Host Authority):这符合预期,因为中继方式会将比赛控制权保留给主机。

3. 在示例中选择您的网络代码

在 Unity Hub 中打开 tanks/ 文件夹。网络代码(netcode)是 tanks/Assets/Tanks/Resources/TanksSettings.asset 中的一个字段 netcode:Mirror、FishNet、PurrNet 或 NGO。同一个资产还包含中继地址和端口,以及可选的匹配器设置(默认关闭)。其他切换方式:

  • 在编辑器中:Tanks > Netcode > Mirror / FishNet / PurrNet / NGO 可设置该资产并打开对应网络代码的场景。

  • 在游戏中:在主持(Host)或加入(Join)之前,点击 HUD 顶部的网络代码按钮。

  • 通过命令行:-netcode FishNet。

主机和玩家必须使用相同的网络代码。一个构建版本包含所有这四种网络代码。

网络代码

示例中的版本

中继传输层

Mirror

66.0.9

MirrorRelayTransport

Fish-Networking

4.7.4

FishNetRelayTransport

PurrNet

1.24.1

PurrNetRelayTransport

Netcode for GameObjects

1.13.0

NgoRelayTransport

每个传输层都封装了 RelayPeer,即示例 LightNet 包含中独立于网络代码的中继客户端。可靠消息通过 TCP 传输,不可靠消息通过 UDP 传输,每条消息最多支持 16 KB 可靠数据和 1,177 字节不可靠数据。玩家也可以通过单个 WebSocket 连接:为游戏提供 ws:// 或 wss:// 中继地址。通过 WebSocket,不可靠消息也会按顺序可靠传输,这相比快节奏射击游戏更适合合作和回合制游戏。使用 TCP + UDP 的玩家与使用 WebSocket 的玩家可以共享同一个房间。

在浏览器中:通过 Tanks > Build WebGL client 构建 WebGL 客户端。浏览器没有 TCP 或 UDP 套接字,因此 WebGL 构建版本通过一个小型桥接程序连接到浏览器自身的 WebSocket,采用 wss:// 协议,支持全部四种网络代码,并能与桌面玩家进入相同房间。它从页面 URL 中读取选项,例如 index.html?relay=wss://<host>.pr.edgegap.net:<port>&host 或 &join=CODE,以及 &netcode=FishNet。请使用 wss:// 地址:通过 HTTPS 提供的页面无法打开 ws://。

用于您自己的游戏?将 LightNet/ 包以及适用于您网络代码的传输层复制到项目中,并将其设置为您的 Network Manager 的传输层。您的游戏将像平常一样继续主持比赛。

“在我使用 {netcode} 的 Unity 项目中,添加来自 Edgegap 的 server-sample-lightnet-relay 仓库的 LightNet 包及其 {netcode} 中继传输层。将其设置为 Network Manager 的传输层,从设置资产中读取中继地址和端口,并添加主持(Host)和加入(Join)房间按钮:Host 显示 6 位字母房间代码,Join 接收一个代码。不要更改我的游戏逻辑。”

4. 将中继容器化并创建应用版本

该中继是一个带有专属 Dockerfile 的 .NET 8 控制台应用程序。即使在 Apple Silicon 上,也请在代码仓库根目录下针对 Edgegap 平台进行构建:

docker build --platform linux/amd64 -f relay-server/Dockerfile -t registry.edgegap.com/<project>/lightnet-relay:<tag> .

先在本地机器上测试它:docker run --rm -p 7777:7777/tcp -p 7777:7777/udp -p 7778:7778/tcp registry.edgegap.com/<project>/lightnet-relay:<tag>。日志应显示“LightNet relay listening on TCP 7777, UDP 7777”。

推送到 Edgegap 容器镜像仓库(Container Registry):自行运行 docker login registry.edgegap.com,输入来自容器镜像仓库页面的用户名和令牌,然后执行 docker push。每次构建都使用新标签,切勿使用 latest。

然后在控制面板中创建应用程序及其版本:

  • 填写您的镜像和标签,以及镜像仓库登录信息(注册表配置文件,或者来自容器镜像仓库页面的用户名和令牌;若缺少该信息,部署将失败并提示“Unable to pull image from registry”)。

  • 一个端口:7777,协议 TCP/UDP,命名为 relay。分别填写 7777 TCP 和 7777 UDP 这两个单独条目会被视为重复项而拒绝。对于可选的加密 WebSocket,添加第二个端口:7778,协议 WS,开启 TLS Upgrade,命名为 relay-ws。然后玩家连接到 wss://<host>.pr.edgegap.net:<its external port>。

  • 资源分配从小规格开始:中继不运行任何游戏逻辑。若要根据实际流量调整规模,可通过添加信用卡(按需付费)退出免费套餐:这将解锁详细的部署指标,以便您在生产环境中查看中继的 CPU、内存和网络使用情况并进行调整。

  • 可选环境变量:RELAY_MAX_PEERS(每个中继的玩家数,默认 256)和 RELAY_IDLE_EXIT_SECONDS(在没有房间的情况下闲置多少秒后中继退出;默认 600,即空闲中继在 10 分钟后自动停止;0 表示永不退出)。RELAY_WS_PORT 用于设置 WebSocket 端口(默认 7778,设为 0 则关闭)。由撮合器(matchmaker)启动的中继会在其最后一个房间结束时自行停止。对于撮合器,还需添加 MATCHMAKER_URL 和 MATCHMAKER_TOKEN,并可选择性添加 RELAY_MATCH_MAX_PLAYERS(每个房间的玩家数,默认 4)、RELAY_MAX_ROOMS(每个中继的房间数,默认 4)以及 RELAY_SOLO_ROOM_SECONDS(默认 120):详见步骤 6。

使用您的 Agent:

“加载 edgegap-containerize 技能。在代码仓库根目录下,根据 relay-server/Dockerfile 为 linux/amd64 构建 LightNet 中继,使用新标签将其推送到 Edgegap 镜像仓库,然后为其创建一个 Edgegap 应用和应用版本:一个名为 relay、协议为 TCP/UDP 的 7777 端口,小规格资源,重启策略设为 never。”

5. 部署中继并连接玩家

从控制面板部署您的版本(Deploy,选择靠近玩家的位置),或指示您的智能体:

“在我附近部署我的 LightNet 中继版本,等待其就绪,显示日志,并提供主机 URL 和外部端口。”

当部署状态为 Ready 时,玩家即可连接到其主机 URL(<id>.pr.edgegap.net)和外部端口。Edgegap 会将 TCP 和 UDP 映射到同一个外部端口,因此玩家只需传递一次:

  • 在示例中:在 TanksSettings.asset 中设置中继地址和端口,或在命令行中使用 -relay <host>.pr.edgegap.net -relayPort <external port>。

  • 在中继日志中,启动后立即连接并离开的对等节点是 Edgegap 的就绪状态检查,而不是玩家。

保持中继运行:

  • 免费层:部署将在 60 分钟后停止,这足够用于测试。

  • Edge Cloud:部署旨在 24 小时内回收,运行时间过长时会收到警告。Edge Cloud 还会按出站流量计费,而中继会转发每场比赛的每个字节。因此,它可能非常适合按需使用、开发、游戏测试和前期制作;但在大规模场景下,我们建议工作室使用专属队列(Private Fleets)以获得更高的成本效益。

  • 专属队列(Private Fleets):一旦您的游戏上线且中继需要全天候运行,专属队列通常是更合适的选择:在全球 58 个位置提供预留主机,每台主机包含 6 TB 出站流量,足以满足绝大多数游戏的需求,并支持通过持久性设置来决定每个中继的运行时间。

  • 回收:在任何配置下,定期回收中继都是最佳实践,因为全新的游戏服务器才是健康的服务器(请参阅 Edgegap 的部署生命周期)。何时、如何以及多久回收一次取决于您的游戏,持久性指南介绍了如何在不影响玩家体验的情况下规划重启。每个区域的一种简便方法是:启动一个新中继,将其中继地址分配给主持新房间的玩家,并在旧中继的最后一个房间结束后将其停止。

  • 匹配中继:配合匹配系统使用时,中继会在 Edge Cloud 上首批玩家附近启动,最多可容纳 4 个房间。最后一个房间结束时它会自动停止,因此仅在玩家进行游戏时计费。在免费层上,一次只能运行一个部署(一个中继),且匹配系统在每次启动 3 小时后关闭。

  • 测试部署:测试完成后,请务必从控制面板或通过智能体将其停止,因为部署在运行时就会持续计费。

6. 玩家分组:房间代码或匹配机制

该示例通过两种方式为玩家分组:房间代码,或者(可选的)Edgegap 的匹配器。

使用房间代码:

  1. 一名玩家点击Host(主持)。中继将创建一个房间并返回一个 6 位字母的代码,显示在 HUD 中。

  2. 房主分享该代码:在组队界面、好友列表、聊天或 Discord 消息中。

  3. 其他玩家输入该代码并点击Join room(加入房间)。

代码跳过了字母 I 和 O,因此易于大声朗读。只要房主留在房间内,房间就会一直保留:当房主离开时,中继将关闭房间并断开其他人的连接。房主也可以踢出玩家。

要将此功能引入您的游戏中,请在您自己的 UI 中显示该代码,并通过现有的任何玩家连接途径进行传递,例如 Steam 或 Epic Online Services 好友邀请。

使用 Edgegap 匹配器(可选,默认关闭):

  1. 在控制面板中,打开 Matchmaker → Create Matchmaker。从代码仓库上传 matchmaker-config.json,将 application.name 和 version 设置为您的中继应用版本,然后点击 Create and Start。该文件使用匹配器 3.3.3、casual 配置文件和 30 秒的票据过期时间。在其前 10 秒内,票据只能加入正在运行的中继;随后 2 到 4 名等待中的玩家将获得一个新中继。延迟规则仅在每位玩家到 Edgegap 信标的延迟至多为 150 ms 且彼此的 ping 差值至多为 100 ms 时,才将他们聚在一起。

  2. 在您的中继应用版本中,添加环境变量 MATCHMAKER_URL 和 MATCHMAKER_TOKEN:即匹配器的 API URL 和 Auth Token。如果没有它们,中继将记录日志“backfill: off”,并且其房间绝不接收后续玩家。

  3. 在 TanksSettings.asset 中,开启 Use Matchmaker 并粘贴相同的 API URL 和 Auth Token。该令牌可以安全地随游戏客户端一同发布。游戏会在每个票据中将其 ping 发送到 Edgegap 的信标(matchmakerLatencyBeacons,默认开启)。命令行版本:-matchmaker <url> -matchmakerToken <token> -findMatch。如需通过 wss:// 连接,还要开启 matchmakerUseWebSocket (-matchmakerWebSocket)。

  4. 玩家点击 Find Match。如果附近的中继有空位,玩家将加入其中:优先加入有空位的房间,否则在该中继上新建一个房间并由该玩家主持。如果没有中继有空位,约 10 秒后匹配器会为附近 2 到 4 名等待中的玩家部署一个新的中继。第一位进入房间的匹配玩家将主持该房间,其他玩家会自动加入,无需输入代码。

  5. 每个中继最多可容纳 4 个最多 4 人的房间(RELAY_MAX_ROOMS,RELAY_MATCH_MAX_PLAYERS),并保持最多 5 个回填(backfill)请求处于开启状态:这些是向匹配器发送的请求,携带中继的地址及其玩家的 ping。它仅在房间满载后才提供新房间,因此两名同时搜索的玩家最终会分在一起。

  6. 当房主独处 2 分钟(RELAY_SOLO_ROOM_SECONDS)时,会收到提示,游戏会自动重新开始搜索。当房主离开时,该房间关闭。一旦最后一个房间结束,中继将关闭其回填请求并停止自身部署,从而停止计费。

在没有匹配器的情况下部署的中继仍可继续使用房间代码。玩家可以加入正在进行中的房间,因此您的游戏必须像 Tanks 一样允许玩家在中途加入。该示例一次为一个玩家排队;对于组队,请添加 backfill_group_size 规则,以使队伍所占用的空位永远不会超过房间的剩余空位数。浏览器无法 ping 信标,因此 WebGL 构建版本需要一个不包含延迟规则的配置文件。

“加载 edgegap-matchmaking 技能。为我的 LightNet 中继应用版本构建匹配器配置(版本 3.3.3):配置文件 casual,1 个队伍,最初最小和最大队伍大小为 9999,以便票据仅通过回填加入运行中的中继,然后在 10 秒后扩展为 2 到 4 名玩家,添加信标延迟规则(最大延迟 150 ms,差值 100 ms)以及 30 秒的票据过期时间。告诉我如何在控制面板中创建它,将 MATCHMAKER_URL 和 MATCHMAKER_TOKEN 添加到我的应用版本中,并在 TanksSettings.asset 中开启 Use Matchmaker 的同时填入 URL 和令牌。”

与陌生人匹配:匹配器会将陌生人分配到同一个房间,但房主的游戏客户端仍然拥有该房间的控制权,因此作弊的房主可能会破坏游戏体验,且当房主离开时,房间内所有人(包括后加入者)的房间都会结束。对于公开的休闲赛或排位赛,请将比赛交给服务器:使用您的游戏逻辑扩展中继,或者从 Mirror Networking、Fish-Networking、PurrNet 或 Netcode for GameObjects 开始,它们涵盖了专用服务器和 Edgegap 的匹配端到端支持。

7. 双人测试

  1. 构建 Windows 客户端:Tanks > Build Windows client。

  2. 启动两个副本。在第一个副本中,点击 Host 并记下房间代码。在第二个副本中,输入该代码并点击 Join room。

  3. 两辆坦克都会出现在两个游戏中。进行驾驶和开火操作:主机可以看到另一辆坦克的移动以及其发射的炮弹击中目标。

自动化测试:在中继运行的情况下,./e2e.sh <host>.pr.edgegap.net <external port> 会在每个网络代码(netcode)上启动一个主机和一个客户端,并检查两个游戏是否都能看到两辆坦克、可靠和不可靠数据是否都通过了中继,以及发射物是否生成。指定网络代码名称可仅测试其中部分:./e2e.sh <host>.pr.edgegap.net <external port> FishNet NGO。它会从 Bash Shell(例如 Git Bash)运行 Windows 构建版本。该示例于 2026 年 10 月 29 日在 Edgegap 上针对所有四种网络代码均通过了此项测试。

结合匹配系统:启动两个副本,并在两者中均点击 Find Match。一个作为主机,另一个加入。自动化方式:./e2e-matchmaker.sh <matchmaker url> <token> 会在每个网络代码上通过匹配系统运行游戏(添加 FishNet NGO 可仅测试其中部分)。在其前缀添加 BACKFILL=1 可在稍后加入第三个玩家,添加 MULTIROOM=1 可填满一个房间并在同一中继上托管并加入第二个房间,或添加 MM_WEBSOCKET=1 以通过 wss:// 运行。使用来自蒙特利尔的真实 ping 测试,该示例于 2026 年 11 月 2 日在 Edgegap 上针对所有四种网络代码均通过了所有这些测试:第二个房间结束时第一个房间仍在继续游戏,每个中继在最后一个房间结束后自行停止,且具有远距离 ping 的玩家从未被放入正在进行的房间中。通过带有房间代码的 WebSocket:./e2e.sh wss://<host>.pr.edgegap.net:<port> 0。

在浏览器中:从任何静态文件服务器托管 tanks/Builds/WebGL,并在 URL 中使用 wss:// 中继地址将其打开。该示例于 2026 年 11 月 9 日在 Edgegap 上通过了测试,测试环境为无头 Chrome 中的 WebGL 构建版本,通过多伦多的中继,涵盖所有四种网络代码:桌面主机与浏览器客户端、浏览器主机与桌面客户端,以及浏览器主机与浏览器客户端。

完成后停止部署。

后续步骤

后续步骤

准备好使用服务器权威模型了吗?没有主机优势,没有作弊房主,即使有人离开比赛也能继续进行:请参阅 Mirror Networking、Fish-Networking、PurrNet 和 Netcode for GameObjects 的指南。或者,使用您自己的游戏逻辑扩展 LightNet 中继。比起自行运行,更倾向于托管式中继服务?请参阅 Unity Relays。

遇到问题?欢迎在 Edgegap Discord 上向我们的团队和其他工作室寻求帮助。

常见问题

关于在专属服务器上为宿主-客户端(Host-Client)架构的 Unity 游戏运行可扩展 LightNet 中继的常见问题。

什么是 LightNet?

LightNet 是一个轻量级、开源的 C# 网络库 (Apache 2.0),具有服务器和客户端模式、可靠和不可靠信道,并且没有内置的游戏逻辑。Edgegap 的分支将其作为中继运行:一个在容器中运行的 .NET 8 应用程序,用于在每个房间的主机玩家与其他玩家之间转发流量,并添加了 WebSocket 连接(包括来自 Unity WebGL 构建的连接)、支持穿透 NAT 的 UDP,以及 Edgegap 匹配器支持。

可扩展中继是专用游戏服务器吗?

无法开箱即用。它在专用服务器上运行,但出厂自带状态下不运行任何游戏逻辑:由房主玩家的游戏控制比赛,类似于点对点(P2P)模式。相比点对点和共享中继服务,它的优势在于拥有您自己的中继:隐藏的 IP 地址、无需端口转发、可选的服务器位置,以及可扩展的代码。在中继中加入游戏逻辑后,它就会变成一个具备中继般资源利用效率的多房间专用服务器。

使用中继服务器能防止作弊吗?

单靠它自身不行。谁掌握对局状态,谁就能对其进行更改,而在使用中继的情况下,这取决于主机的游戏。作弊者会毁掉所有人的比赛,无论休闲模式还是排位模式皆是如此。LightNet 中继确实可以阻止针对玩家网络连接的攻击,因为任何人都看不到其他玩家的 IP 地址。防止作弊需要服务器权威性:添加游戏逻辑以使中继掌握对局,或者每场比赛使用一个小型专用服务器。

该示例支持哪些网络代码(netcode)?

Mirror、Fish-Networking、PurrNet 以及 Netcode for GameObjects,集成于一个 Unity 6 构建中,只需一项设置即可切换。中继不知道使用的是哪种网络代码:它只负责转发字节。另一种网络代码则需要在示例的 RelayPeer 客户端周围构建自己的传输层。

这与 Edgegap 的 Unity Relay 有何不同?

Unity Relays 是 Edgegap 的托管式分布式中继(Distributed Relays):您通过 API 调用为每场比赛创建一个会话,并由 Edgegap 选择中继。而通过 LightNet,您可以将中继作为 Edgegap 部署自行运行,使用您自己的代码和房间代码,自行选择运行位置,并可以使用您自己的逻辑进行扩展。Edgegap 的托管中继仅支持 UDP,因此浏览器 (WebGL) 构建无法使用它们;而 LightNet 的 WebSocket 连接则可以使用。

玩家在没有房间代码的情况下可以进行匹配吗?

是的。开启示例的可选 Edgegap 匹配功能。玩家点击“查找比赛”(Find Match):如果附近的 Relay 中继服务器有空位,他们就会加入其中,进入正在运行的房间或新建的房间;否则,匹配系统会将彼此靠近的玩家分在一组,并为他们启动一个中继服务器。该中继服务器会挑选一名玩家作为每个房间的主机,并且只允许匹配成功的玩家加入。与使用房间代码一样,主机的游戏仍然掌控着比赛。更倾向于使用您自己的大厅或匹配系统?保留房间代码并通过它进行传递即可。

客户

了解更多已接入 Edgegap 的客户案例

提供 31 个从其他平台迁移至 Edgegap 的工作室案例研究。

他们选择 Edgegap 的关键原因

了解 Edgegap 自动化游戏服务器编排如何带来无缝的多人游戏体验。

费用

定价

定价

通过混合编排优化成本与性能

通过混合编排优化成本与性能

通过混合编排优化成本与性能

边缘云

按需

$0.00115

/ vCPU

/ 分钟

按分钟计费,仅按实际使用量收费

只有在玩家在线玩游戏时才需付费。0 个活动服务器 = $0

在全球 615 多个边缘云节点中按实例部署游戏服务器。零承诺。

只需添加信用卡。

边缘云

按需

$0.00115

/ vCPU

/ 分钟

按分钟计费,仅按实际使用量收费

只有在玩家在线玩游戏时才需付费。0 个活动服务器 = $0

在全球 615 多个边缘云节点中按实例部署游戏服务器。零承诺。

只需添加信用卡。

专属物理机集群 (裸金属)

预留容量

$0.0261

/ vCPU

/ 小时

按月计费,始终开启

每个主机每月 $280(12个月标准价),或按月支付每月 $350

通过无出站流量费用的专用机队托管,优化您游戏服务器的成本效益。

持久在线,24/7全天候可用,您的工作室专属。

专属物理机集群 (裸金属)

预留容量

$0.0261

/ vCPU

/ 小时

按月计费,始终开启

每个主机每月 $280(12个月标准价),或按月支付每月 $350

通过无出站流量费用的专用机队托管,优化您游戏服务器的成本效益。

持久在线,24/7全天候可用,您的工作室专属。

您的账单因费率和使用量而异;这可能会根据游戏类型、玩家人数等因素而有所不同。

您的账单因费率和使用量而异;这可能会根据游戏类型、玩家人数等因素而有所不同。

使用我们的预估计算器模拟您的用量 ->

使用我们的预估计算器模拟您的用量 ->

Edgegap 的功能与价格:边缘云与私有集群(Private Fleets)详细对比

Edgegap 的功能与价格:边缘云与私有集群(Private Fleets)详细对比

对比

免费试用

边缘云

Private Fleets

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

在帐户中添加信用卡后,即可解锁各项功能。

对比

免费试用

边缘云

Private Fleets

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

在帐户中添加信用卡后,即可解锁各项功能。

对比

免费试用

边缘云

Private Fleets

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

在帐户中添加信用卡后,即可解锁各项功能。