Маршрутизируемые IPv4-адреса от 0,70 евро за IP в месяц, без минимального количества, без контракта. См. цены

Установите панель «Птеродактиль»

В предыдущем разделе вы выбрали машину, которая выдает отчет kvm или none и имеет не менее 8 ГиБ оперативной памяти - именно тот, на котором будут работать обе части Pterodactyl. Чтобы войти в панель управления игровыми серверами, сначала необходимо установить её веб-приложение и все необходимые зависимости.

Каждая из приведенных ниже команд выполняется с правами root на новом сервере Ubuntu 24.04, поэтому откройте оболочку root с помощью команды sudo -i Во-первых. Команды соответствуют официальному документация по монтажу панелей, с версиями, предоставляемыми в Ubuntu 24.04.

Установите необходимые зависимости

Панель представляет собой PHP-приложение, поэтому в первую очередь требуется среда выполнения PHP 8.3 с расширениями, которые загружает панель, а также база данных, кэш и веб-сервер. Проект Redis публикует собственный репозиторий пакетов, и в официальной документации рекомендуется добавить его перед установкой, поэтому приведенные ниже команды выполняют то же самое. Первый блок подготавливает репозиторий, а второй устанавливает всё за один раз:

apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg

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" > /etc/apt/sources.list.d/redis.list

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

В Ubuntu 22.04 этот список будет работать после добавления ppa:ondrej/php сначала из репозитория, поскольку в этом выпуске используется более старая версия PHP. В версии 24.04 пакеты PHP поставляются напрямую из Ubuntu. По завершении установки быстрая проверка версии покажет, что у вас установлено:

php -v | head -1
mariadb --version
nginx -v
redis-server --version

На свежей установке Ubuntu 24.04 были установлены PHP 8.3.6, MariaDB 10.11.14 и nginx 1.24.0 - все версии, поддерживаемые панелью. Затем установите Composer - менеджер зависимостей PHP, который загружает библиотеки, из которых состоит панель:

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Создать базу данных

Панель хранит данные о пользователях, серверах и настройках в MariaDB, поэтому ей требуется собственная база данных и пользователь, имеющий доступ только к этой базе данных. Откройте командную строку MariaDB с помощью команды mariadb -u root и выполните следующее, заменив yourPassword с длинным случайным значением, выбранным вами самими:

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'yourPassword';
CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;
exit

Почему пользователь говорит: 127.0.0.1 а не localhost?

MariaDB рассматривает эти два хоста как разные. Панель подключается по протоколу TCP к 127.0.0.1, поэтому для этого адреса необходимо создать учетную запись, а также создать учетную запись для localhost будет отклонен с ошибкой «Доступ запрещен».

Скачайте и настройте панель

Группа экспертов находится в /var/www/pterodactyl. В рамках проекта при каждом выпуске публикуется готовый архив, поэтому компилировать ничего не нужно: просто скачайте его, распакуйте, и Composer сам загрузит необходимые библиотеки PHP.

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/

cp .env.example .env
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
php artisan key:generate --force

Последняя команда записывает случайное число APP_KEY в .env файл. Панель использует этот ключ для шифрования всех конфиденциальных данных, которые в ней хранятся, включая ключи API, и без него база данных не сможет восстановить эти данные.

Прежде чем продолжить: убедитесь, что APP_KEY строка сохраняется где-то за пределами этого сервера. Чтобы проверить это, выполните команду grep APP_KEY /var/www/pterodactyl/.env и скопируйте эту строку в менеджер паролей, поскольку в случае потери ключа все зашифрованные данные в резервной копии станут недоступны для чтения.

Настройка среды

Остальную часть занимают три команды ремесленников .env файл. Каждая из них задаёт вопросы в интерактивном режиме при запуске без параметров, а также принимает ответы в качестве параметров. Ниже приведены значения, используемые в данном руководстве:

php artisan p:environment:setup \
  [email protected] \
  --url=https://panel.example.com \
  --timezone=Europe/Paris \
  --cache=redis --session=redis --queue=redis \
  --redis-host=127.0.0.1 --redis-port=6379 \
  --settings-ui=true

php artisan p:environment:database \
  --host=127.0.0.1 --port=3306 \
  --database=panel --username=pterodactyl --password=yourPassword

Этот --url Это значение - адрес, который вы введете в браузере, и он должен совпадать с доменом, на который указывает данный компьютер. Часовой пояс имеет большее значение, чем может показаться, поскольку панель управления оценивает расписания именно в этом поясе: задача, запланированная на 04:00, запускается в 04:00 в Europe/Paris, а в Части 4 это используется для резервного копирования. Начиная с версии 1.11 панель также отправляет анонимные данные о использовании, и PTERODACTYL_TELEMETRY_ENABLED строка в .env выключите его, если хотите.

Третья команда, php artisan p:environment:mail, содержит инструкции по настройке отправки уведомлений по электронной почте, связанных с учетной записью и сервером. Выберите протокол SMTP, указав данные вашего провайдера, или драйвер журнала на время тестирования.

Если панель выдает сообщения об ошибках, касающихся smtp.example.com После того как вы выберете другой почтовый драйвер, откройте /var/www/pterodactyl/.env и сравнить MAIL_MAILER с выбранным вами драйвером, поскольку команда может привести к MAIL_MAILER=smtp установлено. Установите его в положение log или ваш настоящий транспорт это исправит, и php artisan config:clear применяет изменение.

Создание таблиц и назначение первого администратора

Следующая команда создаёт таблицы базы данных и загружает «гнёзда» и «яйца» по умолчанию - шаблоны, которые указывают Pterodactyl, как установить и запустить каждую игру. При новой установке процесс завершается за несколько секунд, и его ни в коем случае нельзя прерывать:

php artisan migrate --seed --force

Затем создайте учётную запись администратора. В командной строке потребуется указать адрес электронной почты, имя пользователя, имя и фамилию, а также ответить на вопрос о том, является ли пользователь администратором, и ввести пароль длиной не менее восьми символов, содержащий буквы в верхнем и нижнем регистре и цифру. На вопрос об администраторе для этой первой учётной записи ответьте «да»:

php artisan p:user:make

Наконец, передайте файлы пользователю, под правами которого работает веб-сервер, а именно www-data в Ubuntu:

chown -R www-data:www-data /var/www/pterodactyl/*

Запустить фоновые процессы

Панель выполняет часть своей работы вне рамок веб-запросов: отправляет электронные письма, уведомляет о завершении установки сервера и запускает задания по расписанию. Это обеспечивается двумя факторами. Во-первых, это запись в crontab, которая запускает планировщик каждую минуту. Откройте корневой файл crontab с помощью команды crontab -e и добавьте следующую строку:

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Второй - это процесс обработки очереди, который работает в качестве службы systemd. Создайте /etc/systemd/system/pteroq.service со следующим содержанием:

[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

Включите Redis и рабочий процесс, чтобы оба сохранялись после перезагрузки:

systemctl enable --now redis-server
systemctl enable --now pteroq.service

Как только серверы будут созданы, journalctl -u pteroq показывает, как работник выполняет задания, например, ServerInstalled уведомление каждый раз, когда сервер завершает установку. Обычно панель выглядит нормально, но установки так и не отправляют отчеты именно из-за того, что рабочий процесс не запущен.

Предоставить доступ к панели через HTTPS

Страница входа в систему ни в коем случае не должна передаваться по простому HTTP, и узел, который вы добавите в следующем разделе, также должен использовать HTTPS во всех случаях, когда это делает панель. Сначала настройте запись DNS для домена вашей панели, указывающую на этот сервер, а затем получите сертификат. Проект руководство по сертификатам Описывается Certbot с использованием плагина для Nginx, автономный режим, а также проверка через DNS для компьютеров, на которых невозможно открыть порт 80. Плагин для Nginx выглядит следующим образом:

apt install -y certbot python3-certbot-nginx
certbot certonly --nginx -d panel.example.com

Certbot сохраняет сертификат в папке /etc/letsencrypt/live/panel.example.com/, папка, на которую указывает приведенный ниже файл nginx. Удалите сайт по умолчанию, а затем создайте /etc/nginx/sites-available/pterodactyl.conf из официального шаблона, заменив каждое <domain> с доменом вашей панели:

server {
    listen 80;
    server_name <domain>;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name <domain>;

    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/<domain>/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/<domain>/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;
    }
}

Приведенный ниже код представляет собой официальный шаблон, из которого удалены строки с комментариями, поэтому страница настройки веб-сервера останется эталонным, даже если в новой версии он изменится. Включите сайт и перезапустите nginx:

rm /etc/nginx/sites-enabled/default
ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf
nginx -t
systemctl restart nginx

Этот nginx -t Программа line проверяет синтаксис перед перезапуском, поэтому опечатка не может привести к сбою веб-сервера. Открыть https://panel.example.com в браузере, используя собственный домен, после чего появится экран входа в систему Pterodactyl.

Страница входа в систему Pterodactyl с полями для ввода имени пользователя и пароля, а также талисманом Pterodactyl
Страница входа в новую панель управления, доступная по протоколу HTTPS с указанного выше сайта nginx.

Если в форме входа отображается ошибка, связанная с тем, что экземпляр reCAPTCHA не был отображен, откройте /var/www/pterodactyl/.env и добавить RECAPTCHA_ENABLED=false в отдельной строке, а затем выполните php artisan config:clear. Вы можете настроить собственные ключи reCAPTCHA позже в разделе «Настройки» → «Дополнительные» в панели администратора.

Войдите в систему с помощью созданной ранее учетной записи администратора. У новой учетной записи нет серверов, поэтому на панели управления отображается соответствующее сообщение, и на данный момент это нормальное состояние.

После первого входа в систему на панели управления Pterodactyl появляется сообщение о том, что с учетной записью не связано ни одного сервера
Панель управления сразу после первого входа в систему - пустая, так как серверов пока нет.

Панель администратора находится всего в одном клике от личного кабинета пользователя, по адресу /admin на вашем домене. На странице обзора указана версия панели управления (на момент написания статьи - 1.15.1) и подтверждается, что панель обновлена до последней версии. Все последующие разделы доступны через боковую панель этой страницы: «Местоположения», «Узлы», «Серверы», «Гнезда» и «Пользователи».

Обзор административной панели Pterodactyl, на котором показана версия панели 1.15.1 и левая боковая панель с разделами «Локации», «Узлы», «Серверы», «Пользователи» и «Гнезда»
Обзор панели администратора с разделами в боковой панели, которые используются в остальной части данного руководства.

В заключение

  • Для работы панели требуются PHP 8.3, MariaDB, Redis и nginx - все эти компоненты доступны в Ubuntu 24.04.
  • Этот APP_KEY в .env шифрует секретные данные панели, поэтому обязательно необходимо иметь их копию, хранящуюся в другом месте.
  • Запись в cron и pteroq расписания запусков служб и уведомления - без них панель выглядит не так хорошо.
  • HTTPS-сертификат и официальный шаблон nginx позволяют разместить страницу входа на вашем собственном домене.

В следующем разделе вы установите Wings, зарегистрируете его в качестве узла на этой панели и укажете адреса, которые он будет распределять.