平台

游戏

资源

企业

公司

平台

游戏

资源

企业

公司

了解Edgegap的工作原理

了解Edgegap的工作原理

對局配對

對局配對

和

和

托管与编排

托管与编排

整合

/

Unreal Engine

Unreal Engine

部署至 Edgegap

已发布

已发布

已发布

最近一次准确性审核

最近一次准确性审核

最近一次准确性审核

Unreal Engine：如何在数分钟内为多人游戏添加专用游戏服务器及對局配對

Unreal Engine：如何在数分钟内为多人游戏添加专用游戏服务器及對局配對

本指南将向您展示如何为 Unreal Engine 多人游戏添加专用游戏服务器并托管在 Edgegap 上，然后添加匹配功能，以便玩家自动分组并连接到离他们较近的服务器。

一旦您的游戏服务器容器化，Edgegap 即可通过简单的 API 调用将其按需部署到全球 615 多个边缘云位置，并完全按使用量计费：无需租用、预配整个服务器，也无需在对局之间保持服务器运行。对于需要预留容量的持久服务器，Edgegap 提供了 Private Fleets。Edgegap 的對局配對以此为基础构建，且是可选的。

Unreal 的复制机制本身就是以服务器为权威的，因此专用服务器是天然的选择：没有玩家作为主机，不会拥有延迟优势，也不会因有玩家退出而导致比赛结束。

本指南涵盖：

  1. 准备 Unreal、您的 Edgegap 账户和 Docker

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

  3. 为专用服务器准备您的 Unreal 项目

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

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

  6. 添加匹配（可选）

  7. 使用两名玩家测试完整流程

我们建议使用 Edgegap 的 Docker Extension 进行构建，以节省时间和资源。 Unreal 只能通过源码构建的引擎来构建专用服务器。传统方法意味着需要下载并编译引擎（首次需要 1 到 3 小时），安装 Linux 交叉编译工具链并打包服务器（首次约需一小时）。而 Docker Extension 则可以在 Windows、macOS 或 Linux 上，直接通过启动器安装的 Unreal 在 Docker 内部构建您的 Linux 服务器。这两种方法均在第 4 步中介绍。

您可以通过两种方式进行，也可以将它们结合使用：

  • 使用编码智能体。 将 Claude Code、Cursor 或其他智能体连接到 Edgegap MCP server 及其 agent skills。智能体将编辑您的项目和配置，添加匹配和服务器关闭代码，部署您的服务器并设置匹配。您只需在 Docker Extension 中点击 Build，操作 Edgegap 控制面板，然后进行试玩测试。跳过引擎源码构建还可以为您的智能体节省数小时的构建监控时间以及随之产生的 token 消耗。

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

在这里，我们使用 Epic 的多人示例游戏 Lyra。任何 Unreal 多人项目的运作方式都是相同的。

与工程师联系

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

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

分步指南

详细集成步骤

1. 开始之前

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

  • Unreal Engine 5，从 Epic Games 启动器安装。仅在使用传统方法（步骤 4，选项 B）时，才需要从源代码构建引擎。

  • 一个 C++ 项目。纯蓝图项目首先需要一个 C++ 模块：在编辑器中，选择工具 → 新建 C++ 类 → 无（空类）。您的蓝图将保持正常工作，无需更改。

  • Docker Desktop 和 Edgegap 的 Docker 扩展。安装并启动 Docker Desktop，然后从 Docker 的扩展市场安装 Edgegap Docker 扩展。

  • 访问 GitHub 上的 Unreal Engine 的权限。该扩展会从 Epic 的 GitHub 组织下载所需内容：

  • 对于 Agent 路径：需要一个 Edgegap API 令牌，可从仪表板 → 用户设置 → 令牌获取。该令牌适用于整个组织，因此请像对待密码一样妥善保管：切勿将其放入您的项目、游戏客户端或聊天中。

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

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

Edgegap MCP 服务器允许您的 Agent 在您的账户上创建应用程序和版本、部署服务器、读取日志并生成匹配器配置。edgegap-unreal Agent 技能为其提供了经过测试的 Unreal 工作流、用于匹配和服务器关闭的 C++ 即插即用文件，以及已知踩坑点说明。

Claude Code（在您自己的终端中运行，这样 Token 就绝不会经过聊天窗口）：

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"] } } }。首次使用时会要求输入 Token。

检查是否正常运行：

“列出我的 Edgegap 应用程序。”

返回空列表也是正常的。如果提示与 Token 相关的错误，通常意味着请求头被错误解析成了 token token ...。

3. 让您的 Unreal 项目准备好支持专用服务器

在 Edgegap 上，没有玩家会作为比赛的主机。无头专属服务器（dedicated server）掌管着整场游戏，因此它必须能够自行启动、打开游戏地图、监听固定端口，并在比赛结束时停止运行。

使用您的智能体：

"加载 edgegap-unreal 技能并使该项目支持专属服务器。我将使用 Edgegap 的 Docker 扩展来构建 Linux 服务器，因此跳过引擎源码构建、Linux 工具链和 RunUAT 打包。添加 Server 目标，设置 ServerDefaultMap 以及需要烘焙（cook）的地图，从 docs.edgegap.com/unreal-engine 添加 DefaultEngine.ini 配置，并复制 EdgegapMatchmakerSubsystem 和 EdgegapServerSubsystem 文件（目前暂时禁用匹配功能）。检查编辑器目标是否仍能正常编译。"

该技能的默认设置为传统的源码构建。告知智能体您将使用 Docker 扩展进行构建，可以防止其启动源码构建流程。

手动操作：

  • 服务器地图。在项目设置 → 地图与模式（Project Settings → Maps & Modes）中，将服务器默认地图（Server Default Map）设置为服务器打开的地图，并确保它在要烘焙的地图列表中。

  • 引擎设置。从 Edgegap Unreal 文档中复制 DefaultEngine.ini 代码片段到 Config/DefaultEngine.ini 的末尾，并将其最后一行（DefaultServerTarget）替换为您的服务器目标名称。这会禁用客户端与服务器构建版本之间的 Unreal 版本检查，并为同步复制设置 IpNetDriver。然后重启编辑器。

  • 服务器目标。如果 Source/<PROJECT>Server.Target.cs 不存在，请复制 <PROJECT>Editor.Target.cs，将副本重命名为 <PROJECT>Server.Target.cs，并将其中所有的 "Editor" 替换为 "Server"。然后添加文档中的服务器构建默认配置，这样可以在发行版本（shipping builds）中保留日志。

  • 监听服务器（Listen-server）习惯。专属服务器取代了房主玩家。对于假定服务器上存在本地玩家的代码（如 HUD、音频、GetFirstPlayerController()），请使用 IsRunningDedicatedServer() 进行条件保护，并从菜单中移除“主持游戏”（Host game）。

  • 比赛结束时停止。使用 Docker 扩展构建时，在比赛结束时于服务器上调用 FGenericPlatformMisc::RequestExit，部署即可停止。

Lyra

Lyra 已经自带了 LyraServer.Target.cs：向其中添加构建默认配置。在地图与模式（Maps & Modes）中，将服务器默认地图（Server Default Map）设置为 ShooterGym，并在代码片段中设置 DefaultServerTarget=LyraServer。

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

Edgegap 在容器中运行您的 Linux 服务器构建版本。我们建议选择“方案 A”：它能为您节省首次构建的数小时时间，并随之节省代理的 Token。

方案 A（推荐）：Edgegap 的 Docker 扩展插件。无需引擎源码构建，无需 Linux 工具链，适用于任何操作系统。下方视频演示了使用 Lyra 的这一流程。

  1. 在 Docker Desktop 中打开 Edgegap 扩展插件。输入您的项目名称和 Edgegap 令牌（如果您没有，请选择 Get Quick Start Token），然后选择 Validate Token。

  2. 选择 Unreal Engine，然后点击 Browse 浏览至您的项目文件夹并选择 Create Project。该扩展插件会自动填入您的引擎版本。

  3. 输入第 1 步中的 GitHub 用户名和个人访问令牌（Personal Access Token）。

  4. 选择 Validate Configuration。所有三项检查都必须显示为绿色。

  5. 保留默认的 Dockerfile、镜像名称和标签，然后选择 Build Project。

  6. 本地测试：选择新标签，点击 Start Local Server，然后在 Unreal 中运行客户端（新编辑器窗口 (PIE)），并在其控制台中输入 open 127.0.0.1:7777。确认运行正常后停止本地服务器。

  7. 选择 Upload Image。在浏览器中创建应用程序，保留默认资源配置，并将端口设置为 7777、UDP，命名为 gameport。提交。

稍后需要重新构建？再次选择 Build Project 并使用新标签，然后选择 Upload Image。

方案 B：传统方法，从引擎源码构建。如果您的工作室已经在维护源码构建版本，请使用此方案。

  • 您需要准备：来自 Epic 官方 GitHub 的引擎源码（如第 1 步所述已关联）、包含 C++ 游戏工作负载的 Visual Studio 2022、与您的引擎版本匹配的 Linux 交叉编译工具链，以及 Docker Desktop。

  • 时间规划：下载引擎需要 20 到 60 分钟，构建需要 1 到 3 小时，打包第一个 Linux 服务器大约需要 1 小时。后续构建仅需几分钟。

通过您的代理操作：

“加载 edgegap-unreal skill 并按照从引擎源码构建的流程进行操作：构建引擎，打包 Linux 服务器，使用该 skill 针对 linux/amd64 的 Dockerfile 将其容器化，使用新标签推送到我的 Edgegap Container Registry，然后创建应用程序及应用程序版本，端口设置为 7777 UDP，命名为 gameport。”

代理会要求您自行运行 docker login registry.edgegap.com，并使用来自容器注册表（Container Registry）页面的用户名和令牌，从而避免这些凭据出现在对话中。请确保应用程序版本已设置注册表凭据：如果没有凭据，部署将会失败并提示“Unable to pull image from registry”。

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

以下是我们使用 Lyra 针对 Unreal Engine 的 Edgegap Docker Extension 视频教程：

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

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

  • 通过 Docker 扩展：在 Edgegap Application Version 下，选择您刚刚创建的版本，然后选择 Deploy to Cloud。

  • 通过控制面板：在 Edgegap 控制面板中打开您的应用程序版本，选择 Deploy，挑选一个离您较近的地点并进行部署。

  • 通过您的代理：“在离我较近的地点部署我的最新 Edgegap 版本，等待部署就绪，向我展示日志，并提供地址和外部端口。”

当部署状态显示为 Ready 时，复制其 Host 和 External Port。在 Unreal 中运行客户端，并在控制台中输入 open <host>:<external port>。外部端口在每次部署时都会发生变化，因此请每次都重新查看。服务器在状态变为 Ready 后，可能需要最多一分钟的时间才能开始接受玩家接入。

完成后停止部署（可通过扩展、控制面板或您的代理）。免费套餐一次只能运行一个部署，遗忘的测试服务器会阻止配对的进行。

在此步骤中，您自行选择了位置并分发了地址。若要自动将玩家编组并在离他们较近的位置启动服务器，请添加配对系统。

6. 添加匹配功能

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

使用您的智能体：

“根据 edgegap-unreal 延迟模板为我的应用版本生成 Edgegap matchmaker 配置：一支 2 到 4 人的队伍、一条延迟规则，并允许单独一名玩家在 10 秒后获取服务器，以便我自己进行测试。将其保存为 matchmaker-config.json。”

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

  1. 打开Matchmaker并选择 Create Matchmaker。

  2. 为其命名，上传 matchmaker-config.json，然后选择 Create and Start。

  3. 当其状态为 ONLINE 时，复制 API URL 和 Auth Token。Auth Token 可以安全地随游戏客户端一同发布：它不会授予对您 Edgegap 账户的访问权限。

回到您的智能体：

“使用我的 matchmaker API URL 和 Auth Token 开启 EdgegapMatchmakerSubsystem，配置文件设为 casual，开启信标延迟（beacon latencies）。请先检查 URL 和令牌的响应。”

撮合代码仅在客户端运行，因此步骤 4 中的服务器镜像不会改变。玩家会看到一个 Find Match 浮层，蓝图也可以从子系统中调用 Find Match、Cancel Match 和 On Status Changed 以用于您自己的菜单。在公开代码仓库中，请将真实的 URL 和令牌保存在 Config/UserGame.ini 中，Git 会忽略该文件，而 Unreal 仍会将其打包。

手动操作：请遵循撮合文档，或参阅對局配對 for Unreal Engine。

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

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

  1. 请确保没有正在运行的测试部署。

  2. 并排运行两个客户端，例如 UnrealEditor.exe <your .uproject> -game -windowed -ResX=960 -ResY=540 -WinX=0 -log，第二个客户端加上 -WinX=970。请先单独启动一个客户端：首次启动需要编译着色器，耗时几分钟。

  3. 在 10 秒内在两个客户端中均选择查找比赛（Find Match）。状态会从正在搜索变为找到比赛，随后两个客户端将加入同一个服务器。

  4. 关闭两个客户端。大约一分钟后，服务器将停止其自身的部署，并从控制面板中消失。这种自动停止机制可以在无人玩游戏时将您的账单保持为零。

在免费套餐中，撮合系统会在每次启动 3 小时后停止（可从控制面板重新启动），部署会在 60 分钟后停止，且一次只能运行一个部署。

后续步骤

后续步骤

准备上线？让您的智能体运行 edgegap-launch 技能的检查清单：版本推出、重启策略、最长持续时间、成本控制。使用 Epic Online Services 进行大厅管理？请参阅 Epic Online Services。

遇到问题？让您的智能体加载 edgegap-troubleshoot，或在 Edgegap Discord 上向我们的团队和其他工作室咨询。

常见问题

关于在 Edgegap 专用服务器上托管 Unreal Engine 游戏（无论是否包含匹配功能）的常见问题。

我需要从源码编译 Unreal Engine 才能用于专用服务器吗？

使用 Edgegap 的 Docker 扩展则无需如此。它可以直接基于通过启动程序安装的 Unreal 在 Docker 内部构建您的 Linux 服务器，从而节省数小时的引擎编译时间。若没有它，Unreal 则需要从源码构建的引擎来构建 Server 目标。

我可以在 Windows 或 macOS 上构建 Linux 专用服务器吗？

是的。Edgegap 的 Docker 扩展程序可在 Windows、macOS 或 Linux 上的 Docker 内部构建 Linux 服务器，无需安装 Linux 交叉编译工具链。

Unreal 专属服务器在 Edgegap 上使用哪个端口？

Unreal 的 IpNetDriver 默认通过 UDP 在 7777 端口进行监听。请在您的 Edgegap 应用程序版本上设置相同的端口和协议，并将其命名为 gameport。玩家将连接到 Edgegap 为每次部署分配的外部端口。

我可以在纯蓝图的 Unreal 项目中添加匹配功能吗？

是的。添加一个空的 C++ 类以创建一个 C++ 模块，然后添加 Edgegap 的匹配子系统。您的蓝图（Blueprints）调用 Find Match，并从该子系统监听其状态。

托管一个 Unreal Engine 游戏服务器需要多少费用？

测试是免费的，无需信用卡。之后，Edge Cloud 仅在服务器运行期间按每 vCPU 每分钟计费，因此在每场比赛结束时停止的服务器在比赛之间不产生任何费用。

客户

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

全托管集群

常驻部署