Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

为专用服务器导出

如果要在没有 GPU 或没有显示服务器的机器上为项目运行专用服务器，你需要在运行 Godot 的时候使用 headless 显示服务器和 Dummy 音频驱动。

从Godot 4.0开始，这可以透过在任何平台上使用 --headless 命令行参数来执行Godot二进制文件或执行导出为专用服务器的项目来完成。与Godot 3.x不同，你不再需要使用专门的服务器二进制。

编辑器与导出模板

可以在无头模式下使用编辑器或导出模板（调试或发布）二进制。你应该使用哪一种取决于你的用例：

• Export template（导出模板）：不包含编辑器的功能，体积更小、优化更高，是在服务器平台下的最佳选择。

• Editor（编辑器）：包含编辑器功能的可执行文件，目的是用来导出项目。该可执行文件可以用来运行专用服务，但是因为其体积较大、优化程度较低，所以不建议将其作为专用服务器使用。

导出方法

针对服务器导出项目的方法有两种：

• 为服务器托管平台创建单独的导出预设，然后像往常一样导出项目。

• 仅导出 PCK 文件，目标平台最好与托管服务器的平台一致。将此 PCK 文件放在与导出模板二进制文件相同的文件夹中，将二进制文件重新命名为与 PCK 相同的名称（除去文件扩展名），然后执行该二进制文件。

两种方法的输出结果应该相同。本页其余部分将重点介绍第一种方法。

详见导出项目 .

为专用服务器导出项目

在以服务器为目标时，如果你像往常一样导出项目，你会注意到 PCK 文件和以客户端为目标时一样大。这是因为它包含所有资源，包括服务器不需要的资源（例如纹理数据）。此外，无头模式不会自动使用；用户必须指定 --headless 以确保不会生成任何窗口。

许多资源（例如纹理）可以从 PCK 文件中剥离，以大大减少其大小。Godot 提供了一种对纹理和材质执行此操作，但可以保留场景或资源文件（内置或外部）中的引用的方法。

首先，请确保你的服务器有专用的导出预设，然后选择它，转到其资源标签并更改其导出模式：

在导出预设中选择导出为专用服务器导出模式

选择此导出模式后，dedicated_server 功能标记将自动新增至导出的项目。

备注

如果你不想使用该导出模式但仍想要功能标签，则可以在导出预设的功能选项卡中写入名称 dedicated_server。这也会在运行导出的项目时强制使用 --headless。

选择此导出模式后，你将看到项目中的资源列表：

选择要保留、剥离视觉内容或移除的资源、

勾选复选框可让你覆盖针对特定文件或文件夹的选项。仅仅勾选不会影响导出哪些文件，需要使用复选框对应的选项。

默认情况下，已勾选的文件夹中的文件会自动使用父级的选项，由选项名称中的（继承）后缀表示（并且选项名称是灰的）。要修改目前处于继承状态的文件的选项，必须先勾选复选框。

• 剥离视觉内容：导出此资源，但其中的视觉文件（纹理和材质）被占位符类替换。占位符类存储图像大小（因为这有时用于在 2D 场景中定位元素），但不存储其他内容。

• 保留：照常导出此资源，并保留完整的视觉文件。

• 移除：该文件不会包含在 PCK 中。这用于忽略只有客户端需要的场景和资源。如果这样做，请确保服务器不会以任何方式引用这些仅限客户端的场景和资源。

一般建议尽可能使用剥离视觉内容，除非服务器需要访问图像数据（例如像素颜色）。例如，如果你的服务器根据图像的内容生成碰撞数据，则需要对该特定图像使用保留。

小技巧

要检查导出的 PCK 的文件结构，请使用导出 PCK/ZIP... 按钮并指定 .zip 文件扩展名，然后在文件管理器中打开得到的 ZIP 文件。

警告

使用 移除 模式时要小心，因为引用已删除文件的场景/资源将无法成功加载。

如果想要移除特定的资源，但又希望场景仍然能够正常加载，你就必须移除场景文件中的相关引用并在脚本中使用 load() 为节点的属性加载这些文件。这种方法可以用来剥离 Godot 暂不支持用占位符替换的资源，比如音频。

移除纹理通常对 PCK 大小影响最大，因此建议先坚持使用剥离视觉内容。

使用上面的选项后，客户端的 PCK（正常导出所有资源）是这样的：

.
├── .godot
│   ├── exported
│   │   └── 133200997
│   │       └── export-78c237d4bfdb4e1d02e0b5f38ddfd8bd-scene.scn
│   ├── global_script_class_cache.cfg
│   ├── imported
│   │   ├── map_data.png-ce840618f399a990343bfc7298195a13.ctex
│   │   ├── music.ogg-fa883da45ae49695a3d022f64e60aee2.oggvorbisstr
│   │   └── sprite.png-7958af25f91bb9dbae43f35388f8e840.ctex
│   └── uid_cache.bin
├── client
│   ├── music.ogg.import
│   └── sprite.png.import
├── server
│   └── map_data.png.import
├── test
│   └── scene.gd
└── unused
│   └── development_test.gd
├── project.binary
├── scene.gd
├── scene.tscn.remap

服务器的 PCK 文件结构是这样的：

.
├── .godot
│   ├── exported
│   │   └── 3400186661
│   │       ├── export-78c237d4bfdb4e1d02e0b5f38ddfd8bd-scene.scn
│   │       ├── export-7958af25f91bb9dbae43f35388f8e840-sprite.res  # Placeholder texture
│   │       └── export-fa883da45ae49695a3d022f64e60aee2-music.res
│   ├── global_script_class_cache.cfg
│   ├── imported
│   │   └── map_data.png-ce840618f399a990343bfc7298195a13.ctex
│   └── uid_cache.bin
├── client
│   ├── music.ogg.import
│   └── sprite.png.import  # Points to placeholder texture
└── server
│   └── map_data.png.import
├── project.binary
├── scene.gd
├── scene.tscn.remap

启动专用服务器

如果你的客户端和服务器都是同一个 Godot 项目的一部分，则必须添加一种使用命令行参数直接启动服务器的方法。

如果你使用导出为专用服务器导出模式导出了该项目（或已添加 dedicated_server 作为自定义功能标记），则可以使用 dedicated_server 功能标签来检测是否正在使用专用服务器 PCK：

GDScriptC#

# Note: Feature tags are case-sensitive.
if OS.has_feature("dedicated_server"):
    # Run your server startup code here...
    pass

如果你还希望在使用内置的 --headless 命令行参数时托管服务器，可以在主场景（或自动加载）的 _ready() 方法中添加以下代码段来实现：

GDScriptC#

if DisplayServer.get_name() == "headless":
    # Run your server startup code here...
    #
    # Using this check, you can start a dedicated server by running
    # a Godot binary (editor or export template) with the `--headless`
    # command-line argument.
    pass

如果希望使用自定义命令行参数，可在主场景（或自动加载）的 _ready() 方法中添加以下代码段：

GDScriptC#

if "--server" in OS.get_cmdline_user_args():
    # Run your server startup code here...
    #
    # Using this check, you can start a dedicated server by running
    # a Godot binary (editor or export template) with the `--server`
    # command-line argument.
    pass

最好新增至少一个上述命令行参数来启动服务器，因为它可用于从命令行测试服务器功能，而无需导出项目。

如果你的客户端和服务器是独立的 Godot 项目, 服务器通常应该配置成运行主场景时自启服务的方式.

下一步

在 Linux 平台，如果想要让专用服务器在崩溃或系统重启后重新启动，可以创建 systemd 服务。这样查看服务器的日志也更为方便，systemd 可以自动对日志进行轮换。让项目成为 systemd 服务时，你还应该启用应用/运行/打印时清空标准输出项目设置。这样 journald（systemd 的日志服务）就可以在进程运行时收集日志了。

如果你有使用容器的经验，可以考虑将专用服务器包装在一个 Docker 容器中。这样可以在弹性配置中更容易地使用它（这超出了本教程的范围）。