Установка и настройка Pterodactyl Panel на VPS: создание игрового хостинга в Docker

6. Конфігурація веб-сервера і SSL

Для роботи панелі нам потрібен конфігураційний файл Nginx. Ми будемо використовувати сучасний підхід з примусовим HTTPS через Certbot.

# Установка Certbot
sudo apt install -y certbot python3-certbot-nginx

# Получение сертификата (замените panel.example.com на ваш домен)
sudo certbot certonly --nginx -d panel.example.com
    

Приклад конфігурації Nginx (/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;

    # SSL (пути к сертификатам Certbot)
    ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/panel.example.com/privkey.pem;

    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 SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}
    

Активуйте конфіг і перезапустіть Nginx:

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
sudo systemctl restart nginx
    

7. Встановлення та налаштування Wings

Wings — це серце системи, що працює на стороні вузла. Спочатку встановимо Docker, який необхідний для роботи Wings.

curl -sSL https://get.docker.com/ | CHANNEL=stable bash
sudo systemctl enable --now docker
    

Тепер завантажимо бінарний файл Wings і створимо необхідні директорії.

```html
sudo mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64
sudo chmod +x /usr/local/bin/wings
    

Щоб зв'язати Wings з панеллю, перейдіть у веб-інтерфейс панелі (який ми налаштували в попередньому кроці):

1. Зайдіть в розділ Nodes і створіть новий вузол.
2. Вкажіть IP вашого сервера, ліміти пам'яті та диска.
3. Після створення перейдіть у вкладку Configuration цього вузла.
4. Скопіюйте вміст (YAML) у файл /etc/pterodactyl/config.yml на сервері.

Запуск Wings як системного сервісу (/etc/systemd/system/wings.service):

[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=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

[Install]
WantedBy=multi-user.target
    

sudo systemctl enable --now wings
    

8. Створення першого ігрового сервера

Після того, як вузол (Node) в панелі загориться зеленим сердечком (статус "Online"), можна приступати до створення ігрового сервера. В Pterodactyl це робиться через "Nests" (Гнізда) та "Eggs" (Яйця).

Nest — це категорія (наприклад, Minecraft або Steam Games).
Egg — це конкретний конфіг для гри (наприклад, Paper Minecraft або CS2), що містить Docker-образ і скрипти запуску.

Кроки зі створення сервера:

• Перейдіть в Admin -> Servers -> Create New.
• Виберіть користувача (власника).
• Виберіть Node, на якому буде запущено сервер.
• Налаштуйте Allocations (IP і порт). Якщо портів немає, спочатку створіть їх в налаштуваннях Node -> Allocations.
• Вкажіть ліміти: наприклад, 4000MB RAM і 200% CPU (це 2 повних ядра).
• Натисніть Install.

В цей момент Wings отримає команду від Panel, скачає потрібний Docker-образ (наприклад, ghcr.io/pterodactyl/yolks:java_17), завантажить файли гри і запустить процес установки. Ви зможете спостерігати за цим в консолі сервера в реальному часі.

9. Бекапи та обслуговування

Ігрові дані - це найцінніше. Pterodactyl має вбудовану систему бекапів, але її потрібно правильно налаштувати. За замовчуванням бекапи зберігаються локально, що небезпечно при виході диска з ладу.

Рекомендується використовувати S3-сумісне сховище (наприклад, Minio або AWS S3) для зберігання архівів. У файлі .env панелі налаштуйте наступні параметри:

BACKUP_DRIVER=s3
AWS_ACCESS_KEY_ID=your_key
AWS_SECRET_ACCESS_KEY=your_secret
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=your_bucket
AWS_ENDPOINT=https://s3.example.com
    

Для обслуговування системи важливо регулярно оновлювати як панель, так і Wings. Процес оновлення панелі виглядає так:

cd /var/www/pterodactyl
php artisan down
curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz
tar -xzvf panel.tar.gz
chmod -R 755 storage/ bootstrap/cache/
composer install --no-dev --optimize-autoloader
php artisan migrate --seed --force
php artisan up
    

Оновлення Wings ще простіше: скачайте новий бінарний файл і перезапустіть сервіс systemctl restart wings.

10. Troubleshooting + FAQ

Чому статус Node відображається як "Heartbeat Last Reported: Never"?

Це найчастіша проблема. Перевірте три речі: 1) Чи запущений сервіс wings (systemctl status wings). 2) Чи відкритий порт 8080 в UFW. 3) Чи правильно вказано FQDN або IP в налаштуваннях Node в панелі. Також переконайтеся, що SSL-сертифікат для Wings валідний, інакше браузер буде блокувати WebSocket-з'єднання через Mixed Content.

Помилка "419 Page Expired" при вході в панель

Ця помилка зазвичай пов'язана з сесіями PHP або кешем. Спробуйте очистити кеш браузера і виконати php artisan config:clear і php artisan cache:clear в директорії панелі. Також перевірте, що права на директорію storage/framework/sessions встановлені вірно для користувача www-data.

Який VPS-конфіг мінімально підійде?

Для самої панелі і одного невеликого сервера Minecraft (Vanilla) достатньо 2 ядер CPU і 4 ГБ оперативної пам'яті. Однак для комфортної гри з друзями (5-10 чоловік) краще орієнтуватися на 8 ГБ RAM, щоб уникнути своппінгу, який моментально вбиває TPS в грі.

Що вибрати - VPS або dedicated для цієї задачі?

Якщо ви запускаєте 1-3 сервера для друзів, VPS - ідеальний і дешевий варіант. Якщо ви плануєте комерційний хостинг або запуск важких ігор типу Rust, ARK: Survival Evolved або серверів з 100+ гравцями, вам знадобиться Dedicated сервер. На VPS ресурси CPU розділяються, і "галасливі сусіди" можуть викликати мікро-фризи, критичні для ігрового процесу.

Docker-контейнер сервера постійно перезавантажується

Перевірте логи сервера через панель або безпосередньо через Docker: docker logs [container_id]. Часто проблема в нестачі пам'яті (Out of Memory) або неправильній версії Java/бібліотек у вибраному "Egg". Переконайтеся, що ви виділили серверу достатньо оперативної пам'яті з невеликим запасом під потреби самого Docker-образу.

Як змінити ліміти ресурсів на льоту?

В Pterodactyl ви можете змінити ліміти CPU і RAM в налаштуваннях сервера в будь-який момент. Wings автоматично застосує зміни до працюючого Docker-контейнеру без необхідності його повної переустановки, хоча для деяких змін може знадобитися перезапуск сервера (Restart).

11. Висновки та наступні кроки

Ми успішно розгорнули професійне середовище для ігрового хостингу. Pterodactyl Panel забезпечує зручний інтерфейс управління, а Wings гарантує ізоляцію і стабільність ігрових процесів в Docker-контейнерах.

Тепер, коли база готова, ви можете рухатися далі:

• Масштабування: Орендуйте додаткові VPS в різних локаціях і підключіть їх як нові Nodes до вашої центральної панелі.
• Кастомізація: Вивчіть репозиторій ParkerVCP Eggs для додавання підтримки сотень інших ігор, від Terraria до Palworld.
• Автоматизація: Налаштуйте API-інтеграцію з білінговими системами (наприклад, WHMCS або Blesta), якщо плануєте продавати ігрові сервери.

Пам'ятайте, що безпека ігрового сервера — це безперервний процес. Регулярно оновлюйте ядро системи, стежте за логами Wings і робіть щоденні бекапи баз даних і файлів ігрових світів.