了解Edgegap的工作原理

對局配對

和

托管与编排

整合

Netcode for GameObjects

部署至 Edgegap

已发布

2025/6/12

最近一次准确性审核

2026/10/15

Netcode for GameObjects：如何集成和托管专用服务器，并为您的多人游戏添加對局配對

本指南向您展示如何在 Edgegap 的专用游戏服务器上托管使用 Netcode for GameObjects (NGO)（Unity 自己的网络代码）构建的游戏，然后添加匹配功能，以便玩家能够自动分组并连接到离他们较近的服务器。

一旦您的游戏服务器完成容器化，Edgegap 只需通过一个简单的 API 调用即可将其按需部署到全球 615 多个边缘云节点，并且完全按使用量计费：无需租用、配置整台服务器，也无需在比赛间隔期间保持其运行。对于需要预留容量的持久性服务器，Edgegap 提供了专用队列 (Private Fleets)。Edgegap 的匹配基于此构建，并且是可选的。

本指南涵盖：

准备 Unity、您的 Edgegap 账户和容器化工具
将您的编码智能体连接到 Edgegap（可选）
让您的 NGO 游戏做好用于专用服务器的准备
构建并容器化您的游戏服务器
部署测试服务器并进行连接
添加匹配功能（可选）
通过两名玩家测试完整流程

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

使用编码智能体。将 Claude Code、Cursor 或其他智能体连接到 Edgegap MCP 服务器及其智能体技能。智能体负责编辑您的项目、构建并容器化服务器、进行部署并编写匹配代码。您只需负责在 Unity 和 Edgegap 仪表板中进行点击操作以及测试游玩。
手动操作。以下每个步骤在没有智能体的情况下也同样适用。

在构建和容器化服务器方面，Edgegap 的 Unity 自动化游戏服务器构建工具插件是可选的。它可以通过 Unity 编辑器中的按钮构建服务器、对其进行容器化并将其部署到云端，这是首次让您的服务器上线的快捷方式（步骤 4，选项 A）。

在此，我们使用 Unity 的 Boss Room 示例，这是一款基于 NGO 构建的合作游戏。开箱即用的 Boss Room 采用主机/客户端模式运行：一名玩家作为主机，其他玩家通过 Unity 的会话加入。标有 Boss Room 的步骤涵盖了针对该示例的特定内容。任何 NGO 项目的工作方式都是相同的。

与工程师联系

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

分步指南

详细集成步骤

1. 开始之前

一个免费的 Edgegap 账户。请验证您的电子邮箱。测试无需信用卡。
安装了 Linux 构建模块的 Unity 引擎。 Edgegap 推荐使用 LTS 版本。
- 从 Unity Hub 添加以下模块：Linux Build Support (Mono)、Linux Build Support (IL2CPP) 以及 Linux Dedicated Server Build Support。添加后请重启 Unity。
- Boss Room：使用 Unity 6.0 LTS，即该示例所构建的版本。Unity 尚未针对 Unity 6.3 LTS 或更高版本更新 Boss Room，因此较新的版本可能会导致其无法正常工作。您自己的 NGO 项目可以使用任意 LTS 版本。
- Boss Room：还需安装 Git LFS，并在克隆之前运行 git lfs install。若没有它，示例的美术资源将无法下载，项目打开后会是空的。
正在运行的容器化工具。我们推荐在构建时安装并运行 Docker Desktop。
- 其他容器工具也可以与 Edgegap 配合使用，但本指南仅涵盖 Docker。
对于 Agent 路径：需要一个 Edgegap API 令牌，可从控制面板 → 用户设置 → 令牌 (Tokens) 获取。该令牌适用于整个组织，因此请像对待密码一样对待它：切勿将其放入项目、游戏客户端或聊天中。

Git：Unity 需要在 PATH 中配置 Git 客户端（2.14.0 或更高版本），以便从 Git URL 安装软件包（例如 Edgegap 插件）。macOS 通常已经内置了一个（Xcode 命令行工具）；在 Windows 上，请安装 Git。

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

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

Edgegap MCP 服务器允许您的智能体在您的账户上创建应用和版本、部署服务器、读取日志并生成撮合系统（matchmaker）配置。智能体技能为其提供了经过测试的 Unity 工作流、C# 模板（包括 NGO 适配器）、Dockerfile 以及已知避坑指南。

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 "*" 安装技能。

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

检查是否正常运行：

“列出我的 Edgegap 应用。”

列表为空是正常的。关于令牌的错误通常意味着请求头被错误地识别成了 token token ...。

3. 为您的非政府组织（NGO）服务器准备专用托管

在 Edgegap 上，没有玩家作为主机来主持比赛。游戏由无界面的专用服务器（headless dedicated server）掌控，因此该专用服务器必须自行启动、监听固定端口，并在比赛结束时自行停止。

使用您的智能体：

“加载 edgegap-unity skill，并使此 Netcode for GameObjects 项目适配专用服务器：服务器构建以无界面模式在 0.0.0.0 上调用 StartServer，在客户端连接时生成玩家，从服务器路径中移除 Relay 和 Lobby 调用，并在比赛结束时服务器自动停止。添加 Edgegap 服务器生命周期以及包含 NGO 适配器的配对客户端脚本。然后检查它在一个服务器和一个客户端的本地环境中仍能正常运行。”

手动操作，在您的项目中：

在服务器构建中，调用 NetworkManager.StartServer()，切勿调用 StartHost()。服务器路径上的任何内容都不应等待菜单或按钮操作。
保留 Unity Transport 的端口（默认为 7777/UDP），并让服务器监听所有接口：SetConnectionData("0.0.0.0", port, "0.0.0.0")。
在客户端连接时生成玩家（Network Manager 的 Player Prefab，或 OnClientConnectedCallback），而不是为主机生成本地玩家。
从服务器路径中移除 Unity Relay、Lobby 或会话（session）调用。保留直接 IP 连接用于测试。
确保包含 Network Manager 的场景已在 Build Settings 中启用。只有启用的场景才会被构建。
在服务器上设置 Application.targetFrameRate（30 到 60），否则无界面构建会使一个 CPU 核心以 100% 的占用率空转运行。

Boss Room

基础示例通过 Unity 的会话及其自身的 ConnectionManager 启动主机，因此无法直接作为专用服务器运行。有两种接入方式：

使用您的智能体转换基础示例。使用 Git LFS 克隆 Unity 的 Boss Room，然后使用上述提示词并添加：“通过 Boss Room 的 ConnectionManager（其 IP 连接方法）路由服务器启动和客户端连接，而不是直接调用 NetworkManager。”
或者直接从 Edgegap 的 Boss Room 分支开始。它已经做好了适配专用服务器的准备：服务器调用 StartServer 而不是 StartHost，并且 MainMenu 场景中的 EdgegapServerStarter 会在 0.0.0.0 以及 Edgegap 传递给容器的端口上启动它。Edgegap 插件已包含在内。该分支还添加了一个调用 Unity UGS Matchmaker 的 Matchmake 按钮：若要保留 UGS Matchmaker 并让其在 Edgegap 上部署服务器，请遵循我们的 UGS Matchmaker 指南。本指南则使用 Edgegap 的配对器（步骤 6）。

首次打开时，该分支可能会在安全模式（Safe Mode）下启动。请通过 Window → Package Manager → Unity Registry 安装 Multiplayer Services，然后检查控制台（Console）是否显示无编译错误。

首先在本地测试：使用 Unity 的 Multiplayer Play Mode，一个编辑器（或构建）作为服务器，一个作为客户端。切勿将无法在 localhost 上运行的游戏进行容器化。

4. 构建并容器化您的服务器

Edgegap 会在容器内运行您的 Linux 服务器构建。您可以二选一，或结合两者使用：例如，首次部署使用插件，之后的所有构建都由您的 Agent 处理。

选项 A（可选）：适用于 Unity 的 Edgegap 自动化游戏服务器构建工具插件。这是首次云端部署的最快方式，全程通过按钮操作。它使用 Docker 对您的服务器进行容器化。以下视频演示了在 Edgegap 的 Boss Room 分支上的这一流程。

在 Unity 中，选择 Window → Package Manager，点击 +，然后选择 Add package from git URL，并粘贴 https://github.com/edgegap/buildtool-unity-plugin.git。（Edgegap 的 Boss Room 分支已包含该插件。）
打开 Tools → Edgegap Server Hosting，登录，并在 Connect your Edgegap Account 下粘贴提供的令牌。选择 Validate Token。
在 Build Settings 中检查您的场景。对于 Boss Room，Startup 排在第一位，接着是 MainMenu，然后是游戏场景。
选择 Build Server。构建产物将保存在 Builds/EdgegapServer/ServerBuild。
在 Docker 运行的情况下，选择 Validate，然后选择 Containerize with Docker。可选操作：点击 Deploy Local Container 并连接客户端进行测试。
选择 Upload Image and Create App Version。在浏览器中，设置与您的传输协议相符的端口：7777、UDP，命名为 gameport。提交。

选项 B：让您的 Agent 执行。

“构建 Linux 专用服务器，使用适用于 linux/amd64 的 edgegap-unity Dockerfile 将其容器化，推送到带有新标签的 Edgegap Container Registry，然后创建端口为 7777 UDP 名为 gameport 的应用和应用版本。”

Agent 会要求您亲自运行 docker login registry.edgegap.com，并使用来自 Container Registry 页面的用户名和令牌，从而避免这些凭据泄露在聊天中。请确保应用版本已设置镜像仓库凭据：缺少这些凭据会导致部署失败并提示“Unable to pull image from registry”。

每次构建都请使用新的镜像标签，切勿使用 latest。

以下是我们关于 Edgegap 的 Unity 插件的视频教程，该教程基于 Edgegap 的 Boss Room 分支版本：

5. 部署测试服务器并连接

在添加配对功能之前，先手动启动一台服务器，以验证镜像、端口和网络代码是否正常工作。以下任何一种方法均可：

从插件中：选择您的应用程序和版本，然后选择Deploy to Cloud（部署到云端）。
从控制台中：在 Edgegap 控制台中打开您的应用程序版本，选择Deploy（部署），挑选离您较近的地点，然后进行部署。
通过您的智能体（Agent）：“在我附近部署我的最新 Edgegap 版本，等待它就绪，显示日志，并向我提供 IP 地址和外部端口。”

当部署状态为 Ready（就绪）时，复制其 Host IP（主机 IP）和 External Port（外部端口）。请使用 IP，而不是主机名：Unity Transport 需要 IP 地址。将它们设置为 Unity Transport 上的客户端连接数据，然后按 Play。Boss Room：选择 Join with IP（通过 IP 加入），并输入 IP 和外部端口。外部端口在每次部署时都会发生变化，因此请每次都重新查看。在处于“就绪”状态后，服务器可能需要最多一分钟才能接受玩家。

完成后停止部署（在插件中使用 Stop Last Deployment（停止上次部署），或指示您的智能体）。免费套餐一次只能运行一个部署，遗忘的测试服务器会阻碍配对。

在这里，您手动选择了地点并分发了地址。若要自动将玩家分组并在离他们较近的地方启动服务器，请添加配对器（matchmaker）。

6. 添加匹配功能

Edgegap 的撮合系统（matchmaker）是一项托管服务：玩家发送票证，它会根据您的规则（比赛规模、队伍、延迟、技术水平、模式）对玩家进行分组，在离他们较近的地点部署您的服务器，并将地址返回给每个客户端。

使用您的智能体（Agent）：

“为我的应用版本生成 Edgegap matchmaker 配置：一支 2 到 4 人的队伍，并允许单人玩家在 20 秒后获取服务器，以便我单独测试。将其保存为 matchmaker-config.json。”

然后，在控制台中（此步骤没有 API）：

打开 Matchmaker 并选择Create Matchmaker。
为其命名，上传 matchmaker-config.json，然后选择 Create and Start。
当其状态为 ONLINE 时，复制 API URL 和 Auth Token。Auth Token 可以安全地随游戏客户端一同发布：它不会提供对您 Edgegap 账户的访问权限。

回到智能体：

“将 matchmaker 的 API URL 和 Auth Token 填入 EdgegapMatchmakingClient，将我的 Play 按钮关联到 FindMatch，然后重新构建并推送服务器，创建一个新的应用版本，并告诉我需要在 matchmaker 中更新什么。”

Boss Room：让智能体通过 Boss Room 的 ConnectionManager IP 连接来连接匹配到的玩家，这样示例的连接有效负载和角色选择功能仍然有效。在 Edgegap 的分支上，它可以替换 UGS 的 Matchmake 按钮或并排显示。

手动操作：请遵循我们文档中的 Unity 匹配指南。

发布新的服务器构建时，请更新 matchmaker 配置中的 application.version（停止、编辑、启动），否则比赛将继续部署旧版本。

7. 与两名玩家一起测试完整循环

请确保没有测试部署仍在运行。
运行两个客户端：Editor 加上一个构建版本，或者两个 Multiplayer Play Mode 玩家。
在两者中都选择 Find Match。状态会从 searching（搜索中）变为 match found（找到比赛），再到 host assigned（已分配主机），然后两个客户端都会连接到同一台服务器。
离开比赛。服务器会记录其正在停止，并且部署将从仪表板中消失。正是这种自动停止机制使您在无人游玩时账单保持为零。

在免费层级中，撮合器（matchmaker）在每次启动 3 小时后停止（可从仪表板重新启动），部署会在 60 分钟后停止，且一次只运行一个部署。