Docker-Pterodactyl(翼龙面板⭐)

[Pterodactyl](https://pterodactyl.io/)® 是一个免费的开源游戏服务器管理面板，使用 PHP、React 和 Go 构建。翼龙在设计时充分考虑了安全性，在隔离的 Docker 容器中运行所有游戏服务器，同时向最终用户提供美观直观的 UI
`Wings(后端) 仅支持 Linux`

**相关链接：**
- Pterodactyl：
  - 官网：https://pterodactyl.io/
  - Doc：https://pterodactyl.io/project/introduction.html
  - GitHub：https://github.com/pterodactyl/panel
- Pterodactyl-China(翼龙面板汉化版)：
  - 官网：https://pterodactyl.top/
  - Doc：https://pterodactyl.top/project/introduction.html
  - GitHub：https://github.com/pterodactyl-china/panel
  - Docker：https://hub.docker.com/r/pterodactylchina/panel
  - BBS：https://bbs.pterodactyl.top/
  - Docker环境变量：https://github.com/pterodactyl-china/panel/tree/1.0-develop/.github/docker
- 预设模板：https://github.com/pelican-eggs/games-steamcmd
  - 独立：https://github.com/pelican-eggs/games-standalone
  - SteamCMD：https://github.com/pelican-eggs/games-steamcmd
  - 自建预设：https://pterodactyl.io/community/config/eggs/creating_a_custom_egg.html

>s 相关自用模板(调整)：`.../共享盘/服务器/Pterodactyl(翼龙面板)`

仅管理员可以创建服务器，创建的服务器可以分配服务器所有者至普通用户，这样该用户拥有对该服务器的完整权限
服务器也可以添加子管理员，子管理员可以拥有指定的权限(根据需求分配)

# Docker
这里使用 PVE + Debian12 进行部署
Pterodactyl(前端) + Wings(后端)，可以有多个后端

## 基础环境准备
Pterodactyl 需要安装 Docker + docker-compose
Wings 只需要 Docker
```bash
# 换源并安装所需软件
wget http://nas.918178.xyz:3000/WJ/Script/raw/branch/master/sources_zwzw.sh && bash sources_zwzw.sh  # 一键换软件源
apt update && apt install -y curl  # 更新并安装所需软件

# 安装 Docker 和 docker-compose
curl -sSL https://get.docker.com/ | CHANNEL=stable bash -s docker --mirror Aliyun  # 安装docker
curl -L "https://git.918178.xyz/https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose  # 下载 docker-compose
chmod +x /usr/local/bin/docker-compose  # 授予可执行权限
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose  # 软链接
systemctl enable --now docker  # 设置 docker 自启
```

## Pterodactyl 部署(前端)
panel 面板，可以理解为管理端
```bash
mkdir -p /pterodactyl && cd /pterodactyl  # 创建存放目录并进入
mkdir {database,var,nginx,certs,logs}  # 创建所需目录
curl -Lo docker-compose.yml https://git.918178.xyz/https://raw.githubusercontent.com/pterodactyl-china/panel/1.0-develop/docker-compose.example.yml  # 下载docker-compose.yml(汉化版)
nano docker-compose.yml  # 自行修改相关配置
docker-compose up -d  # 拉取并部署(首次创建数据库会比较久,可查看panel)

docker-compose exec panel php artisan p:user:make  # 创建用户
```
`docker-compose.yml`,Pterodactyl 前端
```yaml
version: '3.8'  # 指定 Docker Compose 文件的版本
x-common:  # 定义一组公共的环境变量,可以在多个服务中复用
  database: &db-environment  # 定义一个锚点(&db-environment),用于数据库环境变量
    MYSQL_PASSWORD: &db-password "panel"  # 数据库用户的密码,使用锚点(&db-password)以便复用
    MYSQL_ROOT_PASSWORD: "panel"  # 数据库root用户的密码
  panel: &panel-environment  # 定义一个锚点(&panel-environment),用于面板环境变量
    APP_URL: "http://example.com"  # 面板的 URL(http/https),外网访问地址,要带对应端口
    APP_TIMEZONE: "Asia/Shanghai"  # 面板时区
    APP_SERVICE_AUTHOR: "ai773203918@qq.com"  # 面板服务的作者邮箱
    # LE_EMAIL: ""  # 如果你想使用 Let's Encrypt 生成 SSL 证书,取消注释并填写你的邮箱
  mail: &mail-environment  # 定义一个锚点(&mail-environment),用于邮件环境变量(后期可以Web中配置)
    MAIL_FROM: ""  # 发送邮件的邮箱地址
    MAIL_DRIVER: "smtp"  # 邮件发送的驱动程序
    MAIL_HOST: ""  # 邮件服务器的主机名
    MAIL_PORT: "465"  # 邮件服务器的端口号
    MAIL_USERNAME: ""  # 邮件服务器的用户名
    MAIL_PASSWORD: ""  # 邮件服务器的密码
    MAIL_ENCRYPTION: "true"  # 是否使用加密连接邮件服务器

# 下面是服务定义区域,定义了各个容器服务
services:
  database:  # 数据库服务
    image: mariadb:10.5  # 使用的 Docker 镜像
    restart: always  # 总是重启容器
    command: --default-authentication-plugin=mysql_native_password  # 启动命令,设置默认的身份验证插件
    volumes:  # 挂载的卷
      - "./database:/var/lib/mysql"  # 数据库数据的持久化存储位置
    environment:  # 环境变量
      <<: *db-environment  # 继承数据库环境变量
      MYSQL_DATABASE: "panel"  # 创建的数据库名称
      MYSQL_USER: "pterodactyl"  # 数据库用户
  cache:  # 缓存服务
    image: redis:alpine  # 使用的 Docker 镜像
    restart: always  # 总是重启容器
  panel:  # 面板服务
    image: pterodactylchina/panel:latest  # 使用的 Docker 镜像
    restart: always  # 总是重启容器
    ports:  # 端口映射
      - "80:80"  # 将容器的 80 端口映射到宿主机的 80 端口
      - "443:443"  # 将容器的 443 端口映射到宿主机的 443 端口
    links:  # 链接到其他服务
      - database  # 链接到数据库服务
      - cache  # 链接到缓存服务
    volumes:  # 挂载的卷
      - "./var/:/app/var/"  # 面板的变量目录
      - "./nginx/:/etc/nginx/http.d/"  # Nginx 配置目录
      - "./certs/:/etc/letsencrypt/"  # SSL 证书目录
      - "./logs/:/app/storage/logs"  # 日志目录
    environment:  # 环境变量
      <<: [*panel-environment, *mail-environment]  # 继承面板和邮件环境变量
      DB_PASSWORD: *db-password  # 数据库密码
      APP_ENV: "production"  # 应用环境
      APP_ENVIRONMENT_ONLY: "false"  # 是否只显示环境信息
      CACHE_DRIVER: "redis"  # 缓存驱动
      SESSION_DRIVER: "redis"  # 会话驱动
      QUEUE_DRIVER: "redis"  # 队列驱动
      REDIS_HOST: "cache"  # Redis 服务的主机名
      DB_HOST: "database"  # 数据库服务的主机名
      DB_PORT: "3306"  # 数据库服务的端口号
      # RECAPTCHA_ENABLED: "false"  # 是否启用 reCAPTCHA(默认启用,为了安全请勿关闭)
```
访问：`http://<IP>[:<端口>]/`，用户为脚本自行创建

### 添加预设(游戏开服模板)
安装完成后默认只有少量的游戏开服模板，更多的需要手动添加
1. 创建预设组
一般一个游戏一个预设组，一个预设组中包含多种开服方式(如泰拉瑞亚有官方的和TModloader版)
`Pterodactyl(WebGUI) > 预设组`，新建(右侧)
2. 导入预设：[独立](https://github.com/pelican-eggs/games-standalone)、[SteamCMD](https://github.com/pelican-eggs/games-steamcmd)，下载名称带 `pterodactyl` 的
`Pterodactyl(WebGUI) > 预设组`，创建预设组后直接回到之前页面，导入预设组
导入下载的游戏预设，并添加到对应预设组下
可在导入界面或是下载的.json修改使用的Docker镜像以进行加速，文件下载加速只能修改.json

## Wings 部署(后端)
实际起服务器的
```bash
curl -L -o /usr/local/bin/wings "https://git.918178.xyz/https://github.com/pterodactyl-china/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"  # 下载Wings
chmod u+x /usr/local/bin/wings  # 授予可执行权限

# 配置 Wings 节点(Web中配置该节点,可参考下方👇)
wings  # 运行Wings,--debug 调试模式
# 然后就可以在 Pterodactyl(Web前端) 中查看到当前节点状态
```
需对外开放端口：`守护进程端口(Wings)`、`守护进程SFTP端口`、`准备用来起游戏服务器端口(可能多个)`

### 配置 Wings 节点
Wings节点 关联到 Pterodactyl面板
1. 登录 `Pterodactyl(Web 面板) > 管理员后台`
2. 添加 `地域`，名称随意
3. 添加 `节点`
![](/media/202412/2024-12-09_205936_7267290.9095732537133114.png)
注意，若是连接Wings服务器使用的IP，则与面板前端必须为http通讯(无SSL)
4. 端口分配，`当前节点 > 分配`，然后填写分配的IP和端口，域名可选(需提前做好解析)
5. 配置 Wings,`当前节点 > 配置`
   1. 右侧 `生成自动部署指令`
```bash
# 默认生成的指令并不是任何都可用的
cd /etc/pterodactyl && sudo wings configure --panel-url http://xx.918178.xyz --token xxx --node 1  # 示例
# 拆分开手动执行比较靠谱
mkdir /etc/pterodactyl && cd /etc/pterodactyl  # 创建所需文件夹并进入
wings configure --panel-url http://xx.918178.xyz --token xxx --node 1  # 添加节点
```
   2. 将配置复制并放入Wings服务器的 `/etc/pterodactyl/config.yml`
6. 配置完 Wings 后需要重启 Wings 服务

### 守护进程
```bash
nano /etc/systemd/system/wings.service  # 创建守护进程
systemctl enable --now wings  # 重新加载 systemd 并启动 Wings

systemctl start wings.service  # 启动 Wings
systemctl stop wings.service  # 停止 Wings
systemctl restart wings.service  # 重启 Wings
systemctl status wings.service  # 查看 Wings

journalctl -u wings.service  # 查看日志
journalctl -u wings.service -f  # 实时显示日志
tail -n 100 /var/log/pterodactyl/wings.log  # 查看日志文件100条
```
`/etc/systemd/system/wings.service`
```bash
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
```

## 开启 SSL
若是仅启用 Pterodactyl(前端) 的SSL会导致 Wings伪连接
`Web > 节点 > 对应节点` 中可以显示出节点信息，`Web > 节点` 中💓为未连接(可通过这个判断是否时伪连接)
进服务器无法加载状态，并且无法创建/管理服务器
若是想要开启SSL必须 [Pterodactyl(前端)](https://pterodactyl.io/panel/0.7/webserver_configuration.html#nginx) 与 [Wings(后端)](https://pterodactyl.top/tutorials/creating_ssl_certificates.html) 一同开启

### Pterodactyl 添加 SSL
SSL 证书放置 `.../certs` 下方便调用(也可容器内申请)
`.../nginx/panel.conf`，Docker 版 Nginx配置
```bash
# server {
#   listen 80;  # 监听80端口，用于接收HTTP请求
#   server_name _;  # 通配符域名，匹配所有请求
#   return 301 https://$server_name$request_uri;  # 将所有HTTP请求重定向到HTTPS
# }

server {
  listen 18080 ssl http2;  # 监听18080端口，启用SSL和HTTP/2
  server_name _;  # 通配符域名，匹配所有请求
  error_page 497 =307 https://$host:$server_port$request_uri;  # 当收到非HTTPS请求时，重定向到HTTPS

# SSL 证书和密钥的路径
  ssl_certificate /etc/letsencrypt/*.918178.xyz.cer;  # SSL证书路径
  ssl_certificate_key /etc/letsencrypt/*.918178.xyz.key;  # SSL密钥路径

# 网站根目录和默认首页
  root /app/public;  # 网站文件根目录(Docker版位置)
  index index.html index.htm index.php;  # 默认首页文件

# 字符编码
  charset utf-8;  # 设置字符编码为UTF-8

# location /：处理网站根目录的请求
  location / {
    try_files $uri $uri/ /index.php?$query_string;  # 尝试提供请求的URI或404
  }

# 忽略 favicon.ico 和 robots.txt 的日志记录
  location = /favicon.ico { access_log off; log_not_found off; }
  location = /robots.txt  { access_log off; log_not_found off; }

# 日志设置
  access_log off;  # 关闭访问日志
  error_log  /var/log/nginx/pterodactyl.app-error.log error;  # 错误日志路径和级别

# 客户端设置
  client_max_body_size 100m;  # 允许客户端请求的最大 body 大小
  client_body_timeout 120s;  # 客户端请求 body 的超时时间

# 文件传输设置
  sendfile off;  # 关闭 sendfile

# 处理 PHP 文件的 location
  location ~ \.php$ {
    fastcgi_split_path_info ^(.+\.php)(/.+)$;  # 分割脚本和路径信息
    fastcgi_pass 127.0.0.1:9000;  # PHP-FPM 监听地址(内部panel地址)
    fastcgi_index index.php;  # PHP 脚本的默认首页
    include fastcgi_params;  # 包含 fastcgi 参数配置
    fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";  # 设置 PHP 配置参数
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;  # 设置脚本文件名
    fastcgi_param HTTP_PROXY "";  # 禁用 HTTP_PROXY
    fastcgi_intercept_errors off;  # 关闭错误拦截
    fastcgi_buffer_size 16k;  # 设置 fastcgi 缓冲区大小
    fastcgi_buffers 4 16k;  # 设置 fastcgi 缓冲区数量和大小
    fastcgi_connect_timeout 300;  # 设置 fastcgi 连接超时时间
    fastcgi_send_timeout 300;  # 设置 fastcgi 发送超时时间
    fastcgi_read_timeout 300;  # 设置 fastcgi 读取超时时间
  }

# 禁止访问 .ht 文件
  location ~ /\.ht {
    deny all;  # 禁止所有访问
  }
}
```

### Wings 生成 SSL
```bash
# 填写相关变量，方便后面调用
export domain="你的域名"  # 配置你的域名
export CF_Email="ai773203918@qq.com"  # CloudFlare 邮箱
export CF_Token="xxxxxxxxxx"  # CloudFlare API 令牌

# 安装 acme.sh
git clone https://git.918178.xyz/https://github.com/acmesh-official/acme.sh.git && cd acme.sh  # 拉取 acme.sh
./acme.sh --install --nocron --home /usr/local/share/acme.sh --accountemail ${CF_Email}  # 安装 acme.sh

# 创建 SSL证书
mkdir -p /etc/letsencrypt/live/${domain}  # 创建所需文件夹(-p 自动创建父级)
./acme.sh --issue --dns dns_cf -d "${domain}" --server letsencrypt --key-file /etc/letsencrypt/live/${domain}/privkey.pem --fullchain-file /etc/letsencrypt/live/${domain}/fullchain.pem

# 添加定时任务
crontab -e  # 编辑定时任务
  0 0 1,15 * * /root/acme.sh/acme.sh --cron  # 每月1,15号00:00执行
```

## 常见问题
### 创建用户报错
`无法保存 Pterodactyl\Models\User[]: 验证数据失败: {"username":...}`
这个大概率就是因为和 docker-compose 中发送邮件的邮箱设置的一样导致的，还有就是用户名推荐使用邮箱前缀

### 启动服务器报错
`server is currently installing`
系统还在安装中，等待安装完成再操作

### Wings 加入报错
- `invalid pool request: Pool overlaps with other one on this address space`
Wings加入时报错，大概率是之前加入过，已经创建对应的网桥了，删除即可
```bash
docker network ls  # 查看网桥
docker network rm pterodactyl_default  # 删除 pterodactyl 的网桥
```

- `tls: failed to verify certificate: x509: certificate signed by unknown authority`
TLS：无法验证证书：X509：证书由未知颁发机构签名
一般发生在添加了SSL且正常有效(有的设备可以有的无效)，主要是此设备未添加颁布该证书的根证书
添加颁布者证书到此设备即可
```bash
# 比如我使用的是 Let's Encrypt 颁布的证书，找到颁布时的 ca.cer
nano /usr/local/share/ca-certificates/lets-encrypt.crt  # 把 ca.cer 内容填入
update-ca-certificates  # 更新证书
```

**相关教程：**
[近120款游戏一键开服，NAS部署超强游戏服务器管理工具——翼龙面板](https://post.smzdm.com/p/a6p7xzwn/)