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 достаточно.