RU

Игровые серверы

Установка панели Pterodactyl и Wings

Установите Pterodactyl на ваш Linux-сервер: панель, база данных, HTTPS, Docker, Wings, нода, порты, аллокации, первый игровой сервер, обновления и устранение неполадок.

11 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как установить Pterodactyl на ваш Linux-сервер, чтобы управлять игровыми серверами через веб-интерфейс. Оно охватывает панель, Wings, HTTPS, порты, аллокации и первый игровой сервер.

HostMyServers не предлагает управляемый игровой хостинг: вы самостоятельно устанавливаете и администрируете Pterodactyl. Это руководство следует официальной документации проекта для стабильной ветки 1.x.

Заказать сервер

Pterodactyl работает на VPS или выделенном сервере:

Заложите ресурсы для панели, Docker и всех игровых серверов, которые вы собираетесь запускать.

Как это работает

Компонент Назначение
Panel Веб-приложение на PHP: учётные записи, серверы, права. Использует MariaDB и Redis
Wings Служба, устанавливаемая на каждую машину, где размещаются игры. Управляет Docker
Нода Машина, на которой работает Wings, объявленная в панели
Allocation Пара из IP-адреса и порта, назначаемая игровому серверу
Egg Шаблон, описывающий, как установить и запустить игру

В этом руководстве панель и Wings устанавливаются на одну машину. Чтобы разместить Wings на другой машине, выполните на ней шаги с 9 по 13, откройте на ней порты ноды и получите сертификат командой certbot certonly --standalone, поскольку веб-сервер там не нужен.

Предварительные требования

  • 64-разрядный сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Доступ root или пользователь с sudo
  • Два поддомена, указывающих на сервер, с DNS-записью A: panel.ваш-домен.com и node1.ваш-домен.com
  • Виртуализация, совместимая с Docker

Проверьте тип виртуализации и DNS:

Терминал
systemd-detect-virt
getent hosts panel.ваш-домен.com node1.ваш-домен.com

Подходят KVM и none (физическая машина). С openvz или lxc Wings, вероятно, работать не будет.

Следующие команды выполняются от имени root. Откройте сессию командой:

Терминал
sudo -i

Используемые порты

Порт Протокол Служба Доступ
22 TCP SSH Администрирование
80 TCP Nginx, проверка Let's Encrypt и перенаправление Публичный
443 TCP Панель по HTTPS Публичный
8080 TCP API Wings, используется панелью и браузерами Публичный
2022 TCP SFTP Wings, для файлов серверов Публичный
Аллокации TCP и UDP Игры, например 27015 - 27020 Публичный

MariaDB (3306) и Redis (6379) остаются локальными: не открывайте их.

Шаг 1: открытие портов

С UFW разрешите SSH до включения брандмауэра, изменив порт, если вы меняли порт SSH:

Терминал
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8080/tcp
ufw allow 2022/tcp
ufw enable
ufw status

С iptables или nftables откройте те же TCP-порты. Не сохраняйте весь набор правил после установки Docker, так как он добавляет в него свои правила: добавьте ваши правила в ваш файл конфигурации.

Шаг 2: установка зависимостей панели

Панели требуются PHP 8.2 или 8.3 (рекомендуется 8.3), MariaDB 10.2 или новее, Redis, веб-сервер и Composer 2. Выполняйте только блок для вашей системы.

Debian 13

Терминал
apt update
apt install -y curl ca-certificates gnupg2 sudo lsb-release
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/sury-php.list
curl -fsSL https://packages.sury.org/php/apt.gpg | gpg --dearmor -o /etc/apt/trusted.gpg.d/sury-keyring.gpg
apt update
apt install -y php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

Debian 12

Терминал
apt update
apt install -y curl ca-certificates gnupg2 sudo lsb-release
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/sury-php.list
curl -fsSL https://packages.sury.org/php/apt.gpg | gpg --dearmor -o /etc/apt/trusted.gpg.d/sury-keyring.gpg
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
curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | bash
apt update
apt install -y php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

Ubuntu 24.04

Терминал
apt update
apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg lsb-release
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 install -y php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

Ubuntu 22.04

Терминал
apt update
apt install -y software-properties-common curl apt-transport-https ca-certificates gnupg lsb-release
LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php
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 install -y php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

Composer и проверка

На всех системах установите Composer, включите Redis и проверьте версии:

Терминал
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
systemctl enable --now redis-server
php -v
composer --version
mariadb --version
redis-cli ping

php -v должен показать версию 8.3, а redis-cli ping должен ответить PONG.

Шаг 3: создание базы данных

Сгенерируйте пароль и сохраните его:

Терминал
openssl rand -base64 24

Откройте MariaDB. Если запрашивается пароль, а вы его не задавали, нажмите Enter.

Терминал
mariadb -u root -p
SQL
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'GeneratedPassword';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit

Шаг 4: загрузка панели

Терминал
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/

Шаг 5: настройка панели

Установите зависимости PHP и сгенерируйте ключ шифрования:

Терминал
cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan key:generate --force
grep APP_KEY /var/www/pterodactyl/.env

Затем запустите мастера настройки:

Терминал
php artisan p:environment:setup
php artisan p:environment:database
php artisan p:environment:mail
Вопрос Рекомендуемый ответ
Egg Author Email Ваш адрес электронной почты
Application URL https://panel.ваш-домен.com
Application Timezone Europe/Paris или ваш часовой пояс
Cache Driver, Session Driver и Queue Driver redis
Enable UI based settings editor? yes
Enable sending anonymous telemetry data? На ваше усмотрение
Redis Host и порт 127.0.0.1 и 6379, без пароля при локальной установке по умолчанию
Database Host и Database Port 127.0.0.1 и 3306
Database Name panel
Database Username pterodactyl
Database Password Пароль из шага 3

Для электронной почты проект рекомендует SMTP-сервер, а не внутреннюю отправку PHP. Телеметрия панели анонимна и описана проектом.

Создайте таблицы, затем вашу учётную запись администратора. Миграция может занять много времени: не прерывайте её.

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

На вопрос Is this user an administrator? ответьте yes. Пароль должен содержать не менее 8 символов, с заглавными и строчными буквами и цифрой.

Шаг 6: включение фоновых задач

Откройте crontab пользователя root:

Терминал
crontab -e

Добавьте эту строку:

Текст
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Создайте сервис очереди:

Терминал
nano /etc/systemd/system/pteroq.service
Конфигурация
# Pterodactyl Queue Worker File
# ----------------------------------

[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 daemon-reload
systemctl enable --now pteroq.service
systemctl is-active pteroq.service

Команда должна ответить active.

Шаг 7: получение сертификатов HTTPS

Панели и Wings нужен свой сертификат каждому. Если панель работает по HTTPS, Wings тоже должен работать по HTTPS.

Терминал
apt install -y certbot python3-certbot-nginx
certbot certonly --nginx -d panel.ваш-домен.com
certbot certonly --nginx -d node1.ваш-домен.com

Создайте скрипт, который применяет обновлённые сертификаты в Nginx и Wings:

Терминал
nano /etc/letsencrypt/renewal-hooks/deploy/pterodactyl.sh
Терминал
#!/bin/bash
systemctl reload nginx
systemctl try-restart wings
Терминал
chmod 750 /etc/letsencrypt/renewal-hooks/deploy/pterodactyl.sh
certbot renew --dry-run

Перезапуск Wings не останавливает работающие игровые серверы. Проверка обновления должна завершиться без ошибок.

Шаг 8: настройка Nginx

Удалите сайт по умолчанию и создайте сайт панели:

Терминал
rm /etc/nginx/sites-enabled/default
nano /etc/nginx/sites-available/pterodactyl.conf
Nginx
server {
    listen 80;
    server_name panel.ваш-домен.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name panel.ваш-домен.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;

    # allow larger file uploads and longer script runtimes
    client_max_body_size 100m;
    client_body_timeout 120s;

    sendfile off;

    ssl_certificate /etc/letsencrypt/live/panel.ваш-домен.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/panel.ваш-домен.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.ваш-домен.com и войдите с учётной записью, созданной на шаге 5. Замок в браузере должен быть действительным.

Шаг 9: установка Docker

Wings запускает каждый игровой сервер в контейнере Docker. Установите Docker Engine по руководству Установка Docker Engine и Docker Compose, затем проверьте, что он запускается вместе с системой:

Терминал
systemctl enable --now docker
docker info --format '{{.ServerVersion}}'

Если docker info выводит WARNING: No swap limit support, а ваше ядро старше 6.1, добавьте swapaccount=1 в GRUB_CMDLINE_LINUX_DEFAULT в /etc/default/grub, выполните update-grub и перезагрузитесь. Эта настройка необязательна.

Шаг 10: установка Wings

Терминал
mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/download/v1.13.5/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings
wings version

Эта команда фиксирует версию v1.13.5, последнюю версию 1.x на момент написания. Перед установкой см. версии Wings.

Шаг 11: создание ноды в панели

В администрировании панели:

  1. Откройте Locations, нажмите Create New и создайте расположение, например fr
  2. Откройте Nodes, затем нажмите Create New
  3. Заполните форму:
Поле Значение
Name node1
Location Созданное расположение
FQDN node1.ваш-домен.com
Communicate Over SSL Use SSL Connection
Behind Proxy Not Behind Proxy
Daemon Server File Directory /var/lib/pterodactyl/volumes
Total Memory Память, выделенная под игры, в МиБ
Memory Over-Allocation 0
Total Disk Space Диск, выделенный под игры, в МиБ
Disk Over-Allocation 0
Daemon Port 8080
Daemon SFTP Port 2022

Оставьте запас для системы, панели, MariaDB и Docker.

  1. После создания откройте вкладку Configuration ноды и скопируйте показанный блок
  2. Вставьте его на сервере, затем защитите файл, который содержит секретный токен:
Терминал
nano /etc/pterodactyl/config.yml
chmod 600 /etc/pterodactyl/config.yml

Кнопка Generate Token также выдаёт команду, которая запишет этот файл за вас.

Шаг 12: запуск Wings

Сначала запустите Wings на переднем плане, чтобы увидеть возможные ошибки:

Терминал
wings --debug

Когда он работает без ошибок, остановите его командой Ctrl+C, затем создайте его сервис:

Терминал
nano /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 daemon-reload
systemctl enable --now wings
systemctl is-active wings
curl https://node1.ваш-домен.com:8080

Сервис должен быть active. Команда curl должна вернуть JSON-сообщение об отсутствии авторизации: это доказывает, что API отвечает, а сертификат действителен. В разделе Nodes у ноды должно отображаться зелёное сердце.

Шаг 13: создание аллокаций

Узнайте IP-адрес сервера:

Терминал
hostname -I | awk '{print $1}'

В разделе Nodes откройте вашу ноду, затем вкладку Allocation. В Assign New Allocations:

  • IP Address: полученный адрес, ни в коем случае не 127.0.0.1
  • IP Alias: необязательно, например node1.ваш-домен.com
  • Ports: один порт или диапазон, например 27015-27020

Каждому игровому серверу нужна как минимум одна аллокация. Wings публикует каждую по TCP и UDP.

Шаг 14: создание первого сервера

Панель предоставляет eggs для Minecraft, Rust, игр на движке Source и голосовых серверов. Чтобы проверить на Garry's Mod:

  1. Создайте токен GSLT, как описано в руководстве Создание сервера Garry's Mod
  2. Откройте Servers, затем Create New
  3. Укажите название, владельца, ноду и свободную аллокацию
  4. Задайте лимиты памяти, диска и процессора
  5. Выберите nest Source Engine и egg Garrys Mod
  6. Заполните Steam Account Token вашим токеном и подтвердите

Установка загружает образ Docker и файлы игры. Затем откройте сервер в интерфейсе и нажмите Start. Он готов, когда консоль переходит в состояние «в сети».

Проверка установки

Проверка Ожидаемый результат
systemctl is-active nginx php8.3-fpm mariadb redis-server pteroq wings docker active для каждого сервиса
https://panel.ваш-домен.com Страница входа с действительным сертификатом
Nodes Зелёное сердце у ноды
Консоль сервера Журналы отображаются в реальном времени
SFTP на порту 2022 Доступ к файлам сервера
Подключение к игре Сервер отвечает на своей аллокации

Резервное копирование

Делайте резервную копию перед каждым обновлением и храните копию за пределами сервера:

Терминал
install -d -m 700 /root/pterodactyl-backups
DATE=$(date +%F_%H-%M)
mariadb-dump --single-transaction panel | gzip > /root/pterodactyl-backups/panel_$DATE.sql.gz
tar -czf /root/pterodactyl-backups/files_$DATE.tar.gz -C / var/www/pterodactyl etc/pterodactyl etc/nginx/sites-available/pterodactyl.conf
ls -lh /root/pterodactyl-backups

Эти архивы содержат секреты, в том числе APP_KEY и токен Wings. Данные игр находятся отдельно, в /var/lib/pterodactyl/volumes, а резервные копии, созданные из панели, - в /var/lib/pterodactyl/backups. Остановите игровой сервер перед копированием его файлов, чтобы получить согласованную копию.

Обновление

Панель

Сначала сделайте резервную копию, затем замените v1.15.2 на последнюю версию 1.x. Не используйте эти шаги для перехода на 2.0 и не запускайте php artisan p:upgrade без указания версии: переход на 2.0 имеет собственную процедуру.

Терминал
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

Wings

Работающие игровые серверы это не затрагивает. Замените v1.13.5 на нужную версию:

Терминал
cp -p /usr/local/bin/wings /usr/local/bin/wings.bak
systemctl stop wings
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/download/v1.13.5/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings
systemctl restart wings

Откат

Восстановление панели

Замените DATE на метку времени ваших архивов. Эти команды сначала проверяют оба архива, затем заменяют файлы и базу. Изменения, сделанные после резервной копии, будут потеряны.

Терминал
tar -tzf /root/pterodactyl-backups/files_DATE.tar.gz > /dev/null
gunzip -t /root/pterodactyl-backups/panel_DATE.sql.gz
cd /var/www/pterodactyl
php artisan down
cd /
rm -rf /var/www/pterodactyl
tar -xzf /root/pterodactyl-backups/files_DATE.tar.gz -C / var/www/pterodactyl
mariadb -e 'DROP DATABASE panel; CREATE DATABASE panel;'
gunzip -c /root/pterodactyl-backups/panel_DATE.sql.gz | mariadb panel
cd /var/www/pterodactyl
php artisan config:clear
php artisan view:clear
php artisan queue:restart
php artisan up

Всегда восстанавливайте файл .env вместе с базой, так как он содержит APP_KEY. Архив выше его включает.

Восстановление Wings

Терминал
systemctl stop wings
cp -p /usr/local/bin/wings.bak /usr/local/bin/wings
systemctl start wings

При возникновении проблем

Чтение журналов

Терминал
tail -n 100 /var/www/pterodactyl/storage/logs/laravel-$(date +%F).log
journalctl -u wings -n 100 --no-pager
journalctl -u pteroq -n 50 --no-pager
tail -n 50 /var/log/nginx/pterodactyl.app-error.log

Нода остаётся красной или консоль показывает ошибку подключения

  • Проверьте Wings командой systemctl status wings, затем остановите его и запустите wings --debug
  • Сравните /etc/pterodactyl/config.yml с вкладкой Configuration ноды
  • Проверьте, что порты 8080 и 2022 открыты
  • Выполните curl https://node1.ваш-домен.com:8080
  • Проверьте, что и панель, и Wings используют HTTPS с действительными сертификатами
  • Отключите блокировщики рекламы для этих доменов
  • Если вы используете Cloudflare, отключите прокси для этих DNS-записей

nginx: [emerg] cannot load certificate

Указанного сертификата не существует или домен не совпадает. Выведите доступные сертификаты командой certbot certificates.

the "listen ... http2" directive is deprecated

Это всего лишь предупреждение последних версий Nginx, на работу оно не влияет.

502 Bad Gateway

PHP-FPM не отвечает. Проверьте systemctl status php8.3-fpm и путь /run/php/php8.3-fpm.sock.

failed to open stream: Permission denied

Файлы панели принадлежат не тому пользователю:

Терминал
chown -R www-data:www-data /var/www/pterodactyl/*

SQLSTATE[HY000] [1045] Access denied for user 'pterodactyl'

Пароль или хост не совпадают. Используйте 127.0.0.1 в качестве хоста и снова запустите php artisan p:environment:database.

The MAC is invalid

Ключ APP_KEY в файле .env не совпадает с тем, которым шифровались данные. Восстановите исходный ключ. Без него эти данные невозможно восстановить.

bind: address already in use при запуске Wings

Порт занят другой службой. Определите её командой ss -ltnp | grep -E ':8080|:2022'.

У игрового сервера нет доступа в Интернет

По умолчанию контейнеры используют DNS 1.1.1.1 и 1.0.0.1. Если эти адреса заблокированы в вашей сети, замените их в разделе docker файла /etc/pterodactyl/config.yml, затем перезапустите Wings.

Запланированные задачи не выполняются

Проверьте строку crontab командой crontab -l, затем сервис командами journalctl -xeu pteroq и systemctl restart pteroq.

Официальные ресурсы