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

SpaceEdge 是 Edgegap 基于 Unity 构建的 Fish-Networking (FishNet) 太空射击游戏示例。该版本在浏览器中运行:玩家可以在 Unity WebGL 中飞行、射击和计分,每场比赛都运行在专属的 Edgegap 专用游戏服务器上。
游戏代码保持 FishNet 原样:相同的 NetworkManager、Bayou 传输层、预测机制和 RPC。 该示例仅在外部添加了几个 Edgegap 脚本:一个用于启动服务器,一个用于寻找比赛,还有一个用于在切换场景时保持它们存活。
没有玩家作为比赛的主机。专用服务器会校验每一次射击,控制生命值和得分,并在所有人离开后自行停止部署。游戏客户端不包含任何 Edgegap API 令牌。
Edgegap 的网络覆盖 615 多个边缘云节点(了解更多)。每台服务器都会部署在最适合其玩家的可用位置,并且仅在比赛运行期间计费。
完整指南:参考 Fish-Networking integration guide,将 Edgegap 添加到你自己的 FishNet 游戏中
支持平台:基于安全 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),遵循各自的许可协议。
工作原理
玩家在浏览器中打开游戏并选择 Start Game。
直连模式(默认):客户端连接到在
MatchmakingSystem上设置的服务器地址和端口。匹配器模式(可选):客户端向 Edgegap Matchmaker 发送票据,由其将 2 到 4 名玩家分组并在他们附近启动一台 Edgegap 服务器。服务器通过普通 WebSocket 在
0.0.0.0:7770上启动 FishNet。Edgegap 的 TLS Upgrade 添加了安全层,因此浏览器使用wss://连接到部署的主机名。无需购买证书。玩家在
BattleScene中飞行和射击。服务器校验每一次射击,并掌控生命值与得分。如果 120 秒内无人加入,或者在最后一名玩家离开 30 秒后,服务器将自行停止部署,计费随之停止。
示例所做的修改:
路径 | 作用 |
|---|---|
| 将 Start Game 关联到直连(默认)或匹配客户端。关闭匹配器时,它会禁用匹配客户端。 |
| 匹配器模式:创建票据,等待 |
| 服务器构建版本:在端口 7770 上启动 FishNet 服务器,读取 Edgegap 注入的变量,并在房间为空时停止部署。替换了 FishNet 的 Start On Headless。 |
| 在 MainMenu → BattleScene → MainMenu 的场景切换过程中保持 |
| 命令行 Linux 服务器和客户端构建,以及场景设置。 |
| 将 Edgegap Unity SDK 固定为 |
| 基于 Ubuntu 22.04 并带有 CA 证书的服务器镜像;用于浏览器的匹配器配置文件。 |

浏览器中的 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”时:
在
MainMenu场景中的MatchmakingSystem对象上,将 Direct Address 设置为部署的主机名(<id>.pr.edgegap.net,而非其 IP),将 Direct Port 设置为其外部端口,并勾选 Direct Use Wss。重新构建 WebGL 客户端,运行该客户端,并在两个标签页中进行游戏。
外部端口会在每次部署时发生变化,因此请每次都进行确认。如果无人加入,服务器将在启动 120 秒后停止部署;最后一名玩家离开 30 秒后,服务器也会停止部署。
5. 将其添加到你自己的 FishNet 游戏中
该示例是一个可用的参考:您的编码智能体可以直接复制其经过测试的文件,而无需从头编写。通过四处修改,即可使 FishNet 浏览器游戏在 Edgegap 上运行:
服务器自行启动。
Assets/Edgegap/EdgegapServerLifecycle.cs会在服务器构建中通过固定端口启动 FishNet。请在ServerManager上关闭 Start On Headless,这样同一场景即可同时适用于客户端和服务器构建。服务器自行停止。同一个脚本会读取 Edgegap 注入的变量,并在没有玩家时停止部署,从而停止计费。
在场景切换时保持存活。
Assets/Edgegap/EdgegapPersistence.cs会在 FishNet 加载场景时保持Edgegap对象存活。如果没有它,服务器的自停止逻辑将随菜单场景一同销毁。浏览器安全连接。运行在 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 服务器,并将该服务器地址提供给每个客户端。在示例中,该功能处于关闭状态,直到您将其勾选开启。
在
matchmaker-config.json中,将application.name和version设置为您的应用和版本,并在allowed_cors_origins中列出提供 WebGL 构建版本服务的所有网址(文件中包含http://localhost:8080)。在控制面板中,打开 Matchmaker,选择 Create Matchmaker,上传该文件并选择 Create and Start。
在
MainMenu中,将 API URL 和 Auth Token 复制到Edgegap对象的 Edgegap 匹配 Client 上的 Base Url 和 Auth Token 中。Auth Token 可以安全地随客户端一同发布。在MatchmakingSystem上勾选 Use Edgegap Matchmaker。重新构建客户端,从允许的来源(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 的工作室案例研究。

《以太之战 2》完美的全球发布
Aether Studios
了解Aether Studios是如何快速添加Edgegap并向他们的社区交付完美的启动和后启动服务的。
案例研究

克服因虚拟现实在竞技Multiplay中使用WiFi而引入的延迟
Halfbrick Studios
Discover how Halfbrick successfully launched & maintains a multiplayer-focused Early Access on META Quest's VR platform.
案例研究

MENA的社交应用添加了在线游戏
WOLF
了解这款在中东和北非地区广受欢迎的社交应用如何轻松地将 matchmaking 和多人游戏编排添加到 WOLF Qanawat。
案例研究

混合编排让开球策略随时应对任何流量做好准备
Birch Games
混合编排如何帮助 Birch Games 应对流量——将免流出费用的 Fleets 与无区域限制云相结合。
案例研究

真实的在线战争需要终极的协调
Highwire Games
了解Highwire对性能的需求如何需要只有Edgegap才能提供的编排。
案例研究

22,000 条评价、4.8 颗星以及自动扩展的基础架构
Sinn Studios
一个由 Slack 提供支持的简单集成,如何让 Sinn Studio 的热门 VR 游戏快速上线并保持稳定运行。
案例研究

动态服务器编排
Under NDA - AAA Studio
了解世界上最大的AAA工作室之一如何通过边缘计算改善其对等多人游戏体验。
案例研究

对于 AAA 格斗游戏的近零延迟
AAA Studio - Under NDA
一个未宣布的项目如何实现了最低延迟,并改善了其1v1游戏中的公平性。
案例研究

Play Gods with Multiplayer Physics
Squido Studio
Learn how Squido uses Edgegap's highligh optimized game servers to deliver mind-bending & chaotic VR gameplay.
案例研究

全面托管的解决方案为独立游戏节省时间 多人VR恐怖游戏
Dirty Pearl Studios
了解Dirty Pearl Studios如何通过Edgegap的轻松集成和自动编排,以及其Nakama集成,节省了开发时间。
案例研究

7天血月
The Fun Pimps & iLLOGIKA
了解 Illogika 如何大幅降低服务器成本,并确保提供《七日杀 (7 Days to Die)》玩家所期望的在线体验。
案例研究

即时全球服务器部署以促进协作式XR医学教育
AlensiaXR
AlensiaXR如何利用Edgegap为全球医学生提供低延迟、始终可用的共享解剖课程。
案例研究

趣加
FunPlus
案例研究

守光人:具有专用服务器的 VR 社交合作游戏
Spectral Games
Spectral Games 如何在无需任何服务器经验的情况下,利用 Edgegap Matchmaking 和 Server Browser 为其 VR 社交大厅启动专用服务器。
案例研究

全球范围内快速可靠的部署,适用于PvPvE挑战者Gravebound
Crater Studios
Edgegap 的调度和配对如何帮助 Crater Studios 使他们能够将重心从基础设施转移到游戏玩法上。
案例研究

快速扩展网络元宇宙
Hiber
了解Hiber如何通过Edgegap消除服务器容量规划中的猜测。
案例研究

高硬件要求和自定义游戏服务器池
Alderon Games
了解Alderon Games如何瞬间利用全球多个供应商的自定义游戏服务器池来支持其热门MMO。
案例研究

独立开发者的简单集成
WhaleFood Games
阅读关于WhaleFood Games如何使用Edgegap解决其网络代码问题的文章。
案例研究

推动东南亚首款电子竞技游戏的尖端技术。
Anantarupa Studios
了解Edgegap如何通过一个无缝解决方案简化复杂基础设施和尖端技术,从而改变东南亚的游戏格局。
案例研究

一次打击。全球抵达。
Triple Hill Interactive
Triple Hill Interactive如何利用Edgegap的编排来提供低延迟,并提高在每毫秒都至关重要的游戏类型中的公平性。
案例研究

快节奏团队大逃杀...带着枪的动物毛绒玩具!
SANDYFLOOR
了解一家韩国独立工作室是如何将其多人游戏发布到全球的。
案例研究

移动端赛马游戏凭借即时、高效能的服务器走向全球
Mirai Labs
看 Mirai Labs 如何通过即时服务器部署和细分 vCPU 来运行 Pegaxy Blaze 的全球多人竞速游戏,从而将单个玩家的成本保持在极低水平。
案例研究

服务器管理与分发
Matrioshka Games
阅读关于Matrioshka Games如何在资源有限的情况下发布早期访问的战斗 Royale。
案例研究

听我的信号,释放地狱!
TyGames
探索独立工作室TyGames如何让玩家沉浸在第三人称角斗士战斗的多人游戏中。
案例研究

瞬时全球编排
Soliton Interactive
探索Soliton Interactive如何做到了不可能……首次推出可多人玩的版本!
案例研究

竞技游戏具有服务器端物理引擎,确保理想的低于50毫秒的延迟
NS7
了解为什么仅有Edgegap能够使独立工作室通过服务器端物理和权限实现其AAA质量的免费游戏体育玩法愿景。
案例研究

iGaming的区域部署
X1 Contra 1
X1 Contra 1 通过经济高效的托管和区域部署,为其巴西玩家提供实时 PvP 休闲游戏,确保数据和法律合规。
案例研究

仅在玩家游玩时付费:经济实惠的多人游戏基础设施
Meltdown Interactive
Edgegap 如何帮助独立开发商 Meltdown Interactive Media 在无需复杂方案的情况下,以高性价比解决扩缩容和匹配问题,从而让他们能够专注于游戏开发。
案例研究

同一个 Edgegap 平台,三种截然不同的网络配置
Warped Games
了解 Warped Games 如何在同一个 Edgegap 部署 API 和同一个容器管线上运行社交中心、实时合作以及回合制合作。
案例研究

台球大师巡回赛Max
RETA Games
案例研究

韩国的Web3 POP提取射击游戏走向全球,即刻启程
NDUS Entertainment
XOCIETY 如何轻松地添加 Edgegap 编排并集成自定义 matchmaking,与 Edgegap Ping Beacons 一起优化延迟。
案例研究

Multiplayer in Every Dimension
Arcadia.tv
Discover how Arcadia.tv uses Edgegap's edge network to deliver an innovative, team and location-based athletic VR sport.
案例研究

F2P 移动格斗游戏利用即时(Just-In-Time)服务器降低基础设施成本
Game Changers Worldwide
Game Changer Worldwide 如何在全球移动端托管 Rumble Rush 的实时 3v3 PvP 游戏。
案例研究
他们选择 Edgegap 的关键原因
了解 Edgegap 自动化游戏服务器编排如何带来无缝的多人游戏体验。









