适用于 Unity 的 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 上以实现持续运行的中继。单个中继即可同时为多个房间提供服务。
本指南涵盖:
开始前的准备工作
将您的编码智能体连接到 Edgegap(可选)
在示例中选择您的网络代码
将中继容器化并创建应用版本
部署中继并连接玩家
使用房间代码对玩家进行分组
使用 Edgegap 配对系统匹配玩家,包括加入正在进行的比赛(可选)
双人测试
您可以通过两种方式进行操作,也可以结合使用:
使用编码智能体:连接到 Edgegap MCP 服务器 及其 智能体技能 后,您的智能体可以构建并推送中继镜像、创建应用版本、进行部署、读取其日志并停止它。
手动操作:以下每个步骤在没有智能体的情况下也同样适用。
在此,我们使用 Edgegap 的 LightNet 中继示例:包含中继本身,以及基于全部四种网络代码通过该中继运行的 Mirror Tanks 游戏。
哪种配置适合你的游戏?
可扩展中继(extensible relay)是将玩家聚集在同一场比赛中的六种方式之一。它们在谁拥有比赛以及比赛在何处运行方面存在差异:
配置 | 比赛归属方 | 最适合 |
|---|---|---|
玩家的设备 | 本地或局域网模式的游戏 | |
共享中继服务(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 |
|
Fish-Networking | 4.7.4 |
|
PurrNet | 1.24.1 |
|
Netcode for GameObjects | 1.13.0 |
|
每个传输层都封装了 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 的匹配器。
使用房间代码:
一名玩家点击Host(主持)。中继将创建一个房间并返回一个 6 位字母的代码,显示在 HUD 中。
房主分享该代码:在组队界面、好友列表、聊天或 Discord 消息中。
其他玩家输入该代码并点击Join room(加入房间)。
代码跳过了字母 I 和 O,因此易于大声朗读。只要房主留在房间内,房间就会一直保留:当房主离开时,中继将关闭房间并断开其他人的连接。房主也可以踢出玩家。
要将此功能引入您的游戏中,请在您自己的 UI 中显示该代码,并通过现有的任何玩家连接途径进行传递,例如 Steam 或 Epic Online Services 好友邀请。
使用 Edgegap 匹配器(可选,默认关闭):
在控制面板中,打开 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 时,才将他们聚在一起。
在您的中继应用版本中,添加环境变量 MATCHMAKER_URL 和 MATCHMAKER_TOKEN:即匹配器的 API URL 和 Auth Token。如果没有它们,中继将记录日志“backfill: off”,并且其房间绝不接收后续玩家。
在 TanksSettings.asset 中,开启 Use Matchmaker 并粘贴相同的 API URL 和 Auth Token。该令牌可以安全地随游戏客户端一同发布。游戏会在每个票据中将其 ping 发送到 Edgegap 的信标(matchmakerLatencyBeacons,默认开启)。命令行版本:-matchmaker <url> -matchmakerToken <token> -findMatch。如需通过 wss:// 连接,还要开启 matchmakerUseWebSocket (-matchmakerWebSocket)。
玩家点击 Find Match。如果附近的中继有空位,玩家将加入其中:优先加入有空位的房间,否则在该中继上新建一个房间并由该玩家主持。如果没有中继有空位,约 10 秒后匹配器会为附近 2 到 4 名等待中的玩家部署一个新的中继。第一位进入房间的匹配玩家将主持该房间,其他玩家会自动加入,无需输入代码。
每个中继最多可容纳 4 个最多 4 人的房间(RELAY_MAX_ROOMS,RELAY_MATCH_MAX_PLAYERS),并保持最多 5 个回填(backfill)请求处于开启状态:这些是向匹配器发送的请求,携带中继的地址及其玩家的 ping。它仅在房间满载后才提供新房间,因此两名同时搜索的玩家最终会分在一起。
当房主独处 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. 双人测试
构建 Windows 客户端:Tanks > Build Windows client。
启动两个副本。在第一个副本中,点击 Host 并记下房间代码。在第二个副本中,输入该代码并点击 Join room。
两辆坦克都会出现在两个游戏中。进行驾驶和开火操作:主机可以看到另一辆坦克的移动以及其发射的炮弹击中目标。
自动化测试:在中继运行的情况下,./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 的工作室案例研究。

《以太之战 2》完美的全球发布
Aether Studios
了解Aether Studios是如何快速添加Edgegap并向他们的社区交付完美的启动和后启动服务的。
案例研究

克服因虚拟现实在竞技Multiplay中使用WiFi而引入的延迟
Halfbrick Studios
Discover how Halfbrick successfully launched & maintains a multiplayer-focused Early Access on META Quest's VR platform.
案例研究

MENA的社交应用添加了在线游戏
WOLF
了解这款在中东和北非地区广受欢迎的社交应用如何轻松地将 matchmaking 和多人游戏编排添加到 WOLF Qanawat。
案例研究

混合编排让开球策略随时应对任何流量做好准备
Birch Games
混合编排如何帮助 Birch Games 应对流量——将免流出费用的 Fleets 与无区域限制云相结合。
案例研究

真实的在线战争需要终极的协调
Highwire Games
了解Highwire对性能的需求如何需要只有Edgegap才能提供的编排。
案例研究

22,000 条评价、4.8 颗星以及自动扩展的基础架构
Sinn Studios
一个由 Slack 提供支持的简单集成,如何让 Sinn Studio 的热门 VR 游戏快速上线并保持稳定运行。
案例研究

动态服务器编排
Under NDA - AAA Studio
了解世界上最大的AAA工作室之一如何通过边缘计算改善其对等多人游戏体验。
案例研究

对于 AAA 格斗游戏的近零延迟
AAA Studio - Under NDA
一个未宣布的项目如何实现了最低延迟,并改善了其1v1游戏中的公平性。
案例研究

Play Gods with Multiplayer Physics
Squido Studio
Learn how Squido uses Edgegap's highligh optimized game servers to deliver mind-bending & chaotic VR gameplay.
案例研究

全面托管的解决方案为独立游戏节省时间 多人VR恐怖游戏
Dirty Pearl Studios
了解Dirty Pearl Studios如何通过Edgegap的轻松集成和自动编排,以及其Nakama集成,节省了开发时间。
案例研究

7天血月
The Fun Pimps & iLLOGIKA
了解 Illogika 如何大幅降低服务器成本,并确保提供《七日杀 (7 Days to Die)》玩家所期望的在线体验。
案例研究

即时全球服务器部署以促进协作式XR医学教育
AlensiaXR
AlensiaXR如何利用Edgegap为全球医学生提供低延迟、始终可用的共享解剖课程。
案例研究

趣加
FunPlus
案例研究

守光人:具有专用服务器的 VR 社交合作游戏
Spectral Games
Spectral Games 如何在无需任何服务器经验的情况下,利用 Edgegap Matchmaking 和 Server Browser 为其 VR 社交大厅启动专用服务器。
案例研究

全球范围内快速可靠的部署,适用于PvPvE挑战者Gravebound
Crater Studios
Edgegap 的调度和配对如何帮助 Crater Studios 使他们能够将重心从基础设施转移到游戏玩法上。
案例研究

快速扩展网络元宇宙
Hiber
了解Hiber如何通过Edgegap消除服务器容量规划中的猜测。
案例研究

高硬件要求和自定义游戏服务器池
Alderon Games
了解Alderon Games如何瞬间利用全球多个供应商的自定义游戏服务器池来支持其热门MMO。
案例研究

独立开发者的简单集成
WhaleFood Games
阅读关于WhaleFood Games如何使用Edgegap解决其网络代码问题的文章。
案例研究

推动东南亚首款电子竞技游戏的尖端技术。
Anantarupa Studios
了解Edgegap如何通过一个无缝解决方案简化复杂基础设施和尖端技术,从而改变东南亚的游戏格局。
案例研究

一次打击。全球抵达。
Triple Hill Interactive
Triple Hill Interactive如何利用Edgegap的编排来提供低延迟,并提高在每毫秒都至关重要的游戏类型中的公平性。
案例研究

快节奏团队大逃杀...带着枪的动物毛绒玩具!
SANDYFLOOR
了解一家韩国独立工作室是如何将其多人游戏发布到全球的。
案例研究

移动端赛马游戏凭借即时、高效能的服务器走向全球
Mirai Labs
看 Mirai Labs 如何通过即时服务器部署和细分 vCPU 来运行 Pegaxy Blaze 的全球多人竞速游戏,从而将单个玩家的成本保持在极低水平。
案例研究

服务器管理与分发
Matrioshka Games
阅读关于Matrioshka Games如何在资源有限的情况下发布早期访问的战斗 Royale。
案例研究

听我的信号,释放地狱!
TyGames
探索独立工作室TyGames如何让玩家沉浸在第三人称角斗士战斗的多人游戏中。
案例研究

瞬时全球编排
Soliton Interactive
探索Soliton Interactive如何做到了不可能……首次推出可多人玩的版本!
案例研究

竞技游戏具有服务器端物理引擎,确保理想的低于50毫秒的延迟
NS7
了解为什么仅有Edgegap能够使独立工作室通过服务器端物理和权限实现其AAA质量的免费游戏体育玩法愿景。
案例研究

iGaming的区域部署
X1 Contra 1
X1 Contra 1 通过经济高效的托管和区域部署,为其巴西玩家提供实时 PvP 休闲游戏,确保数据和法律合规。
案例研究

仅在玩家游玩时付费:经济实惠的多人游戏基础设施
Meltdown Interactive
Edgegap 如何帮助独立开发商 Meltdown Interactive Media 在无需复杂方案的情况下,以高性价比解决扩缩容和匹配问题,从而让他们能够专注于游戏开发。
案例研究

同一个 Edgegap 平台,三种截然不同的网络配置
Warped Games
了解 Warped Games 如何在同一个 Edgegap 部署 API 和同一个容器管线上运行社交中心、实时合作以及回合制合作。
案例研究

台球大师巡回赛Max
RETA Games
案例研究

韩国的Web3 POP提取射击游戏走向全球,即刻启程
NDUS Entertainment
XOCIETY 如何轻松地添加 Edgegap 编排并集成自定义 matchmaking,与 Edgegap Ping Beacons 一起优化延迟。
案例研究

Multiplayer in Every Dimension
Arcadia.tv
Discover how Arcadia.tv uses Edgegap's edge network to deliver an innovative, team and location-based athletic VR sport.
案例研究

F2P 移动格斗游戏利用即时(Just-In-Time)服务器降低基础设施成本
Game Changers Worldwide
Game Changer Worldwide 如何在全球移动端托管 Rumble Rush 的实时 3v3 PvP 游戏。
案例研究
他们选择 Edgegap 的关键原因
了解 Edgegap 自动化游戏服务器编排如何带来无缝的多人游戏体验。









