Pterodactyl 面板 | Coolify Docs

什么是 Pterodactyl？

该服务已从 Coolify 中移除

此服务已从 Coolify 的一键服务目录中移除。更多信息请访问 https://github.com/coollabsio/coolify/pull/8512

Pterodactyl® 是一个免费、开源的游戏服务器管理面板，由 PHP、React 和 Go 构建。 Pterodactyl 以安全为核心设计理念，将所有游戏服务器运行在隔离的 Docker 容器中，同时为用户提供美观直观的用户界面。

Pterodactyl 由两个协同工作的核心组件组成：面板（Panel）（Web 界面）和 Wings（服务器守护进程）。面板提供管理界面，而 Wings 负责处理每个节点上的实际游戏服务器操作。

当前功能

从单个仪表板管理多个服务器
具有进程隔离的安全守护进程（Wings）
每个服务器基于 Docker 的容器化
基于 Web 的仪表板
基于角色的用户权限
实时 CPU、RAM 和网络监控
自动服务器更新和备份

什么是 Wings？

Wings 是 Pterodactyl 的服务器控制守护进程，由 Go 编写。它运行在每个服务器节点上，处理所有游戏服务器操作，包括服务器实例的创建、管理和监控。

Wings 通过其 REST API 与 Pterodactyl 面板通信，接收命令和配置，同时发送回实时统计信息、控制台输出和状态更新。每个游戏服务器都在由 Wings 管理的隔离 Docker 容器中运行。

主要功能：

服务器生命周期管理 - 启动、停止、重启和配置游戏服务器
Docker 容器编排 - 自动配置和隔离
实时监控 - CPU、RAM、磁盘和网络使用跟踪
控制台流 - 实时服务器控制台输出到面板
文件管理 - 处理服务器文件、备份和计划任务
资源限制 - 每个容器的 CPU 和内存限制

在 Coolify 上安装

Coolify 为 Pterodactyl 提供两种部署选项：用于单服务器设置的组合面板 + Wings 模板，或用于分布式架构的单独部署。

选项 1：带有 Wings 的 Pterodactyl（组合模板）

适用于面板和 Wings 一起运行的单服务器部署。

从 Coolify 安装最新的 Pterodactyl With Wings 模板。
部署模板。
访问面板 URL 并使用您的管理员凭据登录。
导航到 Admin Panel → Locations 并创建新位置（例如 us、eu 等）。
创建新节点并配置以下字段：
- FQDN → wings-abc1abc2abc3abc4.example.com（不包含 http:// 或 https://）
- 通过 SSL 通信 → 启用（除非您知道自己在做什么，否则不要更改此设置）
- 守护进程端口 → 443（重要！Coolify 会自动转发端口 443 → 8443）

导航到节点的配置选项卡并保存配置到安全位置。

在 Coolify 中，转到 Persistent Storages 并找到 config.yml。使用您保存的配置中的值替换以下值：
- uuid
- token_id
- token
- api > ssl > cert
- api > ssl > key
更新 allowed_origins 下的面板域名以匹配您的实际面板域名。
等待大约 3–5 分钟让 Wings 重启。如果配置成功，节点的 About 部分应显示您的守护进程版本和其他信息。
您的面板现已准备就绪。

选项 2：单独的面板和 Wings 安装

适用于 Wings 节点与面板运行在不同服务器上的分布式设置。

当在 Coolify 中单独安装带有反向代理的 Wings 时，您不能让它直接在容器内监听端口 443。相反，配置它使用端口 8443 作为内部端口，而 Coolify 将 443 转发到 8443。 Pterodactyl 面板仍应配置为在外部使用端口 443。

步骤：

在面板中生成 Wings 配置
- 在 Pterodactyl 面板中，创建一个节点并下载 config.yml。
- 使用以下值配置节点：
  - 主机名（例如 host.example.com，不包含 https://）— 不是 IP 地址
  - 端口：443
  - 启用代理设置
在 Coolify 中更新配置
- 在您的 Coolify Wings 服务中，打开 Persistent Storages 选项卡。
- 您将看到 /etc/pterodactyl/config.yml 已存在并带有默认模板。
- 直接编辑它，用面板生成的文件中的值替换占位符。
- 将 api.port 更改为 8443：
```
api:
  host: 0.0.0.0
  port: 8443
```
重启 Wings
- 保存更改后，重启 Wings 容器以应用新设置。