第一部分：故障复盘与避坑指南 (重要存档)
防止下次重新部署时再次遇到 SSL 和数据库问题
Pterodactyl 部署三大坑位总结
| 问题阶段 | 现象描述 | 核心原因 | 最终解决办法 |
|---|---|---|---|
| 数据库连接 | TLS/SSL error: Certificate is NOT trusted 或 SSL is required | 1Panel 的 MySQL 默认开启了 SSL，但 Pterodactyl 容器客户端连接参数与其不兼容。 | 1. MySQL 参数配置加入 skip-ssl。2. 容器环境变量加入 DB_SSL=false 与 DB_SSL_MODE=disabled。 |
| 初始化报错 | Table 'users' doesn't exist | 自动初始化脚本因 SSL 报错中断，导致数据库建表失败，成为空库。 | 手动进入容器终端执行建表命令：php artisan migrate --seed --force |
| 命令行报错 | mysql-schema.sql 导入失败 | 即使 PHP 层面关闭了 SSL，但容器自带的底层 mysql 命令行工具依然强制要求 SSL。 | 在容器终端内建立本地跳过配置：echo -e "[client]\nskip-ssl\nssl=0" > ~/.my.cnf |
| 账号创建 | validation failed: name_last cannot be empty | 命令行创建管理员账号时，First Name 或 Last Name 直接回车留空。 | 重新执行 php artisan p:user:make，每一个要求输入的选项都必须填入实际字符，不可直接回车。 |
重新部署的快捷 checklist：
先改数据库： 在 1Panel 的 MySQL 配置里加上 skip-ssl。
环境变量： 部署应用时，环境变量务必带上 DB_SSL=false 和 DB_SSL_MODE=disabled。
万能修复： 如果容器起来了但页面打不开，直接进终端运行：
echo -e "[client]\nskip-ssl\nssl=0" > ~/.my.cnf
php artisan migrate --seed --force
php artisan p:user:make
第二部分：分布式对接节点 (Wings) 的核心流程
要在另一台服务器B机器上运行游戏，通过面板A管理，按以下逻辑操作：
1.面板端（A 机器）的操作
创建位置 (Location)： 在面板后台点击 Locations -> Create New（随便起名，如 "Remote-DataCenter"）。
创建节点 (Node)： 点击 Nodes -> Create New。
FQDN: 输入 B 机器的 公网 IP。
Comm Type: 如果没有配置域名和 SSL 证书，先选 HTTP（对接成功后再说 HTTPS）。
Daemon Port: 默认 8080（必须在 B 机器防火墙放行）。
SFTP Port: 默认 2022（必须在 B 机器防火墙放行）。
Memory/Disk: 根据 B 机器的实际配置填写。
获取配置： 创建好 Node 后，点击 Configuration 选项卡，会看到一段 JSON 代码。
2.受控端（B 机器）的操作
安装环境： B 机器必须安装 Docker（Pterodactyl 的所有游戏都跑在 Docker 里）。
安装 Wings：
sudo curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64"
sudo chmod u+x /usr/local/bin/wings
3.写入配置：
创建目录：mkdir -p /etc/pterodactyl
将面板上那段 JSON 代码 粘贴到 /etc/pterodactyl/config.yml 中。
4.启动 Wings： 执行 sudo wings。如果看到 Wings is now running 且面板上的小圆点变绿，说明对接成功！