ACLClouds
ACLClouds

Pterodactyl: что это и как установить его на VPS

Панель Pterodactyl и демон Wings простыми словами, затем полная установка на VPS с Debian или Ubuntu: PHP, MariaDB, Redis, nginx, certbot, Docker и

Pterodactyl здесь не летающий ящер, а панель с открытым кодом для создания игровых серверов и управления ими из браузера. В этом руководстве разберём, как она устроена и какая машина ей нужна, а затем пошагово установим её на VPS с Ubuntu 24.04: панель с PHP 8.3, MariaDB, Redis и nginx, HTTPS через certbot, а потом Wings и Docker для запуска серверов. Команды взяты из официальной документации Pterodactyl и выполняются от root.

  • Pterodactyl состоит из двух программ: веб-панели (PHP, MariaDB, Redis) и Wings, который запускает каждый игровой сервер в Docker-контейнере.
  • Нужен VPS на KVM с Ubuntu, Debian, Rocky или AlmaLinux, домен для HTTPS и 2 Гб RAM на одну панель.
  • Если Wings стоит на той же машине, нужная RAM равна памяти панели плюс памяти каждого игрового сервера.
  • Храните вне VPS копии файла .env (APP_KEY), базы панели и томов серверов.

Что такое Pterodactyl?

Pterodactyl это панель управления игровыми серверами под лицензией MIT. Она состоит из двух программ: самой панели, веб-приложения на PHP, где хранятся аккаунты, серверы и настройки, и Wings, демона на Go, который запускает каждый игровой сервер в отдельном Docker-контейнере. Одна панель может управлять несколькими машинами с Wings, их называют нодами.

  • Панель: веб-интерфейс, API, база MariaDB или MySQL, кэш и очередь задач в Redis.
  • Wings: API ноды на порту 8080 и SFTP на порту 2022 по умолчанию, Docker-контейнеры для серверов.
  • Eggs: шаблоны серверов (Minecraft Paper, Rust, ARK, боты и другие), в которых описаны Docker-образ, установка и команда запуска.
  • Каждый игрок или клиент получает доступ к своим серверам: консоль, файлы, резервные копии, задачи по расписанию и дополнительные пользователи.

Требования: система, RAM и виртуализация

Официальная документация поддерживает Ubuntu 22.04 и 24.04, Debian 11, 12 и 13, а также Rocky Linux и AlmaLinux 8 и 9. Панели нужны PHP 8.2 или 8.3, MariaDB 10.2 и новее (или MySQL 5.7.22 и новее), Redis, веб-сервер и Composer 2. Для Wings нужны Docker и полная виртуализация: KVM подходит, а с OpenVZ и LXC почти всегда возникают проблемы.

  • Проверьте виртуализацию командой systemd-detect-virt: в выводе не должно быть openvz или lxc. VPS ACLClouds работают на KVM.
  • RAM: самой панели хватает 2 Гб. Если Wings стоит на той же машине, прибавьте память каждого игрового сервера, например 4 Гб для сервера Minecraft Paper примерно на десять игроков.
  • Для HTTPS нужен домен, указывающий на IP VPS; подойдёт бесплатный субдомен в зоне aclclouds.online.
  • Для панели и одного-двух небольших серверов хватит тарифа Mini (8 Гб RAM, 2 vCPU); если серверов больше, тариф Essentiel (16 Гб, 4 vCPU) даст запас. Смотрите VPS на Linux.

Установить PHP, MariaDB, Redis и nginx

В Ubuntu 24.04 PHP 8.3 ставится из репозитория ondrej/php. Сначала обновите систему командой apt update && apt -y upgrade, затем установите зависимости и Composer. Для Debian в официальной документации есть отдельная страница с другим репозиторием PHP: используйте её вместо этих команд.

  • apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
  • LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && 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

Скачать панель и создать базу данных

Панель устанавливается в /var/www/pterodactyl из архива последней версии на GitHub. Затем создайте базу MariaDB и пользователя, которого использует только панель, с длинным уникальным паролем.

  • mkdir -p /var/www/pterodactyl && cd /var/www/pterodactyl
  • 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/
  • В mariadb -u root -p: CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'unikalnyiParol'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
  • cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
  • php artisan key:generate --force: ключ APP_KEY шифрует часть данных панели. Сохраните его копию вне сервера, без него восстановление невозможно.

Настроить окружение и создать администратора

Три интерактивных мастера заполняют файл .env: адрес панели и драйверы кэша, сессий и очереди (выберите Redis), затем подключение к базе, затем отправку почты. После этого миграция создаёт таблицы и встроенные eggs, а последняя команда создаёт первую учётную запись администратора.

  • php artisan p:environment:setup, затем php artisan p:environment:database и php artisan p:environment:mail
  • php artisan migrate --seed --force: не прерывайте её, импорт eggs занимает некоторое время.
  • php artisan p:user:make: на вопрос об администраторе ответьте yes.
  • chown -R www-data:www-data /var/www/pterodactyl/*: файлы должны принадлежать пользователю веб-сервера.

Включить задачу cron и обработчик очереди

Панели нужна задача cron, которая запускается каждую минуту (очистка, задачи серверов по расписанию), и обработчик, который разбирает очередь Redis. Без него создание серверов и письма зависают.

  • crontab -e, затем строка: * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
  • Создайте /etc/systemd/system/pteroq.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
  • systemctl enable --now redis-server, затем systemctl enable --now pteroq.service

Настроить nginx и HTTPS через certbot

Сначала направьте A-запись домена, например panel.example.com, на IPv4 вашего VPS. Затем получите сертификат через плагин nginx для certbot и создайте серверный блок панели по шаблону nginx с SSL из официальной документации: root /var/www/pterodactyl/public, передача PHP в сокет PHP-FPM 8.3 и пути к полученному сертификату.

  • apt -y install certbot python3-certbot-nginx, затем certbot certonly --nginx -d panel.example.com
  • В /etc/nginx/sites-available/pterodactyl.conf: server_name panel.example.com, ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem и fastcgi_pass unix:/run/php/php8.3-fpm.sock.
  • rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/, затем nginx -t && systemctl restart nginx
  • Продление идёт автоматически по таймеру certbot; проверьте его командой certbot renew --dry-run. Подробности в руководстве по бесплатному HTTPS-сертификату.

Установить Docker и Wings и подключить ноду

Wings может работать на том же VPS, что и панель, или на другой машине. Установите Docker официальным скриптом, затем бинарный файл Wings. В панели создайте Location, затем ноду с её доменом, опцией SSL, а также памятью и диском, которые она отдаёт серверам. На вкладке Configuration ноды показано содержимое config.yml, которое нужно скопировать в /etc/pterodactyl.

  • 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_amd64 && chmod u+x /usr/local/bin/wings
  • Сначала запустите wings --debug, чтобы увидеть ошибки, затем создайте службу wings.service (ExecStart=/usr/local/bin/wings, после docker.service) и включите её командой systemctl enable --now wings.
  • Добавьте ноде allocations: публичный IP из вывода hostname -I, никогда не 127.0.0.1, и диапазон портов, например 25565-25600.
  • Когда Wings отвечает, панель показывает зелёное сердце рядом с нодой; если его нет, проверьте сертификат и порт 8080.

Защитить панель и ноды

Игровая панель открывает в сеть интерфейс администратора, API и игровые порты, поэтому её атакуют. Открывайте только нужные порты, защищайте учётные записи и делайте копии всего, что нельзя переустановить. Основы защиты VPS описаны в нашем руководстве по безопасности Linux.

  • Файрвол: 22 (SSH), 80 и 443 для панели, 8080 и 2022 для Wings, затем порты allocations, TCP и UDP в зависимости от игры.
  • Включите двухфакторную аутентификацию для администраторов и отключите вход по SSH с паролем.
  • Сохраняйте файл .env, базу panel (mysqldump panel) и данные серверов из /var/lib/pterodactyl/volumes, а копии храните вне VPS.
  • Обновляйте панель командой php artisan p:upgrade, а Wings заменой бинарного файла, предварительно сделав копию и прочитав заметки к выпуску.

Ничего не устанавливать: варианты ACLClouds

Если вам нужна своя панель без всех этих шагов, преднастроенный VPS с Pterodactyl сам установит панель, MariaDB, Redis, обработчик очереди и HTTPS по вашему домену и данным администратора. VPS Pterodactyl + Wings добавляет Docker и Wings, причём нода, её config.yml и 100 allocations уже созданы. В обоих случаях root-доступ остаётся у вас.

  • Эти образы стоят столько же, сколько обычные VPS: преднастроенная установка входит в цену.
  • Если вы хотите просто играть, не администрируя сервер, наши игровые серверы работают на панели ACLClouds, построенной на Pterodactyl и Wings: сервер передаётся готовым, вам ничего не нужно устанавливать.

Часто задаваемые вопросы

Pterodactyl бесплатный?

Да. Панель и Wings выпускаются под лицензией MIT, без ограничений на число серверов и пользователей. Вы платите только за машину, на которой они работают.

Сколько RAM нужно для Pterodactyl?

Одной панели хватает 2 Гб. Если Wings работает на том же VPS, сложите память всех игровых серверов: 8 Гб хватит на один-два небольших сервера, 16 Гб на несколько средних.

Можно ли установить Pterodactyl на Windows?

Нет. Панель и Wings рассчитаны на Linux, а Wings под Windows не работает. Возьмите VPS на Linux или, для тестов, виртуальную машину с Linux на своём ПК.

Нужен ли для Pterodactyl домен?

Для реальной работы да: HTTPS панели и защищённое соединение между панелью и Wings опираются на сертификат, выданный на имя. Бесплатного субдомена в aclclouds.online достаточно.