> 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/unity.md).

# Unity - 快速入门

通过实践学习，并在 Edgegap 上部署你的第一个专用服务器。到本指南结束时，你将能够免费使用 Edgegap 部署一个专用服务器。

{% embed url="<https://youtu.be/4FR04V4YEUk>" %}

## ✔️ 准备工作

在开始之前，请确保 [在 Edgegap 创建一个免费账户](https://app.edgegap.com/auth/register) （无需信用卡）。

**在你的开发机器上配置一些基本设置：**

<details>

<summary>安装 Unity Linux 构建支持模块</summary>

* 使用 Unity Hub 选择 选项卡 **安装**，访问 **设置** 和 **添加模块** 对于您打算与 Edgegap 平台一起使用的每个 Unity 版本：

<figure><img src="/files/563f83de58ec91755c48c56b82376f73e54bdde9" alt=""><figcaption></figcaption></figure>

* 向下滚动以选择并安装以下 Unity 模块：
  * **Linux 构建支持（IL2CPP），**
    * **Linux 构建支持（Mono），**
    * **Linux 专用服务器构建支持**

<figure><img src="/files/fab307f7657f39c2c6dff6cae4911cbc8460b8ea" alt=""><figcaption></figcaption></figure>

</details>

<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>

<details>

<summary><a href="https://github.com/edgegap/edgegap-unity-plugin">安装 Edgegap 的 Unity 专用服务器快速开始插件</a></summary>

请参阅 [官方插件仓库](https://github.com/edgegap/edgegap-unity-plugin) 以获取安装的详细说明。

{% embed url="<https://youtu.be/3a5veDyxpoE>" %}

</details>

{% hint style="info" %}
**对你的服务器构建有信心吗？** 跳转到 [#customize-server-image](#customize-server-image "mention") 或 [高级功能](/zh/learn/advanced-features.md) 。
{% endhint %}

## ⚙️ 1. 连接账户

☑️ 登录并检查你的 Unity 控制台中是否没有与 Edgegap 插件相关的新错误。

✅ 现在你可以继续下一步。

<details>

<summary>故障排除与常见问题</summary>

`!成功：400 错误请求 - POST | https://api.edgegap.com/v1/wizard/init-quick-start - {"message": "浏览器（或代理）发送了一个此服务器无法理解的请求。"}`

* 如果你是通过复制 ZIP 文件安装的，或者使用了一个以这种方式安装了插件的示例项目，你将需要手动安装包括 Newtonsoft JSON 库在内的包依赖，参见 [官方插件仓库](https://github.com/edgegap/edgegap-unity-plugin/tree/main?tab=readme-ov-file#instructions-1).
* 如不是这种情况，请通过 [社区 Discord](https://discord.gg/NgCnkHbsGp) 联系我们寻求帮助。

</details>

## 🔧 2. 构建游戏服务器

无论你使用的是 Windows、Mac 还是 Linux 机器，你都将 **需要为 Linux 运行时构建你的服务器**，因为如今大多数云服务提供商（包括 Edgegap）都运行在 Linux 上。别担心，使用我们的插件完成这件事不需要 Linux 知识。

☑️ **确认你已安装所需的 Unity Linux 构建工具。**

<details>

<summary>安装 Unity Linux 构建支持模块</summary>

* 使用 Unity Hub 选择 选项卡 **安装**，访问 **设置** 和 **添加模块** 对于您打算与 Edgegap 平台一起使用的每个 Unity 版本：

<figure><img src="/files/563f83de58ec91755c48c56b82376f73e54bdde9" alt=""><figcaption></figcaption></figure>

* 向下滚动以选择并安装以下 Unity 模块：
  * **Linux 构建支持（IL2CPP），**
    * **Linux 构建支持（Mono），**
    * **Linux 专用服务器构建支持**

<figure><img src="/files/fab307f7657f39c2c6dff6cae4911cbc8460b8ea" alt=""><figcaption></figcaption></figure>

</details>

☑️ 编辑构建设置以 **确保包含所有必需的游戏场景**.

{% hint style="info" %}
**高级 Unity 用户** - 可选地更改 [Unity 构建设置](https://docs.unity3d.com/Manual/BuildSettings.html)。注意！这可能会破坏你的构建。
{% endhint %}

☑️ 可选：从 Edgegap Server Hosting 菜单（右键 / :heavy\_plus\_sign: 在你的层级窗口中）向初始服务器场景添加用于端口验证和环境引导的 netcode 特定脚本。

<figure><img src="/files/eff6c33e6df7153e5ed6e1c644217fe278c7a43b" alt="" width="360"><figcaption></figcaption></figure>

{% hint style="info" %}
一旦你完成步骤 [#id-6.-deploy-to-cloud](#id-6.-deploy-to-cloud "mention")，如果你的 netcode 地址或端口与你的 Edgegap [应用版本端口映射](/zh/learn/bian-pai/application-and-versions.md#other-parameters-optional) 配置不匹配，端口验证脚本将记录警告。
{% endhint %}

{% hint style="success" %}
服务器构建应在你的 netcode 传输中使用地址 `0.0.0.0`  和端口 `7777`  。如果你自定义了端口，请在你的 [应用与版本](/zh/learn/bian-pai/application-and-versions.md#port-mapping) 中指定相同的值，之后 [#id-5.-upload-to-edgegap](#id-5.-upload-to-edgegap "mention").
{% endhint %}

☑️ 当你对配置满意后，点击 **构建服务器**，等待进程完成并确认你的 Unity 控制台中没有新错误。完成此步骤后，项目根目录中将出现一个 **新文件夹** - `Builds/EdgegapServer/ServerBuild` .

✅ 现在你可以继续下一步。

<details>

<summary>故障排除与常见问题</summary>

Unity：唯一受支持的独立目标是带 OpenXR 的 Windows x64 和 OSX。

* 在构建服务器之前，打开你的 Packages 并禁用 OpenXR。
* OpenXR 插件仅供客户端使用，与 Linux 服务器构建不兼容。将其从服务器构建中排除不会丢失任何功能。

</details>

## 🐋 3. 容器化服务器

在开发团队中工作意味着要共享代码。当出问题时，你最不想听到的话就是“在我机器上能运行”。游戏服务器必须能在任何机器上稳定运行，因为成功的游戏服务器会运行在全球成千上万台服务器机器上。

为了帮助你的服务器保持可靠，我们使用 Docker——一种虚拟化软件，以确保你的所有服务器代码依赖项直到操作系统层级都始终完全相同，无论服务器如何或在何处启动。

{% hint style="info" %}
我们建议观看 [“永远不要本地安装”（视频）](https://www.youtube.com/watch?v=J0NuOlA2xDc\&ab_channel=Coderized). **使用 Docker 不需要使用 Dockerhub**。Docker ≠ Dockerhub。把 Docker 想象成一个编程引擎，把 Dockerhub 想成它的应用商店。
{% endhint %}

☑️ 现在先点击 **验证** 按钮，以确保你已完成 [开发者工具](/zh/unity/developer-tools.md#usage-requirements).

<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>

☑️ 你可以配置以下选项（或保持默认值）：

* **构建路径** 是你的服务器构建产物的相对路径，我们暂时保持默认值。

{% hint style="warning" %}
**将构建保留在项目文件夹内**，Docker 只接受相对于项目根目录的构建路径。
{% endhint %}

* **镜像名称** 是你自行选择的唯一标识符，用于在发布前标记你的服务器构建。
  * 通常，这会包含你游戏的名称——例如“my-game-server”。
* **镜像标签** 是指向你镜像某个特定版本的标识符。
  * 术语“构建产物”有时会用来指代你镜像的某个特定版本。
  * 时间戳是一个很好的标签选择，例如 `2024.01.30-16.23.00-UTC` .
* **Dockerfile 路径** 可用于自定义镜像的配方。
  * 我们建议暂时保留默认设置，你可以稍后在章节中阅读更多内容 [#customize-server-image](#customize-server-image "mention").
* **可选的 docker 构建参数** 可用于向 Docker 进一步说明更细微的配置。
  * 我们建议暂时保留默认设置，你可以 [稍后在 Docker 文档中阅读更多内容](https://docs.docker.com/reference/cli/docker/image/build/#options).

☑️ 当你对配置满意后，点击 **使用 Docker 容器化**，等待进程完成并确认你的 Unity 控制台中没有新错误。完成此步骤后，项目根目录中将出现一个 **新镜像出现在你的本地机器上**。你可以在 Docker Desktop 的 Local（默认）下的 Images 选项卡中验证，或者在 docker CLI 中运行 `docker images` .

✅ 现在你可以继续下一步。

<details>

<summary>故障排除与常见问题</summary>

`/bin/bash：docker：未找到命令` ，或 `找不到 Packages\com.edgegap.unity-servers-plugin\Editor`

* 首先，确保你已完成 [开发者工具](/zh/unity/developer-tools.md#usage-requirements).
* 确认你已验证你的 Edgegap 账户，你应该已通过电子邮件收到验证链接。
* 更新 Docker Desktop 后，某些设置可能已重置。尝试进入 Docker Desktop 设置 / 高级，并在“选择如何配置 Docker CLI 工具的安装：”中选择“系统（需要密码）”。

***

`docker build 需要恰好 1 个参数`

* 请确认你的镜像标签不包含任何空白字符（空格、制表符）。重新输入你的镜像标签值可确保你没有意外复制这些字符。

***

`（HTTP 代码 400）意外错误 - 无效的标签格式`

* 这是一个 [macOS Docker 4.33 版本的已知问题](https://github.com/docker/for-win/issues/14258)，请考虑回退到 4.32 或升级到 4.35。

***

`错误：解决失败：ubuntu:22.04：为 http://docker.io/library/ubuntu:22.04 解析源元数据失败：授权失败：获取 oauth 令牌失败`

* 你在中国吗？你的连接可能会被长城防火墙中断。尝试手动运行 `docker pull ubuntu:22.04` 在命令行中（按 Win+R 打开命令行，然后输入 `cmd` 并按回车）。

***

`System.IndexOutOfRangeException：索引超出了数组的界限。`

* 如果你是通过下载 ZIP 包安装我们的 Unity 快速开始插件，你的 Unity Editor 缓存可能已损坏。尝试删除插件副本，并使用 git URL 或 Unity Asset Store 重新安装。你应该不再需要 Newtonsoft.JSON 包，因为它会与其他源一起自动包含。

***

我的 docker 镜像大小非常大（超过 1GB）/ 非常小（低于 100mb），这没问题吗？

* 在某些情况下这可能没问题，只要你能运行服务器并成功连接（见 [#id-4.-test-your-server-locally](#id-4.-test-your-server-locally "mention")）。如果不是这种情况，请考虑检查你的构建选项，将其重置为默认值，并逐步添加选项以查看它们如何影响你的构建大小。另请参见 [#optimize-server-build-size](#optimize-server-build-size "mention").

***

我遇到了文档中任何地方都没有提到的另一个问题。

* 首先，请尝试 [更新你的 Edgegap 插件](https://github.com/edgegap/edgegap-unity-plugin?tab=readme-ov-file#update-the-plugin-in-unity) ，因为我们可能已经发布了修复。如果这没有帮助，请通过我们的 [社区 Discord](https://discord.gg/NgCnkHbsGp) 联系我们，我们会及时与你一起调查。

</details>

## 🧪 4. 在本地测试服务器

让我们先在本地（在你的机器上）尝试部署并连接游戏客户端，以确保服务器映像在我们上传和部署（可能需要一些时间）之前能正常工作。

☑️ 你可以配置以下选项（或保持默认值）：

* **服务器镜像标签** 来自上一步。
  * 默认为你使用插件构建的最后一个标签。
* **可选的 docker 运行参数** 可用于暴露多个端口，或在 macOS 机器上运行你的镜像。
  * 如果需要，你可以为容器发布多个端口，只需为每个端口添加参数 `-p {内部端口}/{协议}` ，例如 `-p 8080/tcp -p 7777/udp` 以发布并映射你的服务器端口 `8080` 到一个随机的外部端口用于 TCP 连接，以及服务器端口 `7777` 同时映射到一个随机的外部端口用于 UDP 连接。
  * **在你的 Transport 或特定于 netcode 的设置中查找服务器端口配置。**
  * 如果你使用的是 ARM 架构机器（macOS M1、M2、M3 等），你应该会在可选的 docker 构建参数中看到包含以下可选参数： `--platform=linux/amd64` .

☑️ 当你对配置满意后，点击 **部署本地容器**，等待进程完成，并确认你的 Unity 控制台中没有新错误。完成此步骤后将会出现一个 **启动一个新容器** 在你的开发机器上。

{% hint style="info" %}
有关更多细节，请参见 Docker Desktop / Containers，或 Docker CLI 命令 `docker ps` .
{% endhint %}

☑️ 现在是时候 **将你的 Unity Editor 游戏客户端连接到你的本地 docker 容器** 以验证你的服务器镜像是否正常工作。找到你的 netcode 客户端设置并输入：

* `localhost` 或 `0.0.0.0` （在大多数情况下等同）代替服务器 IP，
* 在 Docker Desktop / Containers / edgegap-server-test 中找到的随机外部端口值。

<figure><img src="/files/f867e9033203ef8e164ff7c8e1bbad3b59475759" alt=""><figcaption></figcaption></figure>

☑️ 一旦你确认可以连接到本地服务器容器并且能够正常游戏，就可以删除该容器 🗑️ 以释放机器上的资源供其他程序使用。

✅ 现在你可以继续下一步。

<details>

<summary>故障排除与常见问题</summary>

我无法使用我的 Unity Editor 游戏客户端连接到本地 docker 容器。

* 首先，确保容器状态为 Up，而不是 Restarting 或 Exited，这表明存在运行时异常。如果你的容器没有运行，请通过 Docker Desktop 的 Containers 选项卡（点击你的容器）查看日志，或者使用 `docker logs {container_id} --timestamps` 通过 docker CLI。
* 接下来，请验证你服务器构建中的 Network Manager 端口设置是否与 **可选的 docker 运行参数**中发布的端口一致。如果不一致，请尝试重置或手动更改此输入字段的值以匹配 `{container}` 端口与你的 Network Manager 设置。请在你的 netcode 设置中查找协议。
* 最后，确认你的 Unity Editor 游戏客户端 netcode 设置使用的是在 **可选的 docker 运行参数** 中发布的端口（见上方截图）。

***

`（段错误）- 核心已转储`

* 如果你使用的是 ARM 架构机器（macOS M1、M2、M3 等），你应该会在可选的 docker 构建参数中看到包含以下可选参数： `--platform=linux/amd64` 。如果没有，请尝试重置此输入字段的值。

***

`在 SceneObjects 中未找到 SceneId 9120233082191360994。`

* 这可能意味着你尝试加载的场景没有被正确包含在构建中，这是旧版本插件中的一个已知问题。为解决此问题，请尝试更新你的 netcode 集成版本，或者 [更新你的 Edgegap 插件](https://github.com/edgegap/edgegap-unity-plugin?tab=readme-ov-file#update-the-plugin-in-unity).

***

`http2：服务器：从客户端读取 preface 时出错 //./pipe/docker_engine：文件已被关闭`

* 这是一个 [Windows 版旧版本 Docker Desktop 的已知问题](https://github.com/docker/for-win/issues/13611)。请更新你的 Docker Desktop 应用程序并再次尝试容器化。

***

`Curl 错误 35：证书握手失败。致命错误。UnityTls 错误代码：7`

* 此错误表示根 SSL 证书验证问题，是旧版本插件中的一个已知问题。为解决此问题，请尝试 [更新你的 Edgegap 插件](https://github.com/edgegap/edgegap-unity-plugin?tab=readme-ov-file#update-the-plugin-in-unity).

</details>

## ☁️ 5. 上传到 Edgegap

是时候将您的服务器上线了！既然您的镜像现在可以成功托管玩家，我们就可以将其上传到 Edgegap 并开始在世界任何地方运行。在本指南中，我们将使用 [**Edgegap 的容器注册表**](/zh/learn/advanced-features/edgegap-container-registry.md) （镜像的存储）。

☑️ 你可以配置以下选项（或保持默认值）：

* **应用名称** 在 Edgegap 上可以与你的镜像名称一致，也可以自定义。
  * 我们现在选择复制你的镜像名称。
* **应用版本** 在 Edgegap 上可以与你的标签一致，也可以自定义。
  * 时间戳是应用版本名称的一个很好的选择，例如 `2024.01.30-16.50.20-UTC` .
  * 多个应用版本可以指向同一个镜像标签，例如 `v1.1.0` 和 `dev` .
  * 了解更多关于 [应用与版本](/zh/learn/bian-pai/application-and-versions.md) 的信息，稍后。
* **服务器镜像名称** 来自步骤 [#id-3.-containerize-your-game-server](#id-3.-containerize-your-game-server "mention").
* **服务器镜像标签** 来自步骤 [#id-3.-containerize-your-game-server](#id-3.-containerize-your-game-server "mention").

{% hint style="success" %}
在你的机器上找到存储在 **Docker Desktop / Images**.
{% endhint %}

☑️ 当你对配置满意后，点击 **中的任何镜像名称和标签**上传镜像并创建应用版本

，等待进程完成，并确认你的 Unity 控制台中没有新错误。 [Dashboard](https://app.edgegap.com/)☑️ 你将被带到我们的 [，你可以在那里配置可选设置。完成此步骤后将会创建一个](https://app.edgegap.com/application-management/applications/list)新的应用版本 [，并将你的](https://app.edgegap.com/registry-management/repositories/list).

☑️ 现在系统会提示你为新的应用版本定义一个端口。请确保将服务器端口值设置为与步骤 [#id-4.-test-your-server-locally](#id-4.-test-your-server-locally "mention") 中你的 Transport 或特定于 netcode 的设置相同。

✅ 现在你可以继续下一步。

<details>

<summary>疑难解答与常见问题</summary>

`被拒绝：添加 756.6 MiB 的存储资源，更新为当前使用量 4.3 GiB 后将超过配置的上限 4.7 GiB` , `在引用 "layer-sha256:--------" 上提交失败：对 https://registry.edgegap.com/ 的 PUT 请求返回了意外状态`

* 看起来您在以下位置的镜像存储空间已用尽 [容器注册表](https://app.edgegap.com/registry-management/repositories/list)。请考虑删除未使用的构建产物（如果有）或优化服务器构建体积。如果使用自定义 Dockerfile 或 .dockerignore，您可能将一些不需要的文件复制到镜像中。

***

`您已达到应用数量上限 2` , `无法更新 docker 标签/版本：您已达到应用版本数量上限 2`

* 您已达到我们免费等级的限制，请考虑升级您的账户。或者，您可以通过我们的界面删除现有资源 [仪表板](https://app.edgegap.com/).

***

我的新应用版本未在插件/扩展中列出。

* 请确保您在上一步已完成应用版本创建表单。

</details>

## 🚀 6. 部署到云端

这是本指南的最后一步，完成后您将在 Edgegap 云上部署一个服务器，来自世界任何地方的玩家都可以连接到该服务器。

☑️ **选择一个应用程序和版本** 从先前的步骤部署。

☑️ 一旦准备好，请点击 **部署到云端**，等待达到 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-3.-deployment-ready](https://docs.edgegap.com/zh/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-3.-deployment-ready "mention")。完成此步骤将导致 [一个新的部署被启动](https://app.edgegap.com/deployment-management/deployments/list) 在您的 Edgegap 帐户上。

☑️ 验证控制台输出中没有新的错误。同时确保您的 [部署](/zh/learn/bian-pai/deployments.md#container-logs) 没有显示任何错误，并且您的 [部署](/zh/learn/bian-pai/deployments.md#container-metrics) 未显示 100% 的资源利用率（vCPU 或内存），否则新的玩家连接可能会被拒绝，或您的服务器可能会陷入重启循环。请参阅下面的故障排除步骤以解决任何问题。

☑️ 现在我们将进行最后的测试，并 **将你的 Unity Editor 游戏客户端连接到云端部署**。从部署的以下信息中输入游戏客户端连接详情：

* **主机** **URL** 指向服务器的 IP，通常在 `NetworkManager` 组件中。
* **外部端口** 映射到 [服务器的内部监听端口](/zh/learn/bian-pai/application-and-versions.md#port-mapping)，通常在 Transport 组件中。

<figure><img src="/files/f1bd72895251e90b42ed7cafaf01a016ce4eaa2c" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

<details>

<summary>故障排除与常见问题</summary>

无法将客户端连接到服务器 - `请求超时。` , `请求超时` , `连接失败` ，或 `端口验证失败`

* 首先，确保部署状态为 Ready，并且你的部署日志中没有运行时异常或错误。如果部署已停止，请在我们的 [Dashboard](https://app.edgegap.com/deployment-management/deployments/list).
* 如果你使用 Mirror netcode，你需要启用 [“自动启动服务器”](https://mirror-networking.gitbook.io/docs/hosting/edgegap-hosting-plugin-guide#build-and-push) 在你的 `NetworkManager` 中勾选，然后重新构建、推送并重新部署你的服务器。
* 如果你使用 FishNet netcode，你需要启用 [“在无头模式下启动”](https://fish-networking.gitbook.io/docs/manual/components/managers/server-manager#settings-are-general-settings-related-to-the-servermanager) 在你的 `ServerManager`中勾选，然后重新构建、推送并重新部署你的服务器。
* 中。如果你使用 Photon Fusion 2 netcode，请确保你的服务器传递了部署的公网 IP、外部端口以及 `roomCode` 在服务器上，并在客户端中使用相同的房间代码，位于 [“NeworkRunner.StartGame”](https://doc.photonengine.com/fusion/current/manual/network-runner#creating-or-joining-a-room) 参数 `StartGameArgs`。部署 ID（例如 `b63e6003b19f`）是个不错的选择，因为它在全球范围内唯一，并且客户端可通过 [Matchmaker](/zh/learn/pi-pei/matchmaker-in-depth.md) 和 [深入了解](/zh/learn/pi-pei/matchmaker-in-depth.md#injected-environment-variables).
* 接下来，请验证你的服务器构建中的 netcode 设置里的端口配置是否与你的 [App 版本](https://app.edgegap.com/application-management/applications/list)中的内部端口一致。你可以通过编辑 [App 版本](https://app.edgegap.com/application-management/applications/list) 来更改端口映射，而无需重新构建。在你的 netcode 集成中找到你的协议。
* 请确保你的游戏客户端连接到容器详情页面上显示的 **外部端口** ，出于安全原因，此值始终会随机生成。
* 如果你在 netcode 集成中使用 Secure Websocket（WSS）协议，请确保你的 [App 版本](https://app.edgegap.com/application-management/applications/list) WSS 端口的端口配置已启用 TLS Upgrade。
* 你是否位于中国并正在使用 [更新了游戏示例](https://docs.edgegap.com/docs/deployment/session/fleet-manager/fleet)？你的连接可能会被防火墙阻止。可以考虑在你的舰队中添加位于中国的服务器，或使用 VPN 连接。

***

我的部署已停止/重启，现在我再也无法访问它的日志了。

* 如果服务器进程因异常崩溃，我们的系统将尝试自动重启服务器。建议 [在本地测试你的服务器](#id-4.-test-your-server-locally) 以找出根本原因。
* 我们只会在部署存续期间保留日志，如果你希望在部署停止后查看日志，请 [集成第三方日志存储](https://docs.edgegap.com/docs/deployment/endpoint-storage).
* 参见 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-5.-deployment-stopped](https://docs.edgegap.com/zh/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-5.-deployment-stopped "mention") 以了解导致部署停止的所有原因。

***

我的部署在 X 分钟后自动停止了。

* 免费层部署有 60 分钟限制，请考虑升级你的账户。
* 根据我们的服务器清理策略，为了基础设施维护，并防止在部署未正确关闭时产生意外费用，所有部署将在运行 24 小时后终止。对于长时间运行的服务器，请考虑使用 [私有舰队](/zh/learn/bian-pai/si-you-jian-dui.md) 使用 [持久化](/zh/learn/bian-pai/chi-jiu-hua.md).
* 参见 [/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-5.-deployment-stopped](https://docs.edgegap.com/zh/pages/5e7e2169ca3822647d4607dfc1d3487ebcc0836c#id-5.-deployment-stopped "mention") 以了解导致部署停止的所有原因。

***

我的部署已就绪，但随后几分钟内我仍无法连接。

* 一旦部署就绪，你的游戏引擎初始化就会开始。此过程可能需要几秒到几分钟，在此期间服务器不会接受玩家连接。
* 考虑优化服务器初始化以缩短这段时间。
* 游戏客户端应每隔 1 秒重试一次连接，并持续有限时间（取决于你的初始化时长），之后应返回匹配队列。
* 可以考虑添加加载场景，这样服务器就可以在客户端同步状态的同时执行初始化（如果是 Unreal Engine，还可以执行 travel）。

***

我的 Meta Quest 设备报出 `HTTP 0：无法解析目标主机` .

* 在为 Android 目标构建 Unity 应用时，你的 Internet Access 权限可能会从输出的 APK 客户端构建产物中自动移除。
* 重新在以下位置添加权限（之后需要重新构建客户端）：
  * 项目设置 / OpenXR / :gear: Meta Quest Support / 强制移除 Internet 权限（取消勾选）。
  * 玩家设置 / Internet Access（设为 require）。

***

如果玩家离开我的部署，会发生什么？

* 默认情况下，服务器不会拒绝玩家连接。如何对玩家进行身份验证取决于你的开发者，因为可以使用许多不同的方法和玩家认证提供商。
* 游戏客户端可以在本地保存连接信息，以便在客户端意外崩溃时尝试重新连接。
* 要允许玩家加入进行中的游戏，可以考虑使用 [深入了解](/zh/learn/pi-pei/matchmaker-in-depth.md#backfill) 或 [Sessions](https://docs.edgegap.com/docs/deployment/session).

***

我的服务器在变为就绪后显示 100% CPU 利用率。

* 这可能不是问题，因为游戏引擎在服务器初始化期间往往会执行 CPU 密集型操作。如果在部署开始后 2-3 分钟内 CPU 使用率没有下降，你可能需要优化服务器或增加应用版本资源。
* 降低 tick 速率可能会影响 CPU 使用率，因为服务器执行的消息操作更少。
* 如果你使用 Mirror netcode，你需要启用 [“自动启动服务器”](https://mirror-networking.gitbook.io/docs/hosting/edgegap-hosting-plugin-guide#build-and-push) 在你的 `NetworkManager` 中勾选，然后重新构建、推送并重新部署你的服务器。
* 如果你使用 FishNet netcode，你需要启用 [“在无头模式下启动”](https://fish-networking.gitbook.io/docs/manual/components/managers/server-manager#settings-are-general-settings-related-to-the-servermanager) 在你的 `ServerManager`中勾选，然后重新构建、推送并重新部署你的服务器。
* 在免费套餐中，你的限制是 1.5 vCPU 和 3GB 内存（RAM）。
* 在创建新的应用版本时，你可以增加分配的资源。你可以在我们的 Dashboard 中复制你的应用版本并根据需要调整这些值，而无需重新构建服务器或镜像。

***

我的部署不断重启，并显示错误 `OOM kill`

* 这是由于超出了分配的内存量导致的。可以考虑使用对象池、压缩或移除场景中不需要的对象来优化内存使用。
* 请确保你的项目正在加载包含你的默认场景 `NetworkManager` ，并且该场景已包含在 Unity 的 Build Settings 中。
* 在免费套餐中，你的限制是 1.5 vCPU 和 3GB 内存（RAM）。
* 在创建新的应用版本时，你可以增加分配的资源。你可以在我们的 Dashboard 中复制你的应用版本并根据需要调整这些值，而无需重新构建服务器或镜像。

***

有时，我服务器的内存（RAM）使用量会突然飙升到很高，这有问题吗？

* 只要你不超过分配的应用版本内存量，这就不是问题。
* 超过分配的应用版本内存量将导致 `OOM kill` （见上文）。

***

同一台机器上运行的其他服务器会影响我的服务器性能吗？

* 不会，我们的平台确保分配的资源不会被其他工作室或共享基础设施上的其他服务器使用。使用 Edgegap，不会有“吵闹的邻居”。

</details>

## 👉 下一步

一旦你有了可用的客户端/服务器设置，请确保 **保存你的项目副本** （使用诸如 git 之类的版本控制软件），以便在遇到问题时总能追溯你的步骤。

继续阅读以了解更多与服务器生命周期和可发现性相关的主题。

### 停止部署

一旦比赛结束（或玩家离开），就可以停止你的部署以节省成本。 [空运行或仅部分填充运行会不必要地增加你的成本！](https://edgegap.com/blog/how-session-fill-rate-affects-your-multiplayer-hosting-costs)

{% hint style="success" %}
导入我们的 `DeploymentAgent`  来自 Unity SDK 的示例到 **轻松且可靠地停止服务器**.
{% endhint %}

{% hint style="warning" %}
连接你的 [端点存储](/zh/docs/endpoint-storage.md) 以获取你的部署日志，否则它们将被删除！
{% endhint %}

### 注入变量

通过访问注入的环境变量，你可以读取诸如部署 ID、服务器 IP 地址、服务器位置等有用信息。每个部署都会自动包含：

* [部署变量](/zh/learn/bian-pai/deployments.md#injected-environment-variables) - 由 Edgegap 自动提供，
* [匹配变量](/zh/learn/pi-pei/matchmaker-in-depth.md#injected-environment-variables) - 在使用 [匹配](/zh/learn/pi-pei.md),
* [应用版本变量](/zh/learn/bian-pai/application-and-versions.md#injected-variables) - 由你配置的自定义键值对。

{% hint style="success" %}
导入我们的 `DeploymentAgent`  来自 Unity SDK 的示例到 **轻松读取强类型变量**.
{% endhint %}

### Session 自动化

{% hint style="warning" %}
**手动启动你的部署，复制 URL 和端口在实时游戏中行不通。**
{% endhint %}

使用以下任一方式，自动化热门游戏流程，以管理会话并按需扩展：

{% columns %}
{% column width="33.33333333333333%" %}
[匹配](/zh/learn/pi-pei.md):

* 更短的回合
* 按需对局
* 技能评级和/或\
  自定义规则
  {% endcolumn %}

{% column width="33.33333333333333%" %}
[服务器浏览器](/zh/learn/fu-wu-qi-liu-lan-qi.md):

* 持久模式或回合制
* 社交区域枢纽
* 自动分配和/或\
  自定义搜索
  {% endcolumn %}

{% column width="33.33333333333333%" %}
自定义后端：

* 迁移实时游戏
* [使用 v2 API 部署](/zh/docs/api/zhuan-yong-fu-wu-qi.md)
* [监控 Webhooks](/zh/learn/bian-pai/deployments.md#webhooks)
  {% endcolumn %}
  {% endcolumns %}

{% hint style="info" %}
如果你需要帮助， [请通过 Discord 联系我们](https://discord.gg/MmJf8fWjnt)。关于实时游戏支持，请查看我们的 [工单系统](https://edgegap.atlassian.net/servicedesk/customer/portal/3).
{% endhint %}

### 优化构建

**仅重新构建自上次构建以来发生更改的资源。**

考虑使用 [Unity 的增量构建](https://docs.unity3d.com/Manual/incremental-build-pipeline.html) 以加快你的构建时间。

* 考虑使用 [Unity 的增量构建](https://docs.unity3d.com/Manual/incremental-build-pipeline.html) 以加快你的构建时间。

**只包含服务器运行绝对需要的内容。**

* 将未使用的文件复制到镜像中会导致镜像臃肿、上传更慢、缓存更慢，以及整体服务器启动更慢。 [查看 Docker 镜像优化建议](https://docs.docker.com/build-cloud/optimization/#dockerignore-files).

**禁用网格的静态批处理以减小镜像大小。**

* [禁用静态批处理以加快构建、上传和部署速度。](https://docs.unity3d.com/Manual/DrawCallBatching.html)

**压缩网格以减小镜像大小。**

* [将网格压缩设置为高以加快构建、上传和部署速度。](https://docs.unity3d.com/6000.0/Documentation/Manual/compressing-mesh-data-optimization.html)
* 顶点压缩不会影响镜像大小。

**实现资源的条件式延迟加载。**

* 通过排除仅客户端资源 [将纹理和网格设置为禁用 CPU 读/写](https://docs.unity3d.com/6000.0/Documentation/Manual/dedicated-server-optimizations.html).
* 考虑使用 [Unity Addressables](https://docs.unity3d.com/Packages/com.unity.addressables@2.1/manual/index.html) ，以通过 [按需加载资源](https://docs.unity3d.com/Packages/com.unity.addressables@1.19/manual/LoadingAddressableAssets.html)来加快你的客户端构建和部署，或者通过检查是否存在来跳过加载服务器构建中的某些资源 [部署](/zh/learn/bian-pai/deployments.md#injected-environment-variables).

**考虑使用** [**多阶段 Docker 构建（链接）**](https://docs.docker.com/build/building/multi-stage/)**.**

* 将大型服务器依赖拆分到单独的镜像中，以便在多阶段构建中复用。Docker 会缓存每一层，并简单地复用之前的版本，除非明确要求，否则会跳过上传这一部分，从而为你节省带宽和等待上传完成的时间。
* 如果你不确定为什么某条 Dockerfile 命令会报错，请尝试在本地调试。在问题发生前创建一个新阶段（再添加第二个 `FROM` 命令），使用 `--target` 指示构建过程停在有问题的阶段，然后使用 `docker exec -it {container} /bin/bash` 进入容器内部的交互式终端。之后，你可以使用基础镜像中的 shell 命令进一步调查（例如 `top` 在 ubuntu 上）。

### 自定义镜像

我们也支持为需要更多镜像控制的用户添加自己的 Dockerfile，例如为了优化构建大小、处理额外依赖，或需要更复杂的启动过程。你可以在步骤中可选地提供自定义 Dockerfile 的路径 [#id-3.-containerize-your-game-server](#id-3.-containerize-your-game-server "mention")。接下来我们将分享一些“自己动手”的技巧和最佳实践。

**在使用 Websockets 或 HTTPS 请求时遇到问题？**

* 如果你看到 `Curl 错误 35：证书握手失败。致命错误。UnityTls 错误代码：7` 不要绝望，这是较旧基础（`FROM`）镜像中的一个已知问题，其中包含已过期的根证书机构证书。你可以通过更新到更新的基础镜像版本（例如 `ubuntu:22.04`），并运行 `update-ca-certificates` 来修复；将以下内容添加到你的 Dockerfile 中：

  ```docker
  FROM ubuntu:22.04

  RUN apt-get install -y ca-certificates && \\
      apt-get clean && \\
      update-ca-certificates
  ```

**始终确保您正在使用可运行的服务器构建。**

* 在认为问题与自定义 Dockerfile 有关之前，请确保您的 Unity 服务器构建可以启动，并且 Unity 的构建过程中没有抛出任何异常或错误。

**在上传之前务必本地测试。**

* 在本地测试您的镜像可以在等待上传完成时为您节省大量时间。它也是完全免费的 ✨，因为不需要任何 Edgegap 资源。
* 在本地测试时，请确保正确设置内部端口：

  ```bash
  docker run \
    -p 7777/udp \
    -e ARBITRIUM_PORTS_MAPPING='{"ports":{"gameport":{"internal":7777}}}' \
    'registry.edgegap.com/<repository>:<tag>'
  ```

**确保掌握基础知识。每个 Dockerfile 都需要一些基本命令：**

* `FROM {image}` 是您的基础镜像，对 Unity 项目我们通常使用长期支持的 Linux，但任何基于 Linux 的基础镜像都可以。它们通常是存储在 dockerhub 的公共镜像。Dockerfile 参考在此处。 [Dockerfile 参考在此处](https://docs.docker.com/reference/dockerfile/#from).
* `COPY {source} {destination}` 用于将您的 Linux 服务器构建从主机复制到镜像内部，以便稍后可以启动它。 [Dockerfile 参考在此处](https://docs.docker.com/reference/dockerfile/#copy).
* `USER {user}` 应跟在 [useradd（ubuntu）命令](https://manpages.ubuntu.com/manpages/bionic/man8/useradd.8.html) 或同等命令之后，最好不要以 `root` 运行所有内容，以更安全为宜。 [Dockerfile 参考在此处](https://docs.docker.com/reference/dockerfile/#user).
* `CMD {command}` 将是最后一行，很可能会调用一个 `StartServer.sh` 或某种启动脚本，以确保在一切设置完成后服务器正确初始化。 [Dockerfile 参考在此处](https://docs.docker.com/reference/dockerfile/#cmd).
* 切勿使用 `VOLUME` - 在 Edgegap 上您将无法通过这种方式挂载任何本地存储，建议考虑我们的端点存储功能并使用 S3 存储桶，参见 [端点存储](https://docs.edgegap.com/docs/deployment/endpoint-storage),
* `EXPOSE 7777/UDP`  不是必需的！这并不会真正使容器外部能够访问内部服务器端口，它只是对开发者的一个提示，并且在本地测试时该端口需要被
  * 发布，使用 `docker run <image> -p 7777/udp` ,
  * 或在 [Edgegap 端口映射](/zh/learn/bian-pai/application-and-versions.md#other-parameters-optional).

**将参数声明延迟到最晚的可能时刻。由于服务器构建时间较长，可配置性优于可组合性。** [**将此方法应用于 Dockerfile 命令以更快地构建和上传。**](https://medium.com/@esotericmeans/optimizing-your-dockerfile-dc4b7b527756)

* 场景：您需要定义诸如部署阶段、版本、游戏模式、地图、每台服务器的玩家数量、备份频率或类似参数。
* 糟糕的解决方案：为参数的每一种组合创建单独的镜像。您会花大量时间重建镜像，而这种方法带来的收益很少。
* 更好的解决方案 — 及时替换配置参数：
  1. 部署参数 — 在部署前提供 — 比如作为环境变量传入的匹配器选择器，或在部署时由您自定义的会话管理系统传入的环境变量，
  2. 版本参数 — 在某个应用版本的所有部署中共享 — 部署阶段、构件标签、第三方密钥和端点等；然后
  3. 单一镜像 — 在启动时包含并加载所有配置选项。

**切勿在 Edgegap 部署上运行数据库。**

* Edgegap 部署并不适合长期运行的进程，可能在长时间运行后被终止且不会事先通知。以这种方式运行的数据库（即使是分布式的）可能会被终止并导致不可逆的数据丢失。如果您需要数据库，请考虑第三方的 DBaaS。
* 考虑使用我们的 [托管集群](https://app.edgegap.com/cluster-management/clusters/list) 来托管数据库和长期运行的服务。

{% hint style="info" %}
遇到难题了吗？我们在我们的 [社区 Discord](https://discord.gg/MmJf8fWjnt) 中随时为你提供帮助。
{% endhint %}