> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/zh/docs/sample-projects/unity-netcodes/small-network-relay.md).

# Lightnet 小型网络中继

在 Edgegap 上托管一个可扩展的小型网络中继，并通过它在 Mirror、FishNet、PurrNet 或用于游戏对象的 Netcode 中游玩 Tanks，支持房间代码或 Edgegap 匹配。

探索如何在 Edgegap 上运行你自己的小型网络中继，并借助一个通过它运行的 Unity 游戏示例，使用 [Mirror](https://mirror-networking.com/), [FishNet](https://fish-networking.gitbook.io/docs), [PurrNet](https://purrnet.dev/) 或 [GameObjects 网络代码（NGO）](https://docs-multiplayer.unity3d.com/netcode/current/about/).

这个中继是一个基于 [LightNet](https://github.com/edgegap/server-sample-unity-smart-relays)构建的小型 .NET 服务器。Edgegap 会像托管和编排其他服务器一样托管它：一次部署，在靠近玩家的地方启动。一个玩家主持房间并获得 6 位字母代码，其他玩家使用该代码加入。没有玩家需要打开端口：包括主机在内的所有人都是该中继的客户端。

本示例展示：

* **一个中继服务器** 在一个 `linux/amd64` Docker 镜像中，监听端口 `7777` ，同时用于 TCP（可靠消息）和 UDP（不可靠消息），
* **带加入代码的房间** - 多个房间可以共享一个中继部署，
* **四种网络代码下的 Tanks 示例** - 在一个 Unity 项目中同时包含 Mirror、FishNet、PurrNet 和 NGO，一次构建，
* **一个设置即可切换网络代码** - 在设置资源、编辑器菜单、进入游戏连接前，或命令行中，
* **可选的 Edgegap 匹配** - 默认关闭： **查找匹配** 将附近玩家配对到一个靠近他们的中继上，每个房间由一名玩家主持，稍后搜索的玩家加入正在运行的房间，而满员房间的中继会在另一个中继启动前开设新房间，
* **可选加密连接** - `wss://` 通过 Edgegap 的 TLS 升级，连同普通 TCP 和 UDP 一起，
* **自动化测试** - 游戏客户端在每种网络代码下通过中继进行对战，可使用房间代码或通过匹配器。

{% hint style="success" %}
**这是客户端主机架构**：托管玩家同时作为服务器运行，中继在玩家之间转发字节。
{% endhint %}

{% hint style="info" %}
另一种方案 - [专用服务器](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#orchestration) 可防止主机玩家获得优势，并且在主机离开后比赛仍可继续。
{% endhint %}

## ✔️ 准备工作

开始之前，你需要：

* [小型网络中继示例项目](https://github.com/edgegap/server-sample-lightnet-relay),
* [Unity `6000.0.54f1`](https://unity.com/releases/editor/archive)，用于打开并构建游戏，
* [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) （可选），仅用于在 Docker 外运行中继。

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">安装 Docker Desktop（或 Docker CLI）</a></summary>

* [从官方来源安装 Docker Desktop](https://www.docker.com/products/docker-desktop/) （无需账户）。
* 完成安装后重启计算机。

</details>

仓库包含四个部分：

| 文件夹                      | 内容                                                        |
| ------------------------ | --------------------------------------------------------- |
| `LightNet`               | 作为 Unity 包的 LightNet 网络核心，以及中继协议和与网络代码无关的客户端。             |
| `relay-server`           | 中继服务器 - 由相同源代码构建的 .NET 8 控制台应用，以及它的 Dockerfile。           |
| `tanks`                  | Unity 项目：Mirror、FishNet、PurrNet 和 NGO 上的 Mirror Tanks 示例。 |
| `matchmaker-config.json` | 可选的匹配器配置，见 [可选匹配](#optional-matchmaking).                 |

## 🔀 选择网络代码

网络代码是 `网络代码` 字段，位于 `tanks/Assets/Tanks/Resources/TanksSettings.asset`: `Mirror`, `FishNet`, `PurrNet` 或 `NGO`。同一资源还保存中继地址和端口。

你也可以这样切换它：

* 在 Unity 编辑器中，使用 **Tanks > Netcode** 菜单——这也会打开对应网络代码的场景，
* 在游戏中，通过屏幕顶部的网络代码按钮，在主机或加入前，
* 在命令行中，使用 `-netcode FishNet`.

| 网络代码    | 版本     | Tank 同步                                                                   |
| ------- | ------ | ------------------------------------------------------------------------- |
| Mirror  | 66.0.9 | `SyncVar`, `Command`, `ClientRpc`，客户端权威 `NetworkTransform`                |
| FishNet | 4.7.4  | `SyncVar<int>`, `ServerRpc`, `ObserversRpc`，客户端权威 `NetworkTransform`      |
| PurrNet | 1.24.1 | `SyncVar<int>`, `ServerRpc`, `ObserversRpc`，所有者权威 `NetworkTransform`      |
| NGO     | 1.13.0 | `NetworkVariable<int>`, `ServerRpc`, `ClientRpc`，所有者权威 `NetworkTransform` |

{% hint style="warning" %}
**主机和每个玩家都必须使用相同的网络代码。** 中继不会验证网络代码兼容性。
{% endhint %}

每种网络代码都有自己独立的中继传输层，构建于相同的中继客户端（`RelayPeer`): `MirrorRelayTransport`, `FishNetRelayTransport`, `PurrNetRelayTransport` 和 `NgoRelayTransport`）。要在自己的游戏中使用该中继，请复制 `LightNet` 适用于你的网络代码的包和传输层。

## ⚡ 部署并连接

### 1. 在本地运行中继

☑️ 从仓库根目录构建并运行中继镜像：

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 -f relay-server/Dockerfile -t lightnet-relay:dev .
docker run -p 7777:7777/tcp -p 7777:7777/udp -p 7778:7778/tcp lightnet-relay:dev
```

{% endcode %}

☑️ 打开 `tanks` 在 Unity 中，选择一个网络代码，并使用以下方式构建 **Tanks > Build Windows client**，或者在以下场景中点击播放： `Assets/Tanks/Scenes/Boot.unity`.

☑️ 在第一份游戏中，点击 **主机**：房间代码会出现在屏幕上。在第二份游戏中，输入该代码并点击 **加入房间**.

✅ 现在你可以进入下一步了。

### 2. 推送中继镜像

☑️ 开始之前，你需要 [创建一个 Edgegap 免费账户](https://app.edgegap.com/auth/register)。无需信用卡。

☑️ 找到你的 [容器注册表](https://docs.edgegap.com/zh/learn/advanced-features/edgegap-container-registry.md) 项目名称和凭据。

☑️ 使用 Docker 登录 Edgegap 的容器注册表，使用你的注册表项目名、用户名和令牌：

{% tabs %}
{% tab title="Bash（Linux）" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell（Windows）" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

☑️ 标记并推送中继镜像，每次构建使用一个新标签：

{% code collapsedlinecount="10" %}

```bash
docker tag lightnet-relay:dev registry.edgegap.com/<project>/lightnet-relay:<tag>
docker push registry.edgegap.com/<project>/lightnet-relay:<tag>
```

{% endcode %}

{% hint style="danger" %}
:x: **不要 - 覆盖现有标签或使用 `latest` 标签** ——这会部署过时的缓存。\
:white\_check\_mark: **要 - 始终递增你的版本标签** 并部署新构建。
{% endhint %}

{% hint style="warning" %}
每个组织都有自己的注册表项目， **请务必修改命令以匹配你的项目。**
{% endhint %}

✅ 现在你可以进入下一步了。

### 3. 创建应用版本

☑️ [创建一个应用](https://app.edgegap.com/application-management/applications/list) 命名为 `lightnet-relay`，以及一个版本，内容如下：

* 镜像 `registry.edgegap.com/<project>/lightnet-relay` 和你的标签，
* 你的容器注册表用户名和令牌，以便 Edgegap 拉取你的镜像，
* 资源 0.25 vCPU 和 512 MB 内存，
* 一个 [端口](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md) `7777`，命名为 `relay`，协议 **TCP/UDP**,
* ，可选，用于 [加密连接](#encrypted-connection)：第二个端口 `7778`，命名为 `relay-ws`，协议 **WS**，开启 **TLS 升级** ，
* [最大时长](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md) 30 分钟，用于测试。

{% hint style="warning" %}
使用一个协议为 **TCP/UDP**的端口项， `7777` 不要分开使用 `7777` TCP 和 UDP 项。这样 Edgegap 会让 TCP 和 UDP 共享同一个外部端口，因此玩家只需要一个端口号。
{% endhint %}

可选的中继设置，作为 [应用版本上的环境变量](https://docs.edgegap.com/zh/learn/bian-pai/application-and-versions.md#injected-variables):

| 变量                        | 默认值    | 作用                                                    |
| ------------------------- | ------ | ----------------------------------------------------- |
| `RELAY_TCP_PORT`          | `7777` | 可靠消息端口                                                |
| `RELAY_UDP_PORT`          | `7777` | 不可靠消息端口                                               |
| `RELAY_MAX_PEERS`         | `256`  | 所有房间的最大并发连接数                                          |
| `RELAY_IDLE_EXIT_SECONDS` | `600`  | 当在这么长时间内没有房间存在时停止中继， `0` = 永不（由匹配器启动的中继会在最后一个房间结束时停止） |
| `RELAY_WS_PORT`           | `7778` | WebSocket 连接端口， `0` = 关闭                              |
| `RELAY_MATCH_MAX_PLAYERS` | `4`    | 匹配器启动的中继中，每个房间的玩家数；回填会补满到这个数量                         |
| `RELAY_MAX_ROOMS`         | `4`    | 匹配器启动的中继中每个中继的房间数                                     |
| `RELAY_SOLO_ROOM_SECONDS` | `120`  | 关闭主机已经独自待了这么久的房间；然后游戏会再次搜索                            |
| `MATCHMAKER_URL`          |        | 匹配器 API URL，用于 [回填](#optional-matchmaking)            |
| `MATCHMAKER_TOKEN`        |        | 匹配器认证令牌，用于回填                                          |

✅ 现在你可以进入下一步了。

### 4. 部署并游玩

☑️ [部署你的新应用版本](https://app.edgegap.com/deployment-management/deployments/create) 到靠近玩家的地方。准备就绪后，记下其主机名（`<id>.pr.edgegap.net`）以及 `relay`.

☑️ 在两个游戏中， **在连接前在屏幕上设置中继地址和端口**，或者从命令行启动它们（替代方式）：

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -relay <id>.pr.edgegap.net -relayPort <external port> -host
Tanks.exe -netcode NGO -relay <id>.pr.edgegap.net -relayPort <external port> -join <code>
```

{% endcode %}

☑️ 在第一份游戏中主持一个房间，并用第二份游戏中的代码加入。

{% hint style="info" %}
中继日志显示在部署开始后立即连接又断开的玩家：那是 Edgegap 的就绪检查，不是真正的玩家。
{% endhint %}

<figure><img src="https://3334189208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fz9xjzvZwKSIp9IeC9qo8%2Fimage.png?alt=media&amp;token=e3f345ac-848d-4469-b66f-3655cd393cf3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
您在 Edgegap 云上的部署的外部端口将随机选择，以便在潜在攻击者（黑客）造成损害之前减缓并检测到他们。
{% endhint %}

{% hint style="warning" %}
**测试时请禁用 VPN** 以获得更真实的条件并接收一个 [低延迟部署](https://docs.edgegap.com/zh/learn/bian-pai/deployments.md#server-placement).
{% endhint %}

☑️ 一旦您确认可以无问题连接到您的部署并完成测试， **停止您的部署** 以释放您账户中的容量用于下一次构建。

* 如果您遇到问题， [检查您部署的仪表板日志](https://app.edgegap.com/deployment-management/deployments/list).
* 如果您无法找出问题，我们会在我们的频道等着您， [社区 Discord](https://discord.gg/NgCnkHbsGp) 遇到困难？我们在我们的

🙌 恭喜您在 Edgegap 上完成首次部署！如果您想了解更多，请继续阅读。

## 🎯 可选匹配

房间代码适合朋友之间使用。要匹配彼此不认识的玩家，请开启 Edgegap [匹配](https://docs.edgegap.com/zh/learn/pi-pei-xi-tong.md)：玩家点击 **查找匹配**，匹配器会将彼此接近的 2 到 4 名玩家分到一起，并为他们在靠近他们的地方启动一个中继。然后该中继选出一名玩家作为主机，并把房间代码给其他人，因此没人需要输入代码。稍后点击 **查找匹配** 的玩家会加入有空位的房间，而房间已满的中继会在匹配器启动另一个中继之前开新房间。它默认关闭，使用代码进行主机和加入仍然可用。

匹配如何开始：

1. 每个玩家的游戏都会测量自己到 Edgegap 信标的延迟，并创建一张匹配票。
2. 匹配器会将这些票分组，并根据你的应用版本部署一个中继。Edgegap 会把已匹配票的列表（`MM_TICKET_IDS`).
3. ）提供给该中继。每个游戏都用自己的票 ID 连接到中继。第一个请求的已匹配玩家会主持比赛房间，其他玩家加入。未进入匹配的票会被拒绝。
4. 当一个房间还有空位时，中继会通过回填向匹配器请求更多玩家。一旦每个房间都满了，它就改为提供一个新房间。见下方第 3 步。
5. 当最后一个房间结束时，中继会删除其所有回填并停止自身部署，因此已结束的比赛不会产生费用。

未部署匹配器的中继会像以前一样工作，使用房间代码。

### 1. 创建匹配器

☑️ 打开 `matchmaker-config.json` 来自仓库，并将 `application.name` 和 `版本` 设置为你在第 3 步中的应用版本：

{% code title="matchmaker-config.json" lineNumbers="true" expandable="true" collapsedlinecount="10" %}

```json
{
  "version": "3.3.3",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "profiles": {
    "casual": {
      "ticket_expiration_period": "30s",
      "ticket_removal_period": "1m",
      "group_inactivity_removal_period": "5m",
      "application": {
        "name": "lightnet-relay",
        "version": "<your version>"
      },
      "rules": {
        "initial": {
          "match_size": {
            "type": "player_count",
            "attributes": {
              "team_count": 1,
              "min_team_size": 9999,
              "max_team_size": 9999
            }
          },
          "beacons": {
            "type": "latencies",
            "attributes": {
              "difference": 100,
              "max_latency": 150
            }
          }
        },
        "expansions": {
          "10": {
            "match_size": {
              "team_count": 1,
              "min_team_size": 2,
              "max_team_size": 4
            }
          }
        }
      }
    }
  }
}
```

{% endcode %}

在前 10 秒内，一张票只能加入有空位的中继（`min_team_size` `9999` 无法满足）。10 秒后，通常规则生效，2 到 4 名等待玩家会得到一个新中继。

该 `信标` 规则会让玩家和附近的玩家匹配：如果玩家到某个信标的延迟低于 150 毫秒，则该信标计入；已匹配玩家到该信标的延迟彼此必须相差不超过 100 毫秒。游戏会在每张票中发送自己的延迟（**匹配器延迟信标** 在 `TanksSettings.asset`中，默认开启）。

{% hint style="warning" %}
**浏览器无法 ping 信标。** 对于 WebGL 构建，请使用不包含 `信标` 规则的配置文件，并将 **匹配器延迟信标** 关闭。
{% endhint %}

☑️ 在控制面板中，打开 [匹配器](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list)，点击 **创建匹配器**，上传该文件，然后 **创建并启动**.

☑️ 当匹配器 **在线**时，复制其 **API URL** 和 **认证令牌**.

{% hint style="info" %}
认证令牌可以安全地随游戏发布：它只允许玩家创建票据，不会授予你的 Edgegap 账户任何访问权限。
{% endhint %}

☑️ 将它们作为环境变量添加到你的应用版本中 `MATCHMAKER_URL` 和 `MATCHMAKER_TOKEN`，这样中继就可以填充空位（第 3 步）。

✅ 现在你可以进入下一步了。

### 2. 查找匹配

☑️ 在 `tanks/Assets/Tanks/Resources/TanksSettings.asset`中，开启 **使用匹配器** 并粘贴 **匹配器 URL** 和 **匹配器令牌**。配置文件（`casual`）和端口名称（`relay`）已经与上面的配置匹配。

☑️ 构建游戏，启动两个副本并在两者中点击 **查找匹配** 。或者从命令行启动它们：

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -matchmaker https://<id>.edgegap.net -matchmakerToken <token> -findMatch
```

{% endcode %}

☑️ 两个游戏都会显示匹配状态，然后一个主持、另一个加入：两个游戏里都会出现两辆坦克。

{% hint style="warning" %}
**请用两个玩家测试。** 一场匹配至少需要 2 名玩家，因此单个票据会继续搜索，并在 30 秒后过期。
{% endhint %}

匹配客户端位于 `Assets/Tanks/Core/TanksMatchmaker.cs`，构建于 [Edgegap Unity SDK](https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser)之上。它从不依赖网络代码：它会把中继地址写入设置，并像 **主机** 和 **加入房间** 按钮那样，作为主机或玩家启动游戏。

✅ 现在你可以进入下一步了。

### 3. 一个中继，多个房间

由匹配器启动的中继在第一次匹配开始后，会通过回填继续为其工作。回填是一个由中继拥有、并携带自身地址的票据。当匹配器把玩家的票据放入其中时，该玩家会获得中继地址，像其他人一样请求自己的角色，并加入或主持一个房间。游戏无需额外操作：这就是相同的 **查找匹配** 流程。

* **有空位的房间优先。** 只要一个房间少于 `RELAY_MATCH_MAX_PLAYERS` （默认 `4`）名玩家，无论是在房间里还是在路上，中继都会为其保持最多 3 个回填处于开启状态。被放入其中的玩家会加入该房间。
* **然后是新房间。** 一旦每个房间都满了，并且中继少于 `RELAY_MAX_ROOMS` （默认 `4`) 个房间，它就会提供一个新房间。被放到那里的玩家会担任主机，房间也会像其他房间一样被填满。
* **只有附近的玩家。** 中继会随回填发送该房间内玩家的票据，因此 `信标` 规则会据此检查新玩家。
* **单独留下的主机** 对于 `RELAY_SOLO_ROOM_SECONDS` （默认 `120`) 会收到房间已关闭的通知，游戏会自行寻找另一场匹配。
* **中继在其最后一个房间结束时停止**，而不是在某个主机离开时。它会先删除回填，因此不会把任何玩家发送到已经不存在的中继。
* **速率限制。** 每个中继最多同时开放 5 个回填，且创建间隔至少为 0.3 秒。

☑️ 当两台游戏之间正在进行一场对局时，按 **查找匹配** 下第三个：它会加入正在运行的房间，三台游戏都会看到三辆坦克。

☑️ 用 4 台游戏填满一个房间，然后按 **查找匹配** 下另外两次：第一台会在同一个中继上主机一个新房间，第二台会加入其中。

{% hint style="info" %}
如果没有 `MATCHMAKER_URL` 和 `MATCHMAKER_TOKEN` 在应用版本中，中继会记录 `回填：关闭`：其房间不会接收新玩家，也不会开启新房间。
{% endhint %}

中继的回填代码位于 `relay-server/MatchBackfill.cs` 和 `relay-server/RelayServer.cs`.

## 🔒 加密连接

默认情况下，通过中继的游戏流量是 **未加密的**：它通过明文 TCP 和 UDP 传输。保护玩家的是，没有人能看到其他玩家的 IP 地址，而且通过匹配器时只有已匹配的玩家才能获得房间代码。调用匹配器时使用 HTTPS。

若要加密，玩家也可以改为通过 WebSocket 连接。使用 **TLS 升级** 在 `relay-ws` 端口（第 3 步）时，Edgegap 持有证书，并且连接是 `wss://`：每个玩家与 Edgegap 之间的流量都经过加密，而中继不需要证书。

☑️ 给游戏提供一个 `wss://` 中继地址而不是主机名，并使用以下项的外部端口： `relay-ws`：在屏幕上、在 `TanksSettings.asset`，或在命令行中：

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -relay wss://<id>.pr.edgegap.net:<relay-ws external port> -host
```

{% endcode %}

☑️ 使用匹配器时，启用 **Matchmaker 使用 WebSocket** 在 `TanksSettings.asset` （或 `-matchmakerWebSocket`）：游戏会连接到匹配中继的 `relay-ws` 端口。

{% hint style="warning" %}
**WebSocket 仅运行在 TCP 上**：“不可靠”消息会可靠且按顺序到达，这会在连接较差时增加延迟。它更适合合作和回合制游戏，而不是快节奏射击游戏，因此它是 TCP 和 UDP 之外的一个选项。使用 TCP 和 UDP 的玩家以及使用 WebSocket 的玩家可以共用一个房间。
{% endhint %}

{% hint style="info" %}
使用主机名（`<id>.pr.edgegap.net`），而不是 IP 地址进行连接：证书是针对主机名的。加密在 Edgegap 处结束：中继和主机端游戏仍然能看到它们转发的内容，就像任何中继一样。
{% endhint %}

## 🌐 在浏览器中游玩

该游戏的 WebGL 构建会通过同一个中继，经由 `wss://`。浏览器中的玩家可以在四种网络代码下主机一个房间或加入一个房间，并与桌面构建的玩家共享。

浏览器没有 TCP 或 UDP 套接字，而 WebGL 构建没有 .NET `ClientWebSocket` 也没有线程。因此在 WebGL 构建中，示例的 LightNet 通过一个小型桥接使用浏览器自带的 WebSocket， `LightNet/Runtime/Relay/RelayWebSocket.jslib`。网络代码传输层与桌面端相同。

☑️ 在 Unity 中，选择 **Tanks > Build WebGL client**。构建会输出到 `tanks/Builds/WebGL`，且不压缩，因此任何静态文件服务器都可以提供它。

☑️ 使用中继的 `wss://` 地址打开页面，并使用以下项的外部端口： `relay-ws`。WebGL 构建没有命令行，因此它会从页面地址读取相同的选项。中继字段和 **主机** 和 **加入房间** 屏幕上的按钮也同样可用。

{% code collapsedlinecount="10" %}

```
index.html?netcode=FishNet&relay=wss://<id>.pr.edgegap.net:<relay-ws external port>&host
index.html?netcode=FishNet&relay=wss://<id>.pr.edgegap.net:<relay-ws external port>&join=<room code>
```

{% endcode %}

{% hint style="warning" %}
**让主机的标签页保持在前台。** 浏览器会暂停后台标签页中的页面，因此在浏览器中主机的房间会在其标签页被隐藏时停止。桌面构建能提供更稳定的主机。
{% endhint %}

{% hint style="info" %}
通过 HTTPS 提供的页面只能打开 `wss://`，不能打开 `ws://`。在浏览器中，所有流量都像任何 WebSocket 连接一样是可靠且按顺序的。使用匹配器时，浏览器不能对信标进行 ping，因此请使用一个不带 `信标` 规则的配置文件。
{% endhint %}

## 🧪 自动化测试

使用 Windows 构建并运行中的中继（本地或在 Edgegap 上）时， `e2e.sh` 会在每种网络代码下启动一个主机和一个客户端：

{% code collapsedlinecount="10" %}

```bash
./e2e.sh <id>.pr.edgegap.net <external port>
./e2e.sh 127.0.0.1 7777 FishNet NGO
./e2e.sh wss://<id>.pr.edgegap.net:<relay-ws external port> 0
```

{% endcode %}

客户端负责移动和射击。当两台游戏都看到两个坦克、两台都在可靠和不可靠通道上收到了数据、两台都看到了一个投射物生成，并且主机看到了客户端的坦克移动时，该网络代码即通过。

使用匹配器时， `e2e-matchmaker.sh` 它会通过匹配器运行同样的测试：在每种网络代码下，两台游戏按 **查找匹配** 并在匹配器启动的中继上进行对局。使用 `BACKFILL=1`时，第三台游戏按 **查找匹配** 一次，在对局运行后，它必须通过回填加入。使用 `MULTIROOM=1`时，四台游戏会填满一个房间，然后第五台必须在同一个中继上主机一个新房间，第六台必须加入其中。使用 `MM_WEBSOCKET=1`时，游戏通过 `wss://`.

{% code collapsedlinecount="10" %}

```bash
./e2e-matchmaker.sh https://<id>.edgegap.net <token>
./e2e-matchmaker.sh https://<id>.edgegap.net <token> FishNet NGO
BACKFILL=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
MM_WEBSOCKET=1 BACKFILL=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
MULTIROOM=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
```

{% endcode %}

## 💡 重要知识

* **中继如何转发数据** — 主机的消息只发送给一名玩家，而每位玩家的消息也只发送给主机。玩家之间不会直接通信。可靠消息通过 TCP 发送，不可靠消息通过 UDP 发送；或者两者都通过同一个 WebSocket 发送。
* **消息大小** — 每条不可靠消息最多 1,177 字节，每条可靠消息最多 16 KB。传输层会把这些限制报告给它们的网络代码。
* **当主机离开时** — 房间会关闭，中继会断开其玩家连接。此示例中的网络代码不会迁移主机。
* **一个中继还是多个中继** — 当玩家使用房间代码时，一个部署可服务多个房间。使用 [匹配器](#optional-matchmaking)时，每个中继最多托管 `RELAY_MAX_ROOMS` 个房间，且只有当附近的中继都满了之后才会启动新的中继。
* **对 LightNet 的更改** — 此示例的 LightNet 可在 NAT 和端口映射后工作：中继会在每位玩家流量发来的地址处响应其 UDP 流量。完整列表请参阅仓库的 README。
