Статья 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.
Шаг 1. Зависимости панели
Заголовок раздела «Шаг 1. Зависимости панели»Панели нужны 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
# Официальный репозиторий Rediscurl -fsSL https://packages.redis.io/gpg | gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpgecho "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 updateapt -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Шаг 2. Файлы панели
Заголовок раздела «Шаг 2. Файлы панели»mkdir -p /var/www/pterodactylcd /var/www/pterodactylcurl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/download/v1.15.2/panel.tar.gztar -xzvf panel.tar.gzchmod -R 755 storage/* bootstrap/cache/Официальная инструкция качает releases/latest. Мы указываем версию явно: после выхода 2.0 ссылка latest начнёт вести на неё.
Шаг 3. База данных
Заголовок раздела «Шаг 3. База данных»mariadb -u root -pCREATE 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;exitMariaDB слушает только localhost. Не открывайте порт 3306 наружу.
Шаг 4. Настройка панели
Заголовок раздела «Шаг 4. Настройка панели»cd /var/www/pterodactylcp .env.example .envCOMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloaderphp artisan key:generate --forceКоманду key:generate запускайте только при первой установке. Сразу сохраните ключ в менеджер паролей:
grep APP_KEY /var/www/pterodactyl/.envБез APP_KEY зашифрованные данные панели не восстановить даже из бэкапа базы.
Дальше три интерактивных мастера:
php artisan p:environment:setupphp artisan p:environment:databasephp artisan p:environment:mailВ первом укажите URL https://panel.example.com и выберите Redis для кеша, сессий и очереди. Во втором введите пользователя и пароль базы из шага 3. Третий настраивает почту: выберите smtp, если у вас есть почтовый сервер.
Создайте таблицы и стандартные яйца (шаблоны игр), затем администратора:
php artisan migrate --seed --forcephp artisan p:user:makechown -R www-data:www-data /var/www/pterodactyl/*Пароль администратора: от 8 символов, буквы в разных регистрах и хотя бы одна цифра.
Шаг 5. Cron и обработчик очереди
Заголовок раздела «Шаг 5. Cron и обработчик очереди»Откройте crontab -e и добавьте строку:
* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1Создайте /etc/systemd/system/pteroq.service:
[Unit]Description=Pterodactyl Queue WorkerAfter=redis-server.service
[Service]User=www-dataGroup=www-dataRestart=alwaysExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3StartLimitInterval=180StartLimitBurst=30RestartSec=5s
[Install]WantedBy=multi-user.targetsystemctl enable --now redis-serversystemctl enable --now pteroq.serviceШаг 6. Сертификат и Nginx
Заголовок раздела «Шаг 6. Сертификат и Nginx»Получите сертификат, пока включён стандартный сайт Nginx:
apt install -y certbot python3-certbot-nginxcertbot certonly --nginx -d panel.example.comrm /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.confnginx -t && systemctl restart nginxОткройте https://panel.example.com и войдите под администратором. Подробнее о сертификатах: Let’s Encrypt.
Шаг 7. Установка Wings
Заголовок раздела «Шаг 7. Установка Wings»curl -sSL https://get.docker.com/ | CHANNEL=stable bashsystemctl enable --now docker
mkdir -p /etc/pterodactylcurl -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Шаг 8. Локация, узел и порты
Заголовок раздела «Шаг 8. Локация, узел и порты»- В админке откройте Locations и создайте локацию, например
de. - Nodes → Create New: FQDN
panel.example.com, Communicate Over SSL, порт демона8080, SFTP2022. Укажите память и диск, которые отдаёте играм, оставив запас системе. - На вкладке Configuration узла скопируйте содержимое в
/etc/pterodactyl/config.yml. Или нажмите Generate Token и выполните готовую команду на сервере. - Проверьте запуск:
wings --debug. Если ошибок нет, остановите его через Ctrl+C. - На вкладке Allocation добавьте IP сервера (узнать:
hostname -I | awk '{print $1}', не127.0.0.1) и порты, например25565-25570.
Создайте /etc/systemd/system/wings.service:
[Unit]Description=Pterodactyl Wings DaemonAfter=docker.serviceRequires=docker.servicePartOf=docker.service
[Service]User=rootWorkingDirectory=/etc/pterodactylLimitNOFILE=4096PIDFile=/var/run/wings/daemon.pidExecStart=/usr/local/bin/wingsRestart=on-failureStartLimitInterval=180StartLimitBurst=30RestartSec=5s
[Install]WantedBy=multi-user.targetsystemctl 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/tcpufw allow 25565:25570/tcpПодробнее: файрвол, проверка портов.
Шаг 9. Сервер Minecraft из яйца
Заголовок раздела «Шаг 9. Сервер Minecraft из яйца»- Servers → Create New. Укажите имя, владельца и allocation (например
25565). - Задайте лимиты памяти, CPU и диска. В Backup Limit поставьте хотя бы 1–3, иначе встроенные бэкапы будут недоступны.
- Nest: Minecraft, Egg: Paper. В том же гнезде есть Vanilla, Forge, Sponge и BungeeCord.
- Docker Image: для свежих версий Minecraft выберите самый новый образ Java из списка.
MINECRAFT_VERSION=latestоставит актуальную версию. - Нажмите Create и дождитесь установки. Затем откройте сервер в клиентской части панели и нажмите Start. При первом запуске панель предложит принять EULA Minecraft.
Игроки подключаются к IP_СЕРВЕРА:25565. Настройки самой игры: сервер Minecraft, защита: игровые серверы.
Обновление
Заголовок раздела «Обновление»Панель в пределах 1.x:
cd /var/www/pterodactylphp artisan downcurl -L https://github.com/pterodactyl/panel/releases/download/v1.15.2/panel.tar.gz | tar -xzvchmod -R 755 storage/* bootstrap/cacheCOMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloaderphp artisan view:clearphp artisan config:clearphp artisan migrate --seed --forcechown -R www-data:www-data /var/www/pterodactyl/*php artisan queue:restartphp artisan upПодставьте номер нужного релиза 1.x. Не заменяйте его на latest и не запускайте php artisan p:upgrade без --release: так вы попадёте на 2.0, а переход на неё делается по отдельной инструкции.
Wings (игровые серверы при этом не останавливаются):
systemctl stop wingscurl -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/wingssystemctl 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).sqltar -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
Заголовок раздела «Pelican Panel»Pelican Panel начинался как форк Pterodactyl и развивается как отдельный проект со своей документацией на pelican.dev. Он тоже управляет серверами в Docker через демон Wings. Команды из этой статьи к Pelican не подходят.