了解Edgegap的工作原理

了解Edgegap的工作原理

對局配對

對局配對

和

和

托管与编排

托管与编排

整合

/

Mirror Networking

/

Tanks (WebGL)

Mirror Networking

Tanks (WebGL)

部署至 Edgegap

已发布

已发布

已发布

Tanks (WebGL)：在 Edgegap 专用服务器上运行 Mirror 的 Tanks，支持匹配

Tanks (WebGL)：在 Edgegap 专用服务器上运行 Mirror 的 Tanks，支持匹配

Tanks 是 Mirror 的示例游戏之一：玩家在竞技场中驾驶坦克相互射击。Edgegap 的示例将其构建为浏览器版本 (WebGL)，并在专属的独立游戏服务器上运行每场对局。

Mirror 和 Tanks 游戏本身保持不变：该示例保留了 Mirror 的 SimpleWebTransport 和原始场景，并添加了一些可选脚本。启用它们后，玩家只需点击寻找比赛即可，无需输入服务器地址。

Edgegap 的匹配器会将玩家分组，然后为他们启动一台服务器。Edgegap 的网络覆盖 615 多个边缘云节点（了解更多），每台服务器都会部署在最适合其玩家的可用位置。浏览器通过安全的 WebSocket 进行连接，当对局为空时服务器会自动停止。

平台：浏览器中的 WebGL 客户端；Linux 专用服务器。Unity 6.3 LTS (6000.3.11f1)，Mirror 86.13.4。Tanks 是 Mirror 的一部分，采用 MIT 许可协议。

工作原理

  1. 玩家在浏览器中打开游戏并点击寻找比赛。客户端向 Edgegap 的匹配器发送票证。

  2. 匹配器将 2 至 4 名玩家分为一组。由于浏览器无法执行 ping 操作，因此它会根据玩家的公网 IP 分配服务器位置。

  3. Edgegap 在离他们较近的位置启动 Tanks 服务器。服务器在端口 7778 上监听 WebSocket，并通过 Edgegap 的 TLS Upgrade 为其配置证书。

  4. 每个客户端获取服务器的主机名和外部端口，并连接到 wss://{主机名}:{端口}，在服务器启动期间会持续重试。

  5. 当所有人都离开超过 30 秒，或者在 2 分钟内无人加入时，服务器将自行停止部署。

示例新增内容：

路径

功能说明

Assets/EdgegapMatchmaking/TanksMatchmakingClient.cs

“寻找比赛/取消”面板。创建票证，等待服务器，并通过 wss:// 连接 Mirror。

Assets/EdgegapMatchmaking/TanksMatchmakingServer.cs

仅限专用服务器。读取 Edgegap 注入的变量，并在对局为空时停止部署。

Assets/EdgegapMatchmaking/TanksMatchmakingDTOs.cs

票证属性。在此添加字段以自定义匹配器规则。

Assets/EdgegapMatchmaking/Edgegap.Tanks.Matchmaking.asmdef

仅在安装了 Edgegap Unity SDK 3.5.5 或更高版本时才启用这些脚本。如果没有安装，它们将编译为空存根。

Assets/EdgegapMatchmaking/link.xml

在 IL2CPP 构建（WebGL 和 Linux 服务器）中保留 SDK 的数据类。

matchmaker-config.json

示例匹配器配置，配置文件 tanks-webgl。

与工程师联系

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

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

Top-down view of a tank with its health bar on rocky ground, in Mirror's Tanks sample running in a browser.

浏览器中的 Mirror's Tanks 示例，其专用服务器运行在 Edgegap 上。

分步指南

运行示例

1. 开始之前

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

  • Unity 6.3 LTS（示例使用 6000.3.11f1），并在 Unity Hub 中添加了 Linux Build Support (Mono)、Linux Build Support (IL2CPP)、Linux Dedicated Server Build Support 和 Web Build Support。

  • Docker Desktop，在构建服务器时需保持运行。

  • 克隆该示例并在 Unity 中打开。Edgegap 插件会随项目一起安装。

Git：Unity 需要在 PATH 中配置 Git 客户端（2.14.0 或更高版本），以通过 Git URL 安装软件包（例如 Edgegap 插件）。macOS 通常已自带该客户端（Xcode Command Line Tools）；在 Windows 上，请安装 Git。

2. 开启匹配功能

匹配默认处于关闭状态，因此示例在打开和构建时无需使用 Edgegap SDK。要将其开启：

首先，在 Window → Package Manager 中，选择 +，然后选择 Add package from git URL，并粘贴：

https://github.com/edgegap/edgegap-unity-sdk.git#3.5.5

然后打开 MirrorTanks 场景，选择 EdgegapMatchmaking 对象并勾选其名称旁边的复选框。

请在构建服务器之前完成此操作，以便服务器包含 TanksMatchmakingServer 并在比赛结束时自行停止。

3. 将游戏服务器部署到 Edgegap

打开 Tools → Edgegap Server Hosting，连接您的 Edgegap 账户，然后选择 Build Server、Containerize with Docker 以及 Upload Image and Create App Version。

在浏览器中，设置应用版本的端口：

  • 端口 7778，协议 WS，名称 gameport。

  • 开启 Verifications，开启 TLS Upgrade。TLS Upgrade 会为服务器提供一个安全的 WebSocket 地址，以便 https:// 页面上的浏览器可以访问它。您不需要拥有自己的证书。

Unity WebGL 指南的步骤 4 详细介绍了插件界面和代理选项。

4. 创建匹配器并开始游戏

编辑代码库根目录下的 matchmaker-config.json：

  • application.name 和 application.version：来自步骤 3 的应用程序和版本。

  • allowed_cors_origins：提供 WebGL 构建版本服务的每个地址。示例中已列出 http://localhost:8080。浏览器会直接调用撮合器（matchmaker），因此其他来源会被阻止。

在控制面板中，打开Matchmaker，选择 Create Matchmaker，上传该文件并选择 Create and Start。当其状态为 ONLINE 时，将 API URL 和 Auth Token 复制到 TanksMatchmakingClient（位于 EdgegapMatchmaking 对象上）的 Base URL 和 Auth Token 中。

在 File → Build Profiles 中针对 Web 进行构建，然后从允许的来源提供构建文件夹服务：

python -m http.server 8080 --bind 127.0.0.1

在两个浏览器窗口中打开 http://localhost:8080，并在每个窗口中点击 Find Match。点击前请将每个窗口置于前台：后台标签页会降低 Unity WebGL 的运行速度。两个窗口将连接到同一个 Edgegap 服务器。单个玩家在 30 秒后将单独获得一个服务器，这有助于进行测试。

5. 将其添加到你自己的 Mirror WebGL 游戏中

该示例是一个可用的参考：您的编码 Agent 可以直接复制其经过测试的文件，而无需从头编写。这些更改使 Mirror WebGL 游戏能够与 Edgegap 的撮合系统配合运行：

  1. 固定端口上的 WebSocket。SimpleWebTransport 位于端口 7778，服务器端关闭 SSL，客户端使用 wss。无头启动模式（Headless Start Mode）设置为 Auto Start Server，并在 Build Settings 中启用了游戏场景（示例中的 MirrorTanks 场景）。

  2. 一个匹配客户端。创建票证（ticket），等待其服务器，然后重试连接到 wss://{host name}:{external port}（Assets/EdgegapMatchmaking/TanksMatchmakingClient.cs）。延迟信标在浏览器中保持关闭状态。

  3. 一个自动停止的服务器。当没有人加入或所有人都已离开时停止部署，从而停止计费（Assets/EdgegapMatchmaking/TanksMatchmakingServer.cs）。

  4. SDK 和代码剥离。Edgegap Unity SDK 3.5.5 或更高版本（旧版本会导致 WebGL 构建失败），以及用于 IL2CPP 的 link.xml。

  5. 一个匹配器配置，不含延迟规则，并将您的源添加到 allowed_cors_origins 中（matchmaker-config.json）。

然后上传带有 WS 端口和 TLS 升级的服务器，如步骤 3 所述。

配合您的 Agent 使用：

“加载 edgegap skill，然后加载 edgegap-unity。以 github.com/edgegap/netcode-game-sample-webgl-mirror-tanks 作为参考，将我的 Mirror 游戏设为端口 7778 上使用 SimpleWebTransport 的 WebGL 专属服务器游戏，从其 Assets/EdgegapMatchmaking 文件夹中添加匹配客户端和服务器自动停止功能，并生成一个没有延迟规则且在 allowed_cors_origins 中包含我的 Web 源的匹配器配置。”

如需手动查看每个步骤的详细信息，请参阅 Mirror Networking integration guide，有关浏览器特有的部分，请参阅 Unity WebGL guide。

6. 匹配系统如何分配玩家并关闭服务器

该示例的 tanks-webgl 配置文件专为浏览器构建：

  • 对局人数：一队 2 到 4 名玩家。在队列中等待 30 秒后，人数下限降至 1，以便你可以单独测试。在实际游戏中请移除该扩展规则。

  • 无延迟规则。浏览器无法发送桌面游戏用来测量延迟的 Ping 数据包。因此，撮合系统会根据玩家的公网 IP 来部署服务器。

  • 允许的来源。allowed_cors_origins 列出了允许调用撮合系统的页面。发布前，请添加你的实际主机地址，例如你的 itch.io 页面。

  • 废弃的匹配票据。浏览器可以在不通知游戏的情况下关闭标签页，因此未匹配的票据会在 5 分钟后自动过期。

Auth Token 会随客户端版本一起提供，就像任何使用该撮合系统的游戏一样。它不会提供访问你的 Edgegap 账户的权限。

服务器会自动停止自身的部署，从而结束计费：

  • 最后一名玩家离开 30 秒后；

  • 2 分钟内无人加入时。

上传新的服务器版本时，请在撮合系统中更新 application.version（停止、编辑、启动），否则比赛将继续部署旧版本。Unity WebGL 指南的第 6 步详细介绍了撮合系统。

已知限制

  • 匹配默认处于关闭状态。开箱即用时，该示例不包含 SDK，且 EdgegapMatchmaking 对象处于非活动状态。请按照步骤 2 将其开启。

  • 比赛绝不会自行结束。Tanks 没有回合或获胜者，因此服务器仅在变为空时才会停止。对于您自己的游戏，请在比赛结束时停止部署。

  • 在浏览器中没有基于延迟的部署放置。服务器是根据玩家 IP 进行放置的。客户端脚本可以通过单独配置文件中的 latencies 规则测量桌面构建中的延迟：代码已编写但未进行测试。

  • 单人扩展仅用于测试。使用示例配置文件时，等待 30 秒的玩家将单独游玩。

测试了什么

在 2026 年 10 月 15 日（该示例的 PR #1 在当天合并）之前，于 Edgegap 上进行了两次端到端测试，运行环境为 Unity 6000.3.11f1：

  • 完整循环：两个从 http://localhost:8080 提供的 WebGL 客户端、一个实时撮合器，以及一个在端口 7778 上带有 WS 和 TLS 升级的应用版本。两个客户端均完成匹配，首次尝试即通过 wss:// 连接到部署的外部端口，且在两个客户端离开后服务器自行停止。

  • 匹配关闭（默认）：场景加载且无缺失脚本，WebGL 和 Linux 服务器构建均告成功。

  • 匹配开启（SDK 3.5.5）：WebGL 和 Linux 服务器构建成功。在 Edgegap 外部运行时，服务器记录日志“Not running on Edgegap, self-stop disabled”并继续提供服务。

未测试：带有延迟信标的桌面客户端，以及通过此示例在 itch.io 上托管 WebGL 构建版本。

后续步骤

后续步骤

常见问题

关于在浏览器中使用 Edgegap 运行 Mirror 的 Tanks 示例的疑问。

Mirror WebGL 游戏可以使用玩家匹配（matchmaking）吗？

是的。Edgegap 的匹配器可以在浏览器中运行：客户端发送票据（ticket），匹配器在玩家附近启动一台专用服务器，每个客户端通过 wss:// 进行连接。在 allowed_cors_origins 中列出提供您游戏的页面，并省略延迟规则。

哪种 Mirror 传输协议可以在浏览器中运行？

SimpleWebTransport。Tanks 示例在端口 7778 上运行它，服务器端关闭 SSL，客户端使用 wss。在 Edgegap 上，将该端口设置为 WS 并开启 TLS Upgrade，Edgegap 会处理证书。

为什么 Tanks 示例中的匹配功能被关闭了？

因此该示例在没有额外包的情况下也能打开并构建。安装 Edgegap Unity SDK（3.5.5 或更新版本），然后在 MirrorTanks 场景中激活 EdgegapMatchmaking 对象。将其停用可再次关闭匹配。

比赛结束后《坦克世界》服务器还会继续运行吗？

不会。示例服务器会在最后一名玩家离开 30 秒后，或者在无人加入 2 分钟后自动停止部署，因此您无需为空闲服务器付费。

客户

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

/ vCPU

/ 小时

按月计费，始终开启

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

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

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

全球 58 个分支机构

包含出站流量

每台主机总计 16 个 vCPU（14.7 个可用）

比较功能与价格

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

预留容量

$0.0261

/ vCPU

/ 小时

按月计费，始终开启

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

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

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

全球 58 个分支机构

包含出站流量

每台主机总计 16 个 vCPU（14.7 个可用）

比较功能与价格

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

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

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

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

Edgegap 的功能与价格：边缘云与私有集群（Private Fleets）详细对比

Edgegap 的功能与价格：边缘云与私有集群（Private Fleets）详细对比

对比

免费试用

边缘云

Private Fleets

账单与价格

每个 vCPU 的费率

免费

0.00115 美元/vCPU/分钟

$0.0261/vCPU/小时

定价模式

免费

按需（基于使用量）

预留容量

账单

无需信用卡

是的，通过 Stripe

是的，通过 Stripe

承诺

无

无

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

出口

不适用

$0.10/GB/月

含每个主机每月 6 TB 流量

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

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

中国部署

DDoS 防御

全托管集群

常驻部署

对比

免费试用

边缘云

Private Fleets

账单与价格

每个 vCPU 的费率

免费

$0.00115 / vCPU / 分钟

$0.0261/vCPU/小时

定价模式

免费

按需（基于使用量）

预留容量

账单

无需信用卡

是的，通过 Stripe

是的，通过 Stripe

承诺

无

无

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

出口

不适用

$0.10/GB/月

含每个主机每月 6 TB 流量

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

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

中国部署

DDoS 防御

全托管集群

常驻部署

对比

免费试用

边缘云

Private Fleets

账单与价格

每个 vCPU 的费率

免费

0.00115 美元/vCPU/分钟

$0.0261/vCPU/小时

定价模式

免费

按需（基于使用量）

预留容量

账单

无需信用卡

是的，通过 Stripe

是的，通过 Stripe

承诺

无

无

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

出口

不适用

$0.10/GB/月

含每个主机每月 6 TB 流量

功能特色

分析与监控

账单警报

点击展开

还有 28 行

解锁

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

中国部署

DDoS 防御

全托管集群

常驻部署