了解Edgegap的工作原理

了解Edgegap的工作原理

Unity Engine

Megacity Metro (Mobile)

部署至 Edgegap

Megacity Metro(移动端):在 Edgegap 专属服务器上运行 Unity 面向实体的 Netcode 射击游戏,并支持匹配

已发布

已发布

最近一次准确性审核

最近一次准确性审核

在 Edgegap 专属游戏服务器上运行的 Megacity Metro 示例游戏(Unity 引擎)

Megacity Metro 是 Unity 的多人射击游戏示例:每场比赛最多可容纳 150 名玩家穿梭于城市之中,基于 Netcode for Entities (DOTS/ECS) 构建。在官方上游版本中,它运行在 Unity Gaming Services 上。Edgegap 的分支版本将其专用服务器运行在 Edgegap 上,并通过 Edgegap 匹配系统进行匹配。

游戏的网络代码保持不变:依然是相同的服务器权威型 Netcode for Entities、相同的预测和延迟补偿机制。该分支仅添加了几个 Edgegap 文件和两个小型挂钩(hooks)。如果 Edgegap 设置留空,游戏的运行方式与上游完全一致。

玩家点击 Find Match,匹配系统会启动一个专用服务器,随后搜索比赛的玩家将通过回填(backfill)机制加入该正在运行的服务器,每台服务器最多支持 150 人。当没有玩家在线时,服务器会自动停止其自身的部署。

移动端状态(2026年10月30日):手机端通过 Find Match 加入,因为移动端发布版本隐藏了直接连接(Connect)选项。该匹配路径已在 Windows 客户端上测试。Android APK 能够成功构建并在 Android 模拟器中进入主菜单,其匹配客户端显示匹配系统运行正常;目前尚未有手机设备连接到 Edgegap 服务器,且 iOS 版本尚未构建。

Edgegap 的网络覆盖 615+ 个边缘云节点(了解更多)。每台服务器都会部署在最适合其玩家的可用位置,并且仅在运行期间计费。

平台:Linux 专用服务器。已测试的客户端:Windows。Android APK 能够成功构建并在 Android 模拟器中运行;手机、iOS 和 macOS 均受上游游戏支持,但尚未在 Edgegap 上进行测试。原始游戏由 Unity Technologies 提供,遵循 Unity Companion License 协议。

工作原理

  1. 玩家点击 Find Match。客户端向 Edgegap 匹配系统发送单人票据(solo ticket),无需登录 Unity Gaming Services。

  2. 匹配系统将玩家归入配置文件 metro(一个 2 到 150 人的队伍),并为该比赛启动 Edgegap 部署。

  3. 服务器启动,监听 UDP 端口 7979 并跳过 UGS 会话。每个客户端获取服务器的 IP 和外部端口,发起连接并发送其票据 ID,以便服务器统计空位。

  4. 只要尚有空位,服务器就会保持回填票据处于开放状态。之后搜索的玩家将被分配到这个正在运行的服务器,而不是启动新服务器。

  5. 当没有玩家留下时,服务器会关闭其回填并停止自身的部署,从而结束计费。

该分支修改的内容:

路径

功能说明

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapEnvironment.cs

读取 Edgegap 注入到部署中的内容,以及客户端的直连目标。

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapServerLifecycleSystem.cs

服务器端:当无人加入或所有玩家都离开时停止部署。

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapMatchmakerClient.cs

客户端:排队单人票据并返回服务器的 IP 和端口。

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapBackfillSystem.cs、EdgegapTicketRpc.cs

服务器端:在有空位时保持回填开放,并将连接与票据进行匹配。

Assets/Scripts/Gameplay/Mix/Multiplayer/Edgegap/EdgegapMatchmakerSettings.cs、Assets/Resources/EdgegapMatchmakerSettings.asset

匹配系统 URL、身份验证令牌、配置文件以及回填限制,由客户端和服务器共享。

Assets/Scripts/Gameplay/Mix/Multiplayer/SDK/Server/ServerManager.cs

挂钩:在 Edgegap 上运行时跳过 UGS 会话。

Assets/Scripts/Gameplay/Mix/UI/MonoBehaviours/Matchmaker/MatchMakingConnector.cs

挂钩:Find Match 使用 Edgegap 匹配系统,或直接连接到服务器。

Assets/Edgegap/Editor/EdgegapPluginBuild.cs、EdgegapClientBuild.cs

从命令行运行 Edgegap Unity 插件的构建服务器功能,并构建 Windows 和 Android 测试客户端。

.dockerignore、matchmaker-config.json

服务器镜像和匹配系统配置。

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

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

Megacity Metro skyline at dusk, with a flying vehicle near a glowing tower, and the Unity logo.

Unity 的 Megacity Metro,一款基于 Netcode for Entities 的射击游戏,其服务器部署在 Edgegap 上。

分步指南

运行示例

1. 开始之前

  • 一个免费的 Edgegap 账户。测试无需信用卡。

  • Unity 6000.1.0f1,包含 Linux Build Support (IL2CPP)、Linux Build Support (Mono) 和 Linux Dedicated Server Build Support,以及适用于您客户端平台的模块(针对所测试的客户端为 Windows Build Support (IL2CPP))。

  • Docker Desktop,且处于运行状态。

  • Git LFS,需在克隆之前安装:该项目包含约 415 MB 的 LFS 内容。请预留充足时间:Unity 指出,首次克隆、首次打开项目以及首次构建各可能需要 20 到 50 分钟。

  • 克隆该 分支 (fork)。下载 ZIP 压缩包的方式不适用于该项目。

Git:Unity 需要在您的 PATH 环境变量中配置 Git 客户端(2.14.0 或更高版本),以便从 Git URL 安装程序包(例如 Edgegap 插件)。macOS 通常已预装(Xcode 命令行工具);在 Windows 上,请安装 Git。

2. 构建、测试并上传服务器

在编辑器中:Tools → Edgegap Server Hosting → Sign in with Edgegap(或粘贴令牌,然后点击 Validate)→ Build server。插件会在构建前切换到带有 Dedicated Server 子目标的 Linux。通过命令行,在编辑器中关闭项目的情况下运行:

Unity -batchmode -buildTarget Linux64 -standaloneBuildSubtarget Server -projectPath . -executeMethod EdgegapPluginBuild.BuildServer -logFile build.log

保留 -buildTarget Linux64 -standaloneBuildSubtarget Server:如果没有它们,Entities 内容构建将失败,并显示“Unable to build with the current configuration”。

构建产物输出在 Builds/EdgegapServer/ 中(约 3.4 GB,主要是调试文件)。分支的 .dockerignore 排除了这些文件,因此镜像大小约为 537 MB。

然后,在插件窗口中:

Containerize with Docker:镜像名称填写 megacity-metro,标签留空(插件将使用当前 UTC 时间),使用默认的 Dockerfile。

Test Your Server Locally:Optional Docker Run Parameters 填写 -p 7979:7979/udp -e UNITY_COMMANDLINE_ARGS="-port 7979",然后点击 Deploy local container。如果没有 -port 7979,Megacity 会绑定到 127.0.0.1,容器外部的任何服务都无法访问它。

Upload to Edgegap:Application Name 填写 megacity-metro,然后点击 Upload image and Create app version。插件会推送镜像并打开控制面板的版本表单。对于以后的构建,点击 Rebuild from Source 即可一键完成构建、容器化和推送。

3. 创建应用版本

在控制面板中,创建应用程序 megacity-metro 以及适用于您的镜像的版本:

  • 插件填写的镜像和标签,以及环境变量 UNITY_COMMANDLINE_ARGS = -port 7979。请确保已设置注册表登录信息:注册表配置文件,或者来自容器注册表页面的用户名和令牌。

  • 1 个 vCPU 和 2 GB,此为经过测试的规格。空闲服务器大约使用 18% 的 CPU 和 323 MB 内存。

  • 一个端口:名称 gameport,7979,UDP。

版本上的可选环境变量:EDGEGAP_FIRST_PLAYER_TIMEOUT_S 和 EDGEGAP_EMPTY_TIMEOUT_S(自动停止计时器)、EDGEGAP_MAX_PLAYERS 和 EDGEGAP_MAX_OPEN_BACKFILLS(补位限制),以及用于额外服务器参数的 UNITY_COMMANDLINE_ARGS。

4. 使用桌面客户端测试服务器

在添加配对系统之前,请先验证服务器是否正常工作。从控制面板部署该版本,选择离您较近的区域。服务器日志应显示 Running on Edgegap ... skipping UGS sessions。

使用部署的主机和外部端口启动桌面客户端(位于部署页面上;并非 7979):

<客户端可执行文件> -edgegapConnect <主机>:<外部端口>

或者在启动之前设置 EDGEGAP_CONNECT=<主机>:<外部端口>。主机可以是 IP 或 FQDN。有了直连目标后,客户端会跳过 UGS 登录,并且不需要 UGS 项目。当您加入时,服务器会记录 [Edgegap] Connected players: 1。

直连仅适用于桌面端测试:移动设备的发布版本会隐藏 Connect(连接)选项,因此手机使用的是 Find Match(寻找对局,步骤 6)。

如需快速构建 Windows 测试客户端,请使用 Mono 代替 IL2CPP 进行构建(IL2CPP Master 构建大约耗时 40 分钟并占用 12 GB 内存):

Unity -batchmode -quit -buildTarget Win64 -standaloneBuildSubtarget Player -projectPath . -executeMethod EdgegapClientBuild.Build -edgegapClientTarget win64 -edgegapClientMono -logFile client.log

输出文件位于 Builds/Client/win64-mono/ 中。在服务器构建后请保留 -standaloneBuildSubtarget Player,否则构建将失败并提示“script class layout is incompatible”。

完成后请停止部署。免费层一次只能运行一个部署。

5. 将其添加到你自己的 Netcode for Entities 游戏中

该分支是一个可用的参考:您的代码编写智能体(coding agent)可以直接复制其经过测试的文件,而无需从头编写。通过以下五项更改,即可让 Netcode for Entities 游戏在 Edgegap 上运行:

  1. 服务器在 Edgegap 上跳过 UGS。当设置了 ARBITRIUM_REQUEST_ID 变量时,服务器会在没有 UGS 会话的情况下启动(ServerManager.cs、EdgegapEnvironment.cs)。

  2. 服务器自行停止。当无人加入或所有人都已离开时,服务器世界系统会调用 ARBITRIUM_DELETE_URL(EdgegapServerLifecycleSystem.cs)。

  3. “寻找比赛”(Find Match)使用 Edgegap 匹配系统。客户端使用 Edgegap Unity SDK 将票据加入队列,并将返回的 IP 和端口传递给游戏现有的连接流程(EdgegapMatchmakerClient.cs、MatchMakingConnector.cs)。

  4. 运行中的服务器持续补充玩家。服务器世界系统在有空位时保持补位(backfill)开启,客户端在连接后通过 RPC 发送其票据 ID(EdgegapBackfillSystem.cs、EdgegapTicketRpc.cs)。

  5. Linux 服务器构建和镜像。Edgegap Unity 插件负责构建服务器并将其容器化(命令行使用 EdgegapPluginBuild.cs);该分支的 .dockerignore 可防止调试文件进入镜像,且应用版本会在 UNITY_COMMANDLINE_ARGS 中传递 -port 7979。

然后按照步骤 3 和步骤 6 创建应用版本和匹配系统。

配合您的智能体使用:

“加载 edgegap 技能,然后加载 edgegap-unity。我的游戏使用 Netcode for Entities。以 github.com/edgegap/netcode-game-sample-unity-dots-ecs-mobile-megacity-metro 为参考,添加一个在服务器为空时停止 Edgegap 部署的服务器世界系统,让‘寻找比赛’在 Edgegap 匹配系统中排队并连接到返回的地址,添加通过 RPC 发送票据 ID 的服务器补位功能,并将 Linux 专用服务器构建到该分支的 Dockerfile 中。”

Edgegap 的技能目前还没有 Netcode for Entities 模板:edgegap-unity 涵盖了 Unity 工作流,而该分支的 ECS 系统则是网络代码部分的参考。

有关每个步骤的手动操作详细说明,请参阅 Unity Engine 集成指南。

6. 使用 Edgegap 匹配系统寻找对局

这是手机端使用的路径。该路径已于 2026 年 10 月 21 日和 22 日在 Windows 客户端上进行了测试;Android APK 在 Android 模拟器中成功进入了主菜单,但未从中运行“寻找比赛 (Find Match)”,目前尚无手机实际游玩过。

  1. 将 matchmaker-config.json 中的 application.version 设置为您的应用版本。配置文件 metro 是一支包含 2 到 150 名玩家的队伍。两名一起匹配的玩家在匹配成功后会立即分配到一个服务器,单人匹配的玩家约 20 秒后分配到一个服务器(匹配票据在 30 秒后过期)。这非常适合测试;对于正式比赛,请提高最低人数限制。

  2. 在控制面板中打开 Matchmaker,选择 Create Matchmaker,上传 matchmaker-config.json,然后选择 Create and Start。

  3. 当状态变为 ONLINE 时,将 API URL 和 Auth Token 复制到 Assets/Resources/EdgegapMatchmakerSettings.asset 中。Auth Token 可以安全地随客户端一同发布:它无法用于访问您的 Edgegap 账户。

  4. 重新构建服务器和客户端。两者都会读取该资产:客户端用其寻找比赛,服务器用其创建回填。然后使用插件中的“Rebuild from Source”并保存新的应用版本。

在客户端中点击 Find Match。状态将依次显示为“Searching...”、“Match found, starting server...”,随后客户端连接。批处理模式客户端(-batchmode -nographics)会自动进行匹配。

回填(中途加入)。每张票据都带有一个 backfill_group_size 属性:客户端发送 ["new", "1"](新比赛,或正在运行的服务器上的一个空位),服务器发送 ["1"]。服务器为每位匹配成功的玩家提供 60 秒的连接时间,在有空位时最多保持 3 个回填开放,并在停止运行前关闭所有回填。

自动停止。如果在启动后 300 秒内从未有玩家连接,或者最后一名玩家离开 60 秒后,服务器将停止部署。已匹配但仍在连接中的玩家将使服务器保持运行。

在免费套餐中,撮合器(matchmaker)在每次启动 3 小时后会停止;可从控制面板重新启动(其 URL 和令牌保持不变)。当您发布新的服务器版本时,请在撮合器中更新 application.version(停止、编辑、启动)。

已知限制

  • 手机端尚未进行测试。Android APK(IL2CPP、ARM64、OpenGL ES 3.1 回退)已成功构建,并在 Android 模拟器中进入了主菜单,但目前尚未有手机加入 Edgegap 服务器,且 iOS 构建需要 Mac。同时,也尚未进行窗口化的桌面端试玩测试;已测试的客户端均以无头(headless)模式运行。

  • 无票据验证。服务器会记录一个未提供票据的连接,但仍会允许其进入。

  • 外部停止时回填仍会残留。如果部署是从控制面板、API 或达到其最长运行时限而被停止的,服务器退出时不会关闭其回填。在最长 30 秒内(直至其过期),它们仍可能将玩家发送到已停止的服务器;该玩家的连接将会超时,随后下一次“寻找比赛”将恢复正常。

  • Vivox 和 UGS 登录未作改动。Edgegap 路径不使用它们,游戏内 Connect 模式的会话浏览器仍然会列出 UGS 会话。

测试了什么

在 Edgegap 上使用 Unity 6000.1.0f1 以及配置为 7979/UDP 端口的 1 vCPU / 2 GB 应用版本进行了测试。客户端为 Windows 构建版本,以无外设模式运行(-batchmode -nographics)。

  • 2026 年 10 月 20 日,直连: Windows IL2CPP 客户端使用 -edgegapConnect 进行了连接,服务器记录了玩家加入。该部署在没有玩家时自动停止(1502 秒,超时设置为 1500 秒),并在客户端退出后约 60 秒停止。

  • 2026 年 10 月 21 日,匹配器(免费层级,配置文件 metro): 两个 Windows 客户端(Mono 构建版本)一同排队,同一部署先后收到 MATCH_FOUND 和 HOST_ASSIGNED,并且均已成功连接。第三个客户端通过补位(backfill)从 SEARCHING 直接转变为该运行中部署的 HOST_ASSIGNED,并成功加入。在三个客户端全部退出后,该部署自动停止。

  • 本地(服务器运行在 Docker 中,模拟 Edgegap 变量,使用真实匹配器):当 60 秒内没有匹配的玩家连接时,席位被释放,补位通道关闭。

  • 2026 年 10 月 22 日,Android 模拟器(Android 14 x86_64 镜像): ARM64 + x86_64 APK 成功进入主菜单,其匹配器客户端报告匹配器状态正常。未在模拟器中运行“寻找对局”(Find Match)。未测试项目:手机端、iOS 和 macOS 客户端。插件构建版本(10 月 29 日)已在本地容器中进行了检查,尚未在带有客户端的 Edgegap 上进行测试。

常见问题

关于在 Edgegap 上运行 Unity 的 Megacity Metro 和 Netcode for Entities 的疑问。

Netcode for Entities 可以在 Edgegap 专属服务器上运行吗?

是的。针对 Linux Dedicated Server(Linux 专用服务器)目标构建游戏,并在 Edgegap 上的容器中运行它。Megacity Metro 的服务器在 Edgegap 上运行,其网络代码保持不变:该分支仅添加了几个 Edgegap 文件和两个小型挂钩(hooks)。

Megacity Metro 示例可以在移动设备上与 Edgegap 配合使用吗?

暂不支持手机。手机端通过“查找比赛”(Find Match)加入,该功能使用 Edgegap 匹配系统,并支持 Windows 客户端。Android APK 已构建完成并在 Android 模拟器中进入了主菜单;目前尚无手机加入过 Edgegap 服务器。

玩家可以加入已经开始的巨型都市地铁比赛吗?

是的,通过回填功能。当服务器有空闲席位时,它会保持 Edgegap 匹配系统的回填票据处于开启状态,因此稍后搜索的玩家可以加入,每台服务器最多可容纳 150 人。

我还需要 Unity Gaming Services 吗?

不用于托管或匹配。在 Edgegap 上,服务器会跳过 UGS 会话,并且“寻找比赛”(Find Match)和直连会跳过 UGS 登录。Vivox 语音聊天仍使用 UGS。

客户

了解更多已接入 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 行

解锁

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