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

Установите Wings и добавьте узел

В предыдущем разделе вы вошли в рабочую панель - то есть в веб-интерфейс, за которым пока не стоит сервер. Чтобы запустить игру, сначала необходимо установить Wings на компьютер и зарегистрировать его в панели в качестве узла.

Установите Docker

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

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

Вторая строка запускает Docker сейчас и при каждой загрузке системы. На свежеустановленной Ubuntu 24.04 таким образом был установлен Docker версии 29.9.0, который docker --version подтверждает.

Требуются ли в Docker дополнительные настройки для ограничения объема свопа на сервере?

В последних версиях ядра это не работает. Учет использования свопа включен по умолчанию, начиная с ядра Linux версии 6.1, и uname -r отображает версию, которая в Ubuntu 24.04 составляла 6.8. На более старом ядре, docker info отпечатки WARNING: No swap limit support, и для устранения этой проблемы нужно добавить swapaccount=1 в GRUB_CMDLINE_LINUX_DEFAULT в /etc/default/grub, запустить update-grub, а затем перезагрузите компьютер.

Скачать «Wings»

Wings представляет собой один бинарный файл, поэтому для его установки достаточно скопировать файл и присвоить ему права на выполнение. Эти команды также создают /etc/pterodactyl, папка, из которой Wings считывает настройки:

mkdir -p /etc/pterodactyl
curl -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

Запустить wings version чтобы подтвердить загрузку. На момент написания статьи актуальной версией была v1.13.3, а версия панели, упомянутая в предыдущем разделе, - 1.15.1. На странице обновлений проекта указано, какие версии Wings соответствуют каким версиям панели, и, как правило, рекомендуется поддерживать обе версии в актуальном состоянии.

Создать местоположение и узел

На панели управления компьютеры сгруппированы по местоположениям и узлам. Местоположение - это обозначение места, например, центра обработки данных или города, а узел - это один компьютер, на котором работает Wings. В панели администратора откройте раздел «Местоположения» и выберите «Создать новый». Краткий код служит для идентификации местоположения в списках, а описание - это свободный текст.

Диалоговое окно «Создать местоположение» в админке Pterodactyl с шорткодом fr-par и заполненным описанием
Для местоположения достаточно короткого кода и описания.

Затем откройте раздел «Узлы» и выберите «Создать новый». Форма состоит из двух столбцов: левый содержит описание узла, а правый - настройки, определяющие, какую часть ресурсов компьютера может задействовать панель. Каждое поле будет иметь значение в дальнейшем, поэтому в следующем списке приведены те, по которым необходимо принять решение:

  • FQDN: доменное имя, которое используют панель и браузеры пользователей панели для доступа к Wings, например: node.example.com. Он должен указывать на этот сервер, и ему требуется собственный сертификат HTTPS, если панель использует протокол HTTPS.
  • Обмен данными по протоколу SSL: Оставьте HTTPS. Форма даже выводит предупреждение красным шрифтом, если панель использует HTTPS, а узел - нет, поскольку браузеры отказываются устанавливать соединение с консолью узла, работающего по простому HTTP.
  • Объём оперативной памяти и общий объём дискового пространства: объёмы памяти, которые панель может выделить серверам. Тестовая машина имеет 8 GiB, а узел заявляет 6144 MiB памяти, что оставляет место для операционной системы, панели и MariaDB. Дисковое пространство заявлено в объёме 30000 MiB на диске объёмом 40 ГБ.
  • Превышение лимита: 0 процентов означает, что комиссия отказывается создавать сервер, который привел бы к превышению лимита по суммарным показателям. Положительное значение процента позволяет обещать больше, чем имеется на самом деле, что возможно только в том случае, если серверы редко используют весь свой лимит.
  • Порт демона и порт SFTP: 8080 для API и 2022 для встроенной службы передачи файлов. Порт SFTP должен отличаться от порта собственной службы SSH данного компьютера.
Новая форма «Узел» в панели администрирования Pterodactyl с именем node-01, полным доменным именем (FQDN) node.example.com, включенным SSL, 6144 MiB оперативной памяти, 30000 MiB дискового пространства, портом демона 8080 и портом SFTP 2022
Форма создания узла со значениями, указанными в данном руководстве, готовая к нажатию кнопки «Создать узел».

При выборе пункта «Создать узел» открывается страница нового узла, причем курсор сразу перемещается на вкладку «Распределение».

Присвойте «Wings» сертификат и конфигурацию

Wings предоставляет собственный API по протоколу HTTPS, поэтому ему требуется сертификат для полного доменного имени (FQDN) узла - точно так же, как он был нужен панели управления. Настройте запись DNS для node.example.com на компьютере и запустите certbot для этого имени, как описано в предыдущем разделе:

certbot certonly --standalone -d node.example.com

Автономный режим самостоятельно отвечает на запрос на порту 80, поэтому остановите nginx на несколько секунд, пока это происходит, а затем запустите его снова. Сертификат попадает в /etc/letsencrypt/live/node.example.com/, папка «Wings» вот-вот будет указана для чтения.

Затем откройте узел на панели и перейдите на вкладку «Конфигурация». На этой вкладке отображается блок кода YAML, содержащий идентификационные данные узла. Скопируйте его в новый файл по адресу /etc/pterodactyl/config.yml. Кнопка «Генерировать токен» на той же вкладке выводит готовую команду, которая записывает файл за вас, а также на самой панели управления php artisan p:node:configuration 1 выводит тот же YAML-код для узла № 1. Файл выглядит следующим образом, причём вместо заполнителей должны стоять ваши собственные значения:

debug: false
uuid: 60b50825-9bd3-49de-bc36-7ce522db7046
token_id: <generated by the panel>
token: <generated by the panel>
api:
  host: 0.0.0.0
  port: 8080
  ssl:
    enabled: true
    cert: /etc/letsencrypt/live/node.example.com/fullchain.pem
    key: /etc/letsencrypt/live/node.example.com/privkey.pem
  upload_limit: 100
system:
  data: /var/lib/pterodactyl/volumes
  sftp:
    bind_port: 2022
allowed_mounts: []
remote: 'https://panel.example.com'

Обратите внимание на remote строка внизу: это собственный адрес панели, на который Wings отправляет запросы для подтверждения и сообщения о событиях. Этот token и token_id Эти строки содержат пароль узла, поэтому относитесь к этому файлу как к учетным данным и ни в коем случае не вставляйте его в чат или в заявку.

Запустить «Wings as a Service»

Сначала запустите Wings один раз в фоновом режиме. Программа выводит ошибки прямо в терминал, что является самым быстрым способом обнаружить опечатку в настройках:

wings --debug

Как только программа запустится без ошибок, остановите её с помощью Ctrl+C и создайте файл службы /etc/systemd/system/wings.service:

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

[Install]
WantedBy=multi-user.target

Затем перезагрузите systemd и запустите службу:

systemctl daemon-reload
systemctl enable --now wings
journalctl -u wings -n 20

При первом запуске Wings создает системного пользователя для файлов игры, а также сеть Docker с именем pterodactyl_nw, а также папки, расположенные в /var/lib/pterodactyl. В последних строках журнала упоминается SFTP-сервер, прослушивающий порт 2022, что свидетельствует о готовности демона. Вернувшись в панель управления, на вкладке «О узле» теперь отображаются версия демона и системная информация о компьютере, а в списке узлов в первом столбце появляется зелёное сердечко.

На вкладке «О программе» узла node-01 указаны следующие данные: версия демона v1.13.3, ядро Linux amd64 6.8.0-142-generic, 6 потоков ЦП, а также указано, что из 30 000 MiB дискового пространства и 6 144 MiB оперативной памяти выделено 0.
Вкладка «О программе» подтверждает, что панель может подключаться к Wings: на ней указаны версия демона и ядро компьютера.
Список узлов Pterodactyl, в котором узел node-01, расположенный в месте fr-par, показывает 6144 MiB оперативной памяти, 30000 MiB дискового пространства, отсутствие серверов, зеленый значок пульса и значок замка для SSL
Зелёное сердечко в списке узлов означает, что панель подключилась к Wings, а значок замка - что подключение произошло по протоколу HTTPS.

Если впоследствии при установке возникнет сбой с ошибкой Resolving timed out Как видно из журнала, контейнеры не могут использовать DNS-серверы, предоставленные им Wings. Открыть /etc/pterodactyl/config.yml, измените адреса в разделе docker.network.dns в свой собственный резолвер, остановите Wings, удалите pterodactyl_nw общаться с docker network rm pterodactyl_nw, а затем запустите Wings заново, чтобы программа пересоздала сеть с новыми настройками.

Создать распределения

Ассигнование - это IP-адрес и порт, которые панель управления может присвоить одному серверу. Каждому серверу требуется как минимум одно такое ассигнование, а панель управления предлагает только те адреса, которые вы указали здесь. Определите собственный адрес компьютера с помощью следующей команды:

hostname -I | awk '{print $1}'

Откройте вкладку «Распределение» узла и заполните форму справа. В поле «IP-адрес» указывается этот адрес, а в поле «Порты» - отдельные порты или диапазоны, разделенные запятыми или пробелами. Ни в коем случае не используйте 127.0.0.1 здесь, поскольку к контейнеру, опубликованному по адресу loopback, невозможно получить доступ из-за пределов компьютера.

В данном руководстве для серверов Minecraft используются диапазоны от 25565 до 25575, а для ботов - от 3000 до 3005; в одном из последующих разделов добавляется диапазон 7777 для Terraria. Более широкие диапазоны ничего не стоят, поскольку выделенный диапазон не используется, пока его не задействует какой-либо сервер.

Форма «Назначить новые выделения» с IP-адресом 10.0.2.15 и портами 25565–25575 и 3000–3005, введёнными в качестве тегов
В форме распределения можно указать сразу несколько диапазонов.

После отправки в таблице «Существующие назначения» отображаются все пары IP-адресов и портов - по одной строке на каждый порт - с пустым столбцом «Назначено».

Существующая таблица выделений на узле node-01, в которой перечислены порты с 3000 по 3005 и с 25565 по 25575 на адресе 10.0.2.15; зелёная полоса подтверждает, что выделения были добавлены
Каждая строка представляет собой одну пару IP-адреса и порта, на которую может претендовать будущий сервер.

Поле «IP-псевдоним» рядом с адресом является необязательным. Оно устанавливает псевдоним по умолчанию для этих адресов, что становится полезным после того, как вы присвоите каждому серверу доменное имя.

В заключение

  • Для работы Wings требуется Docker, загруженный бинарный файл и config.yml которая создаётся на вкладке «Конфигурация» этого узла.
  • Полное доменное имя (FQDN) узла должно иметь собственный сертификат HTTPS, если панель использует протокол HTTPS.
  • Зелёное сердечко в списке узлов и указание версии демона на вкладке «О программе» свидетельствуют о том, что панель и Wings взаимодействуют друг с другом.
  • Ассигнование представляет собой пару «IP-адрес и порт», и панель назначает только те пары, которые вы создали заранее.

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