Перейти к содержимому

Статья 125 из 141

Гайды

Pterodactyl Panel и Wings на VPS: установка панели для игровых серверов и запуск Minecraft

Pterodactyl — бесплатная панель для управления игровыми серверами. Каждый сервер работает в отдельном Docker-контейнере, а вы управляете им из браузера: консоль, файлы, SFTP, расписания, бэкапы. Панель подходит, если вы держите несколько игровых серверов или выдаёте их друзьям и клиентам.

Система состоит из двух частей:

Компонент Что делает Где работает
Panel Веб-интерфейс на PHP (Laravel), база MariaDB, Redis один сервер
Wings Демон на Go: запускает контейнеры, отдаёт консоль и SFTP на каждом сервере с играми (узле)

В этой статье Panel и Wings стоят на одном VPS. Позже Wings можно поставить на другие серверы и подключить их к той же панели.

Статья для стабильной ветки 1.x (на момент написания 1.15.2). Версия 2.0 пока в бета-тестировании, и команды для неё отличаются.

Ресурс Панель + Wings + один сервер Minecraft
CPU от 2 vCPU
RAM от 4 ГБ (сама игра заберёт большую часть)
Диск от 40 ГБ NVMe
ОС Ubuntu 22.04 или 24.04
Виртуализация KVM (Wings нужен полноценный Docker)
  • Домен, например panel.example.com, с A-записью на IP сервера (DNS). Этот же домен будет адресом узла Wings.
  • Сколько ресурсов нужно под игру: ресурсы для Minecraft.

Панели нужны PHP 8.2 или 8.3 (рекомендуется 8.3), MariaDB, Redis, Nginx и Composer 2.

Окно терминала
apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
# Только для Ubuntu 22.04: репозиторий с PHP 8.3. В 24.04 PHP 8.3 уже есть.
LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php
# Официальный репозиторий Redis
curl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | tee /etc/apt/sources.list.d/redis.list
apt update
apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
Окно терминала
mkdir -p /var/www/pterodactyl
cd /var/www/pterodactyl
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/download/v1.15.2/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/* bootstrap/cache/

Официальная инструкция качает releases/latest. Мы указываем версию явно: после выхода 2.0 ссылка latest начнёт вести на неё.

Окно терминала
mariadb -u root -p
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'надёжный_пароль';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit

MariaDB слушает только localhost. Не открывайте порт 3306 наружу.

Окно терминала
cd /var/www/pterodactyl
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan key:generate --force

Команду key:generate запускайте только при первой установке. Сразу сохраните ключ в менеджер паролей:

Окно терминала
grep APP_KEY /var/www/pterodactyl/.env

Без APP_KEY зашифрованные данные панели не восстановить даже из бэкапа базы.

Дальше три интерактивных мастера:

Окно терминала
php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail

В первом укажите URL https://panel.example.com и выберите Redis для кеша, сессий и очереди. Во втором введите пользователя и пароль базы из шага 3. Третий настраивает почту: выберите smtp, если у вас есть почтовый сервер.

Создайте таблицы и стандартные яйца (шаблоны игр), затем администратора:

Окно терминала
php artisan migrate --seed --force
php artisan p:user:make
chown -R www-data:www-data /var/www/pterodactyl/*

Пароль администратора: от 8 символов, буквы в разных регистрах и хотя бы одна цифра.

Откройте crontab -e и добавьте строку:

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Создайте /etc/systemd/system/pteroq.service:

[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service
[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s
[Install]
WantedBy=multi-user.target
Окно терминала
systemctl enable --now redis-server
systemctl enable --now pteroq.service

Получите сертификат, пока включён стандартный сайт Nginx:

Окно терминала
apt install -y certbot python3-certbot-nginx
certbot certonly --nginx -d panel.example.com
rm /etc/nginx/sites-enabled/default

Создайте /etc/nginx/sites-available/pterodactyl.conf (официальный конфиг, сокращены только комментарии):

server {
listen 80;
server_name panel.example.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
server_name panel.example.com;
root /var/www/pterodactyl/public;
index index.php;
access_log /var/log/nginx/pterodactyl.app-access.log;
error_log /var/log/nginx/pterodactyl.app-error.log error;
client_max_body_size 100m;
client_body_timeout 120s;
sendfile off;
ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/panel.example.com/privkey.pem;
ssl_session_cache shared:SSL:10m;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
ssl_prefer_server_ciphers on;
add_header X-Content-Type-Options nosniff;
add_header X-XSS-Protection "1; mode=block";
add_header X-Robots-Tag none;
add_header Content-Security-Policy "frame-ancestors 'self'";
add_header X-Frame-Options DENY;
add_header Referrer-Policy same-origin;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTP_PROXY "";
fastcgi_intercept_errors off;
fastcgi_buffer_size 16k;
fastcgi_buffers 4 16k;
fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;
include /etc/nginx/fastcgi_params;
}
location ~ /\.ht {
deny all;
}
}
Окно терминала
ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
nginx -t && systemctl restart nginx

Откройте https://panel.example.com и войдите под администратором. Подробнее о сертификатах: Let’s Encrypt.

Окно терминала
curl -sSL https://get.docker.com/ | CHANNEL=stable bash
systemctl enable --now docker
mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings
  1. В админке откройте Locations и создайте локацию, например de.
  2. Nodes → Create New: FQDN panel.example.com, Communicate Over SSL, порт демона 8080, SFTP 2022. Укажите память и диск, которые отдаёте играм, оставив запас системе.
  3. На вкладке Configuration узла скопируйте содержимое в /etc/pterodactyl/config.yml. Или нажмите Generate Token и выполните готовую команду на сервере.
  4. Проверьте запуск: wings --debug. Если ошибок нет, остановите его через Ctrl+C.
  5. На вкладке Allocation добавьте IP сервера (узнать: hostname -I | awk '{print $1}', не 127.0.0.1) и порты, например 25565-25570.

Создайте /etc/systemd/system/wings.service:

[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
Окно терминала
systemctl enable --now wings

Через минуту у узла в списке Nodes появится зелёное сердечко.

Wings использует тот же сертификат, поэтому при продлении перезапускайте и его. Добавьте в crontab -e:

0 23 * * * certbot renew --quiet --deploy-hook "systemctl reload nginx && systemctl restart wings"
Порт Зачем
80, 443 TCP панель
8080 TCP API Wings, к нему подключается браузер для консоли
2022 TCP SFTP к файлам серверов
25565 TCP и ваши allocation-порты игровые серверы
Окно терминала
ufw allow 80,443,8080,2022/tcp
ufw allow 25565:25570/tcp

Подробнее: файрвол, проверка портов.

  1. Servers → Create New. Укажите имя, владельца и allocation (например 25565).
  2. Задайте лимиты памяти, CPU и диска. В Backup Limit поставьте хотя бы 1–3, иначе встроенные бэкапы будут недоступны.
  3. Nest: Minecraft, Egg: Paper. В том же гнезде есть Vanilla, Forge, Sponge и BungeeCord.
  4. Docker Image: для свежих версий Minecraft выберите самый новый образ Java из списка. MINECRAFT_VERSION=latest оставит актуальную версию.
  5. Нажмите Create и дождитесь установки. Затем откройте сервер в клиентской части панели и нажмите Start. При первом запуске панель предложит принять EULA Minecraft.

Игроки подключаются к IP_СЕРВЕРА:25565. Настройки самой игры: сервер Minecraft, защита: игровые серверы.

Панель в пределах 1.x:

Окно терминала
cd /var/www/pterodactyl
php artisan down
curl -L https://github.com/pterodactyl/panel/releases/download/v1.15.2/panel.tar.gz | tar -xzv
chmod -R 755 storage/* bootstrap/cache
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan view:clear
php artisan config:clear
php artisan migrate --seed --force
chown -R www-data:www-data /var/www/pterodactyl/*
php artisan queue:restart
php artisan up

Подставьте номер нужного релиза 1.x. Не заменяйте его на latest и не запускайте php artisan p:upgrade без --release: так вы попадёте на 2.0, а переход на неё делается по отдельной инструкции.

Wings (игровые серверы при этом не останавливаются):

Окно терминала
systemctl stop wings
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings
systemctl restart wings
Что Где
База панели mysqldump panel
Ключ и настройки панели /var/www/pterodactyl/.env
Конфиг Wings /etc/pterodactyl/config.yml
Файлы игровых серверов /var/lib/pterodactyl/volumes
Встроенные бэкапы серверов /var/lib/pterodactyl/backups
Окно терминала
mysqldump panel > /root/panel-$(date +%F).sql
tar -czf /root/ptero-$(date +%F).tar.gz /var/www/pterodactyl/.env /etc/pterodactyl /root/panel-$(date +%F).sql

При восстановлении всегда возвращайте .env вместе с базой. Копии храните вне сервера: бэкапы.

Симптом Причина/решение
Ошибка 500 в панели Смотрите лог: tail -n 100 /var/www/pterodactyl/storage/logs/laravel-$(date +%F).log. Частая причина: права, повторите chown -R www-data:www-data /var/www/pterodactyl/*
Узел с красным сердечком, консоль не открывается systemctl status wings, затем wings --debug. Проверьте, что открыт 8080, config.yml совпадает с вкладкой Configuration, а сертификат не истёк
Панель по HTTPS, Wings по HTTP Схемы должны совпадать. Включите SSL у узла и перенастройте config.yml
Домен за Cloudflare, Wings недоступен Выключите проксирование (оранжевое облако) для записи узла
Invalid MAC после восстановления В .env другой APP_KEY. Верните исходный ключ, без него данные не расшифровать
Расписания и письма не работают Проверьте cron и journalctl -xeu pteroq, перезапустите systemctl restart pteroq
В контейнерах нет интернета Хостинг блокирует DNS 1.1.1.1 из config.yml. Замените DNS в разделе docker на серверы из resolvectl status и перезапустите Wings
Игроки не подключаются Порт allocation не открыт или сервер слушает другой порт: проверка портов

Pelican Panel начинался как форк Pterodactyl и развивается как отдельный проект со своей документацией на pelican.dev. Он тоже управляет серверами в Docker через демон Wings. Команды из этой статьи к Pelican не подходят.