平台

游戏

资源

企业

公司

平台

游戏

资源

企业

公司

了解Edgegap的工作原理

了解Edgegap的工作原理

對局配對

對局配對

和

和

托管与编排

托管与编排

整合

/

UGS 匹配系统

UGS 匹配系统

部署至 Edgegap

已发布

已发布

已发布

最近一次准确性审核

最近一次准确性审核

最近一次准确性审核

UGS 撮合系统：如何通过 Unity Gaming Services Matchmaker 在 Edgegap 上部署专用服务器

UGS 撮合系统：如何通过 Unity Gaming Services Matchmaker 在 Edgegap 上部署专用服务器

本指南向您展示如何保留 Unity Gaming Services (UGS) Matchmaker，并在 Edgegap 的专属游戏服务器上托管每场比赛：当 UGS 组成一场比赛时，Edgegap 会在玩家附近部署一台服务器，UGS 会将其地址分发给每位玩家。

一旦您的游戏服务器完成容器化，Edgegap 即可通过简单的 API 调用将其按需部署到全球 615+ 个边缘云节点，并完全按用量计费：无需租用整台服务器、预配置或在比赛间隙保持运行。对于需要预留容量的持久服务器，Edgegap 提供了专用机群 (Private Fleets)。

两者之间的桥梁是 Edgegap 的分配器 (allocator)，这是一个由 Unity 官方分发的轻量级 Cloud Code 模块。当比赛形成时，UGS 会调用它，它会请求 Edgegap 部署您的服务器，然后将服务器的地址和端口返回给 UGS，再由 UGS 传递给您的玩家。

UGS Matchmaker with Edgegap: players create tickets, the queue and pool group them into a match, the matchmaker calls the Edgegap allocator in Cloud Code, which requests a deployment on Edgegap and returns the IP and port when ready; the matchmaker writes them into each ticket and game clients connect to the dedicated server

本指南涵盖：

  1. 准备一个可用的 Edgegap 应用版本及您的 UGS 项目

  2. 将您的编程智能体连接到 Edgegap（可选）

  3. 开启 UGS 服务

  4. 配置并部署 Edgegap 的分配器

  5. 将匹配客户端添加到您的游戏中

  6. 创建您的队列和比赛规则

  7. 使用两名玩家进行测试

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

  • 使用编程智能体。将 Claude Code、Cursor 或其他智能体连接到 Edgegap MCP 服务器及其 agent skills。智能体将配置分配器、编写匹配客户端并检查您的应用版本及部署。您只需在 Unity 和 Unity Cloud 控制面板中进行点击操作、管理密钥以及进行游戏测试。

  • 手动操作。以下每个步骤均可在没有智能体的情况下完成。

更喜欢无需 Cloud Code 的托管撮合服务？请参阅 Unity 對局配對 SDK。

与工程师联系

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

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

分步指南

详细集成步骤

1. 开始之前

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

  • 游戏服务器的一个正常运行的 Edgegap 应用版本：即您至少部署并加入过一次的服务器。UGS 将在每场比赛中部署该版本，因此它需要一个功能完备的容器化游戏服务器来实现端到端运行。如果您目前还没有，请参考我们的指南：

  • 已关联到 Unity Cloud 的 Unity 项目（前往 Edit → Project Settings → Services 可查看已关联的项目及其 ID）。

  • .NET SDK 8 或更高版本，用于部署 Cloud Code 模块。使用 dotnet --version 检查版本。

  • Edgegap API 令牌，可从 Dashboard → User Settings → Tokens 获取。它将在第 4 步中存入 Cloud Code 密钥，切勿用于其他任何地方：该令牌适用于整个组织，因此切勿将其放入您的项目、游戏客户端、游戏服务器或聊天中。

在此，我们使用 Edgegap 对 Unity Boss Room 示例的复刻版本，该版本已作为专用服务器运行，并包含匹配客户端。

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

如果您完全手动操作，请跳过此步骤。

Edgegap MCP 服务器允许您的智能体检查您的应用和版本、部署测试服务器并查看您账户上的日志。edgegap-deployments-api 智能体技能为部署 Edgegap 服务器的后端提供了规则（包括 UGS Cloud Code）：令牌存储位置、将服务器部署在靠近玩家的位置以及处理错误。

Claude Code（在您自己的终端中运行，这样令牌就绝不会通过聊天传递）：

claude mcp add --transport http edgegap https://mcp.edgegap.dev/mcp -H "Authorization: token YOUR_EDGEGAP_API_TOKEN" --scope user

然后安装技能：/plugin marketplace add edgegap/edgegap-agent-skills，接着运行 /plugin install edgegap@edgegap。重启会话。

Cursor、VS Code 及其他发送请求头的客户端：添加 https://mcp.edgegap.dev/mcp，并附带请求头 Authorization: token YOUR_EDGEGAP_API_TOKEN，然后使用 npx skills add edgegap/edgegap-agent-skills --skill "*" 安装技能。

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

检查其是否正常工作：

“列出我的 Edgegap 应用及其版本，以及每个版本的端口。”

请记下确切的应用名称、版本名称和端口名称：步骤 4 会用到它们。

3. 开启 UGS 服务

此集成使用三项 UGS 服务：Authentication、Matchmaker 和 Cloud Code。跳过你的项目中已有的服务。

  1. 在 Unity 中，打开Window → Package Manager，将来源设置为 Unity Registry，然后安装 Cloud Code 和 Multiplayer Services（其中包含 Matchmaker 并会引入 Authentication）。

  2. 在 cloud.unity.com 上，打开你的项目并启用 Authentication、Matchmaker 和 Cloud Code。

  3. 请注意你的环境（默认为 production）。密钥、模块和队列必须全部位于同一个环境中。

4. 配置并部署 Edgegap 的分配器 (allocator)

分配器位于 Unity 的 matchmaker hosting providers 存储库中，独立于您的游戏项目。

  1. 将其克隆到您的项目旁边：git clone https://github.com/Unity-Technologies/matchmaker-hosting-providers.git

  2. 打开 Edgegap 分配器的 EdgegapAllocator.cs 并设置标记为 TODO 的三个常量，直接从 Edgegap 仪表板复制，不要重新手动输入：ApplicationName（您的应用程序）、VersionName（您的应用版本）和 PortName（gameport）。将 EdgegapApiTokenSecretName 保留为 EDGEGAP_API_TOKEN。

  3. 在 Unity Cloud 仪表板中，在Administration → Secrets下，在同一环境中添加一个机密：键为 EDGEGAP_API_TOKEN，值仅为您自己的 Edgegap API 令牌，不包含多余的单词或空格。

  4. 在 Unity 中，在项目中创建一个 Cloud Code C# Module Reference，并将其指向克隆存储库中的分配器解决方案文件 (.sln)。如果将其指向其他任何内容，将部署一个空模板，尽管看起来像是部署成功了。

  5. 打开 Services → Deployment，勾选该模块，选择您的环境，然后选择 Deploy Selected。

  6. 检查是否成功生效：在 Unity Cloud 仪表板中，该模块会显示两个端点：Matchmaker_AllocateServer 和 Matchmaker_PollAllocation，每个端点都会返回分配器自己的类型。如果返回类型仅为“string”，则表示引用指向了错误的文件。

The three constants to set in EdgegapAllocator.cs: ApplicationName, VersionName and PortName, each marked TODOCloud Code module endpoints in the Unity Cloud dashboard: Matchmaker_AllocateServer and Matchmaker_PollAllocation

配合您的智能体使用：“在克隆的 matchmaker-hosting-providers 存储库中，将 EdgegapAllocator.cs 中的 ApplicationName、VersionName 和 PortName 设置为我的 Edgegap 应用、版本和端口。不要更改机密名称，也不要在任何地方写入我的令牌。”机密的添加和模块的部署需要您自行完成。

以下是我们结合 Edgegap 使用 UGS Matchmaker 的视频教程，其中使用了 Edgegap 派生的 Boss Room 版本：

5. 将匹配客户端添加到您的游戏中

您的游戏需要一个客户端来完成以下操作：让玩家登录、在您的队列中创建票证（ticket）、等待分配，然后连接到服务器。仅连接调用取决于您的网络代码（在 Boss Room 中为 StartClientIp）。

在每位玩家的票证中发送其公网 IP。Edgegap 会根据玩家的位置来部署服务器；若没有 IP，部署将回退到默认位置。将其作为 player_ip 添加到票证的属性中；Edgegap 文档中包含用于获取该 IP 的代码片段。

还没有客户端？向任何 AI 编码助手提供以下提示词：

“在不更改我的网络代码的情况下，为我的游戏添加一个独立的 Unity Gaming Services Matchmaker 客户端。首先，进行审核（只读）并告诉我：我的项目用于通过地址和端口将客户端连接到服务器的方法（文件、行号、签名以及端口参数的类型），以及所使用的传输层协议（transport）。然后创建一个 MonoBehaviour，用于初始化 UGS 并匿名登录；为了进行同机测试，在登录前为每个运行实例设置唯一的配置文件（profile）；获取玩家的公网 IP；使用已登录的玩家 ID 以及作为 player_ip 属性的 IP 在序列化的队列名称字段上创建票证；最多每 3 秒轮询一次票证，重试失败的轮询，直到收到分配或超时；然后将分配的 IP 和端口传递给我的连接方法，并将端口转换为其所需的类型。添加一个临时的屏幕‘Matchmake’按钮。保持代码精简并附带注释。”

然后将其添加到您的初始场景中：创建一个名为 Matchmaker 的空游戏对象，添加该组件，并将其队列名称设置为您在步骤 6 中创建的队列。

6. 创建队列和匹配规则

在 Unity Cloud 仪表板中，打开 Matchmaker：

  1. 创建一个队列（例如 mygame-queue），在此测试中每个票据最多包含 2 名玩家。

  2. 在队列中创建一个池，并将其托管类型设置为 Hosting via Cloud Code。将其指向您的模块、其 allocate 端点及其 poll 端点。默认的分配超时时间为 Edgegap 留出足够的时间来启动服务器。

  3. 为最简单的测试设置匹配规则：一个队伍，队伍数量为 1，玩家数量最少和最多均为 2。保持回填（backfill）处于关闭状态。

  4. 保存。队列变为激活状态，现在您的配对程序即可部署到 Edgegap。

然后根据 Unity 的 Matchmaker 文档针对您的游戏调整规则（队伍大小、技能范围、区域）。Edgegap 只需要分配器。

7. 双人测试

  1. 在一台机器上运行两个客户端。使用 Edgegap 的 Boss Room 分支时，请使用 ParrelSync（已包含），而不是 Multiplayer Play Mode。

  2. 在两个客户端中都选择 Matchmake。UGS 会将两张票证分组，调用您的分配器，并且 Edgegap 会在玩家附近部署一台服务器。您可以在 Edgegap 控制面板中看到它出现，并带有撮合程序的标记。

  3. 两名玩家会自动连接到同一台服务器。服务器的容器日志会显示输入了两张票证，输出了一场比赛。

  4. 离开比赛：比赛结束时，您的服务器会自动停止其自身的部署（请参阅您的服务器指南），因此您只需在玩家游玩时付费。

分配器通过轮询 Edgegap 的状态 API 来获取每台服务器的地址，这对于大多数游戏来说已经足够了。对于超大规模的发布活动（数万名并发玩家），请改用 Edgegap 的就绪 webhook，相关说明请参阅 Edgegap 文档。

后续步骤

后续步骤

正从 Multiplay 迁移？Edgegap 的文档将 Multiplay 概念对应到了 Edgegap。更喜欢无需维护 Cloud Code 的托管撮合系统？请参阅Unity 對局配對 SDK。

准备上线？让您的代理运行 edgegap-launch 技能的检查清单：版本发布、重启策略、最长持续时间、成本控制。

遇到困难？让您的代理加载 edgegap-troubleshoot，或在 Edgegap Discord 上向我们的团队和其他工作室咨询。

常见问题

关于在 Edgegap 专属服务器上托管 Unity Gaming Services Matchmaker 比赛的常见问题。

我可以在继续使用 Unity 的 UGS 匹配系统（Matchmaker）的同时，将服务器托管在 Edgegap 上吗？

是的。将您的队列和规则保留在 UGS 中，并将 Edgegap 的分配器添加为 Cloud Code 模块。当比赛形成时，它会在 Edgegap 上部署您的服务器，并将地址和端口返回给 UGS，UGS 再将其提供给您的玩家。

适用于 UGS 的 Edgegap 分配器是官方的吗？

是的。这是一个官方且经过 Unity 批准的集成，发布在 Unity 的 matchmaker 托管提供商代码库中。您只需设置应用程序、版本和端口，将令牌添加为 Secret，然后进行部署即可。

我的 Edgegap API 令牌应该配置在 UGS 的哪里？

只能保存在名为 EDGEGAP_API_TOKEN 的 Cloud Code 密钥中，且该密钥需与您的模块和队列位于同一环境中。切勿保存在您的游戏客户端、游戏服务器或项目文件中。

Edgegap 是如何为 UGS 比赛选择服务器位置的？

通过玩家匹配工单中发送的公网 IP 地址，Edgegap 为整个组选取 ping 值最低的位置。如果没有 IP，部署将回退到默认位置。

我应该使用 UGS Matchmaker 还是 Edgegap 的撮合系统？

如果您的游戏已在使用 UGS 的撮合系统或其他 Unity Gaming Services，请继续保留它。Edgegap 的撮合系统采用托管模式，可免费测试，无需 Cloud Code，并能自动在玩家附近部署服务器。

客户

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

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

他们选择 Edgegap 的关键原因

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

+平均延迟减少 58

+平均延迟减少 58

14M CCU 快速缩放

14M CCU 快速缩放

+615多全球位置

+615多全球位置

~2 秒。游戏服务器平均启动时间

~2 秒。游戏服务器平均启动时间

多版本支持和滚动更新

多版本支持和滚动更新

91% 填充率對局配對

91% 填充率對局配對

跨平台兼容

跨平台兼容

即时 DDoS 保护

即时 DDoS 保护

跨 17+ 家提供商的多云架构，提供 99.99% 可用性

跨 17+ 家提供商的多云架构，提供 99.99% 可用性

费用

定价

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

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

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

边缘云

按需

$0.00115

/ vCPU

/ 分钟

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

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

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

只需添加信用卡。

全球 615+ 家分店

每月流出流量 $0.10/GB

0.25 到 4 个 vCPU 的部署

比较功能与价格

边缘云

按需

$0.00115

/ vCPU

/ 分钟

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

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

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

只需添加信用卡。

全球 615+ 家分店

每月流出流量 $0.10/GB

0.25 到 4 个 vCPU 的部署

比较功能与价格

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

预留容量

$0.0282

/ vCPU

/ 小时

按月计费，始终开启

每个主机每月 $280（12个月标准价），或按月支付每月 $350

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

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

全球 58 个分支机构

包含出站流量

每主机共 16 vCPU（13.6 可用）

比较功能与价格

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

预留容量

$0.0282

/ vCPU

/ 小时

按月计费，始终开启

每个主机每月 $280（12个月标准价），或按月支付每月 $350

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

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

全球 58 个分支机构

包含出站流量

每主机共 16 vCPU（13.6 可用）

比较功能与价格

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

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

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

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

Eggegap 的功能和价格：Edge Cloud 与 Private Fleets 的详细对比

Eggegap 的功能和价格：Edge Cloud 与 Private Fleets 的详细对比

对比

免费试用

边缘云

自有车队

账单与价格

每个 vCPU 的费率

不适用

0.00115 美元/vCPU/分钟

$0.0256/vCPU/小时

定价模式

不适用

按需（基于使用量）

预留容量

账单

无需信用卡

是的，通过 Stripe

是的，通过 Stripe

承诺

不适用

无

1、6 或 12 个月（含折扣）

出口

不适用

$0.10/GB/月

每个主机每月 6 TB

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

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

中国部署

DDoS 防御

全托管集群

常驻部署

对比

免费试用

边缘云

自有车队

账单与价格

每个 vCPU 的费率

不适用

$0.00115 / vCPU / 分钟

$0.0282 / vCPU / 小时

定价模式

不适用

按需（基于使用量）

预留容量

账单

无需信用卡

是的，通过 Stripe

是的，通过 Stripe

承诺

不适用

无

1、6 或 12 个月（含折扣）

出口

不适用

$0.10/GB/月

每个主机每月 6 TB

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

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

中国部署

DDoS 防御

全托管集群

常驻部署

对比

免费试用

边缘云

自有车队

账单与价格

每个 vCPU 的费率

不适用

0.00115 美元/vCPU/分钟

$0.0256/vCPU/小时

定价模式

不适用

按需（基于使用量）

预留容量

账单

无需信用卡

是的，通过 Stripe

是的，通过 Stripe

承诺

不适用

无

1、6 或 12 个月（含折扣）

出口

不适用

$0.10/GB/月

每个主机每月 6 TB

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

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

中国部署

DDoS 防御

全托管集群

常驻部署