Установка панели Pterodactyl и Wings
Установите Pterodactyl на ваш Linux-сервер: панель, база данных, HTTPS, Docker, Wings, нода, порты, аллокации, первый игровой сервер, обновления и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как установить 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-serverDebian 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-serverUbuntu 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-serverUbuntu 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-serverComposer и проверка
На всех системах установите 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 pingphp -v должен показать версию 8.3, а redis-cli ping должен ответить PONG.
Шаг 3: создание базы данных
Сгенерируйте пароль и сохраните его:
openssl rand -base64 24Откройте MariaDB. Если запрашивается пароль, а вы его не задавали, нажмите Enter.
mariadb -u root -pCREATE 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 wingschmod 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.confserver {
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: создание ноды в панели
В администрировании панели:
- Откройте Locations, нажмите Create New и создайте расположение, например
fr - Откройте Nodes, затем нажмите Create New
- Заполните форму:
| Поле | Значение |
|---|---|
| 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.
- После создания откройте вкладку Configuration ноды и скопируйте показанный блок
- Вставьте его на сервере, затем защитите файл, который содержит секретный токен:
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.targetsystemctl 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:
- Создайте токен GSLT, как описано в руководстве Создание сервера Garry's Mod
- Откройте Servers, затем Create New
- Укажите название, владельца, ноду и свободную аллокацию
- Задайте лимиты памяти, диска и процессора
- Выберите nest Source Engine и egg Garrys Mod
- Заполните 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 upWings
Работающие игровые серверы это не затрагивает. Замените 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.