了解Edgegap的工作原理

了解Edgegap的工作原理

Fish-Networking

SpaceEdge (WebGL)

部署至 Edgegap

SpaceEdge (WebGL):在 Edgegap 专用服务器上运行 Edgegap 的 FishNet 太空射击游戏,支持匹配

已发布

已发布

最近一次准确性审核

最近一次准确性审核

在 Edgegap 专用游戏服务器上运行的 SpaceEdge (WebGL) 示例游戏 (Fish-Networking)

SpaceEdge 是 Edgegap 基于 Unity 构建的 Fish-Networking (FishNet) 太空射击游戏示例。该版本在浏览器中运行:玩家可以在 Unity WebGL 中飞行、射击和计分,每场比赛都运行在专属的 Edgegap 专用游戏服务器上。

游戏代码保持 FishNet 原样:相同的 NetworkManager、Bayou 传输层、预测机制和 RPC。 该示例仅在外部添加了几个 Edgegap 脚本:一个用于启动服务器,一个用于寻找比赛,还有一个用于在切换场景时保持它们存活。

没有玩家作为比赛的主机。专用服务器会校验每一次射击,控制生命值和得分,并在所有人离开后自行停止部署。游戏客户端不包含任何 Edgegap API 令牌。

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

支持平台:基于安全 WebSocket (wss://) 的浏览器 Unity WebGL;Linux 专用服务器。README 说明 Windows 桌面构建版本也可通过 Bayou 运行(未包含在本次测试运行中)。Unity 2021.3.45f2,FishNet 4.1.6R。使用了 Unity Asset Store 上的免费素材(Cartoon FX、Sci-Fi Sfx、Star Sparrow、Starfield Skybox、TotalJSON),遵循各自的许可协议。

工作原理

  1. 玩家在浏览器中打开游戏并选择 Start Game。

  2. 直连模式(默认):客户端连接到在 MatchmakingSystem 上设置的服务器地址和端口。匹配器模式(可选):客户端向 Edgegap Matchmaker 发送票据,由其将 2 到 4 名玩家分组并在他们附近启动一台 Edgegap 服务器。

  3. 服务器通过普通 WebSocket 在 0.0.0.0:7770 上启动 FishNet。Edgegap 的 TLS Upgrade 添加了安全层,因此浏览器使用 wss:// 连接到部署的主机名。无需购买证书。

  4. 玩家在 BattleScene 中飞行和射击。服务器校验每一次射击,并掌控生命值与得分。

  5. 如果 120 秒内无人加入,或者在最后一名玩家离开 30 秒后,服务器将自行停止部署,计费随之停止。

示例所做的修改:

路径

作用

Assets/SpaceEdge/Scripts/Systems/MatchmakingSystem.cs

将 Start Game 关联到直连(默认)或匹配客户端。关闭匹配器时,它会禁用匹配客户端。

Assets/Edgegap/EdgegapMatchmakingClient.cs

匹配器模式:创建票据,等待 HOST_ASSIGNED,然后使用 wss://{fqdn}:{external port} 连接。延迟探测信标在 WebGL 中处于关闭状态。

Assets/Edgegap/EdgegapServerLifecycle.cs

服务器构建版本:在端口 7770 上启动 FishNet 服务器,读取 Edgegap 注入的变量,并在房间为空时停止部署。替换了 FishNet 的 Start On Headless。

Assets/Edgegap/EdgegapPersistence.cs

在 MainMenu → BattleScene → MainMenu 的场景切换过程中保持 Edgegap 对象存活。

Assets/Edgegap/Editor/

命令行 Linux 服务器和客户端构建,以及场景设置。

Packages/manifest.json

将 Edgegap Unity SDK 固定为 3.5.6,并将 Edgegap Unity 插件固定为 3.2.2,均作为 Git 软件包引入。

.dockerignore, matchmaker-config.json

基于 Ubuntu 22.04 并带有 CA 证书的服务器镜像;用于浏览器的匹配器配置文件。

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

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

Two spaceships flying over a glowing hexagon grid in FishNet's SpaceEdge sample, built for WebGL.

浏览器中的 SpaceEdge:每艘飞船都在同一个 Edgegap 专用服务器上飞行。

分步指南

运行示例

1. 开始之前

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

  • 带有 Linux Build Support (Mono)、Linux Dedicated Server Build Support 和 WebGL Build Support 模块的 Unity 2021.3.45f2。

  • 已安装并正在运行的 Docker Desktop。

  • Python 3 或任何静态 Web 服务器,用于在本地托管 WebGL 构建版本。

  • 使用 git clone 克隆该代码仓库,然后在 Unity Hub 中打开 Fishnet_v4.1.6R_WebGL_Matchmaker 文件夹。其他文件夹为旧版示例;部分示例在游戏客户端中包含了 Edgegap API 令牌,因此仅可用于本地测试。

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

2. 本地播放

打开 Tools → Edgegap Server Hosting。使用 Edgegap 登录(或粘贴来自“Get token”的令牌)并验证(Validate),然后构建服务器(Build server)。构建产物将输出到 Builds/EdgegapServer/。

使用 Docker 进行容器化:镜像名称为 fishnet-server,标签留空(插件将使用当前 UTC 时间),使用默认 Dockerfile。

在本地测试您的服务器:将“Optional Docker Run Parameters”设置为 -p 7770:7770,然后部署本地容器(Deploy local container)。

Docker Desktop 显示 Edgegap Server | Starting server on 0.0.0.0:7770.。该插件会传递模拟的 Edgegap 变量,因此如果没有人加入,服务器将在启动 120 秒后退出;或者在最后一名玩家离开 30 秒后退出。

通过 File → Build Settings 构建 WebGL 客户端,或通过命令行构建:

Unity -batchmode -projectPath . -executeMethod EdgegapClientBuild.Build -edgegapClientTarget webgl

托管 Builds/Client/webgl 目录,例如使用 python -m http.server 8080,在两个标签页中打开 http://localhost:8080 并分别选择 Start Game。默认设置(localhost、7770、Direct Use Wss 关闭)将连接到本地服务器。

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

仍在该插件窗口中,选择“Upload to Edgegap”:

输入一个“Application Name”(示例的匹配器配置要求为 fishnet-webgl-matchmaker),然后依次点击“Upload image”和“Create app version”。

该插件会将镜像推送到您的 Edgegap 镜像仓库,并打开控制台的版本表单,其中镜像和标签已自动填充。

保留插件建议的版本名称(即镜像标签),并在匹配器配置中使用它。

在版本表单上:

  • 端口(Port):替换表单的默认端口,名称设为 gameport,端口为 7770,协议为 WS,开启 TLS Upgrade。Edgegap 会处理 TLS,因此浏览器使用 wss:// 连接,而服务器端使用常规的 ws 协议。

  • 确保已设置镜像仓库登录信息:使用“Registry Profile”,或者来自容器镜像仓库页面的用户名和令牌,否则部署拉取镜像将会失败。

每次构建都会生成一个新的镜像标签,切勿使用 latest。

4. 在 Edgegap 服务器上开始游戏

在插件中选择“Deploy to cloud”,或在版本页面上选择靠近您的“Deploy”。当状态显示“Ready”时:

  1. 在 MainMenu 场景中的 MatchmakingSystem 对象上,将 Direct Address 设置为部署的主机名(<id>.pr.edgegap.net,而非其 IP),将 Direct Port 设置为其外部端口,并勾选 Direct Use Wss。

  2. 重新构建 WebGL 客户端,运行该客户端,并在两个标签页中进行游戏。

外部端口会在每次部署时发生变化,因此请每次都进行确认。如果无人加入,服务器将在启动 120 秒后停止部署;最后一名玩家离开 30 秒后,服务器也会停止部署。

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

该示例是一个可用的参考:您的编码智能体可以直接复制其经过测试的文件,而无需从头编写。通过四处修改,即可使 FishNet 浏览器游戏在 Edgegap 上运行:

  1. 服务器自行启动。Assets/Edgegap/EdgegapServerLifecycle.cs 会在服务器构建中通过固定端口启动 FishNet。请在 ServerManager 上关闭 Start On Headless,这样同一场景即可同时适用于客户端和服务器构建。

  2. 服务器自行停止。同一个脚本会读取 Edgegap 注入的变量,并在没有玩家时停止部署,从而停止计费。

  3. 在场景切换时保持存活。Assets/Edgegap/EdgegapPersistence.cs 会在 FishNet 加载场景时保持 Edgegap 对象存活。如果没有它,服务器的自停止逻辑将随菜单场景一同销毁。

  4. 浏览器安全连接。运行在 7770 端口的 Bayou、应用版本上带有 TLS Upgrade 的 WS 端口,以及通过 wss:// 连接到主机名的客户端(MatchmakingSystem.cs、EdgegapMatchmakingClient.cs)。

然后以示例的 Dockerfile 为模板对服务器进行容器化,并按照步骤 3 创建应用版本。

配合您的智能体:

"加载 edgegap 技能,然后加载 edgegap-fishnet。以 github.com/edgegap/netcode-game-sample-unity-fishnet-hashgrid/tree/main/Fishnet_v4.1.6R_WebGL_Matchmaker 为参考,将我的 FishNet 游戏转换为 WebGL 专属服务器游戏:7770 端口上的 Bayou、Edgegap 服务器生命周期、持久化和匹配客户端脚本、关闭 Start On Headless、客户端通过 wss 连接到主机名,以及一个没有延迟规则且在 allowed_cors_origins 中包含我的 Web 源的匹配器配置。"

如需手动查看每个步骤的详细信息,请参阅 Fish-Networking 集成指南。有关适用于任何 Unity 网络代码的浏览器规则,请参阅 Unity WebGL。

6. 开启 Edgegap Matchmaker

撮合程序(matchmaker)对玩家进行分组,在他们附近启动一个 Edgegap 服务器,并将该服务器地址提供给每个客户端。在示例中,该功能处于关闭状态,直到您将其勾选开启。

  1. 在 matchmaker-config.json 中,将 application.name 和 version 设置为您的应用和版本,并在 allowed_cors_origins 中列出提供 WebGL 构建版本服务的所有网址(文件中包含 http://localhost:8080)。

  2. 在控制面板中,打开 Matchmaker,选择 Create Matchmaker,上传该文件并选择 Create and Start。

  3. 在 MainMenu 中,将 API URL 和 Auth Token 复制到 Edgegap 对象的 Edgegap 匹配 Client 上的 Base Url 和 Auth Token 中。Auth Token 可以安全地随客户端一同发布。在 MatchmakingSystem 上勾选 Use Edgegap Matchmaker。

  4. 重新构建客户端,从允许的来源(origin)提供服务,打开两个标签页并在两边都选择 Start Game。

网页浏览器游戏的两个规则,已包含在示例配置中:

  • 无延迟规则。 浏览器无法 ping Edgegap 的延迟信标,因此 Edgegap 根据玩家的 IP 来部署服务器。

  • 列出您的来源。 如果没有在 allowed_cors_origins 中列出它们,浏览器将阻止撮合程序的回复。

casual 配置文件匹配 2 到 4 名玩家。当您发布新的服务器构建时,使用插件中的 Upload to Edgegap → Rebuild from Source(它会进行构建、容器化并使用新标签推送),使用相同的 WS 端口保存新的应用版本,然后在撮合程序中选择 Stop → Edit application.version → Start。

已知限制

  • 使用两名玩家进行测试。 该配置文件在 20 秒后将人数下限降至 1 名玩家,并且票证在 30 秒后过期。在之前 5 分钟过期的情况下,单人票证只能在接近过期时才获得服务器;单人玩家的情况尚未在 30 秒过期机制下重新测试。

  • 免费层。 匹配器每 3 小时重启一次(URL 和令牌保持不变),并且一次只运行一个部署。遗留的测试部署会阻止匹配。

  • 服务器端尚无票证检查。 服务器不会检查连接的客户端是否持有比赛的票证之一(MM_TICKET_IDS),并且没有补充填补(backfill)。这两者都是实际游戏的后续步骤。

  • 直连模式是手动的。 如果没有匹配器,您需要将每个部署的主机名和端口复制到客户端并重新构建。

测试了什么

于 2026 年 10 月 15 日在 Edgegap 上进行了端到端测试,配置包括 Unity 2021.3.45f2、FishNet 4.1.6R、Bayou、带有 3.5.6 中发布的 POST 修复的 Edgegap Unity SDK 3.5.5,以及免费层级的 matchmaker 3.3.2:

  • 撮合系统(Matchmaker):两个 WebGL 标签页成功匹配,分配到同一服务器,通过带有 TLS Upgrade 的 wss:// 进行连接并顺利游玩。

  • 自动停止(Self-stop):比赛结束后,服务器自动停止了自身的部署。

  • 本地(Local):Docker 服务器记录日志 Starting server on 0.0.0.0:7770. 并在 localhost 上接收 WebGL 客户端。

该项目目前固定使用包含相同修复的 SDK 3.5.6,并使用 Edgegap Unity 插件构建其服务器(2026 年 10 月 29 日为 3.2.1,自 11 月 9 日起固定为 3.2.2;插件构建已在本地容器中验证,尚未在 Edgegap 上与客户端一同测试)。通过 Bayou 的桌面客户端:应该可以运行,但不属于本次测试运行的一部分。

常见问题

关于在 Edgegap 上通过浏览器运行 FishNet 的 SpaceEdge 示例的疑问。

FishNet WebGL 游戏可以连接到专用服务器吗?

是的,使用 Bayou WebSocket 传输即可。服务器在端口 7770 上运行普通 WebSocket,Edgegap 的 TLS Upgrade 添加了安全层,浏览器使用 wss:// 连接到部署的主机名。SpaceEdge 正是这样做的。

在线游玩 SpaceEdge 需要使用 Edgegap Matchmaker 吗?

不。默认情况下,示例会直接连接到您设置的服务器地址和端口,因此您可以针对从控制面板启动的部署进行测试。勾选“Use Edgegap Matchmaker”(使用 Edgegap 匹配器)可让玩家自动分组并连接。

SpaceEdge 客户端是否持有 Edgegap API 令牌?

不。在配对(matchmaker)模式下,它仅使用配对器的身份验证令牌(Auth Token),这可以安全地打包到客户端中。同一代码库中的旧文件夹会从客户端调用 Edgegap API,因此这些文件夹仅用于本地测试。

为什么匹配系统在 Unity 2021.3 上会失败?

在 Unity 2022.3 之前,Edgegap Unity SDK 3.5.5 及更早版本发送的票证 JSON 会被配对器拒绝并返回 HTTP 400。请使用 SDK 3.5.6 或更高版本;该示例固定使用 3.5.6。

客户

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

解锁

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