Установка Wings и запуск первого сервера

Проверено с: Wings v1.13.3, Panel v1.15.1, Ubuntu 22.04 и 24.04 · обновлено 09.10.2026

Короткий ответ: Wings — это Go-демон, который ставится на сервер с Docker и управляет игровыми контейнерами по командам Panel. Установка: Docker → бинарник wings → нода в панели (конфиг config.yml или auto-deploy токен) → SSL → systemd → аллокации портов → первый сервер. Если Panel у вас уже стоит, дальше — 15–20 минут до запущенного Minecraft-сервера.

Требования к ноде: Linux с полноценной виртуализацией (см. выбор VPS), root-доступ. Работает и на отдельном сервере, и рядом с Panel.

Шаг 1. Docker

Wings управляет контейнерами через Docker daemon:

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

Частые ошибки шага

• На VPS с OpenVZ/LXC установка упадёт или Docker не запустится — проверьте systemd-detect-virt заранее.
• Некоторые хостеры ставят модифицированные ядра: если uname -r заканчивается на -grs-ipv6-64 или -mod-std-ipv6-64, Docker будет работать криво — такое ядро надо менять у хостера.

Шаг 2. Лимиты свопа

Чтобы Docker умел ограничивать память контейнеров корректно, ядру нужен флаг swapaccount=1. Проверьте, нужен ли он вам:

uname -r                    # ядро 6.1+ — своп-лимиты включены, пропустите шаг
docker info 2>/dev/null | grep -i 'no swap limit support'   # пусто — всё в порядке

Если предупреждение есть — в /etc/default/grub добавьте swapaccount=1 в GRUB_CMDLINE_LINUX_DEFAULT, затем:

update-grub && reboot

Шаг 3. Бинарник 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

Шаг 4. Нода в Panel

В веб-интерфейсе Panel: Admin → Nodes → Create New. Ключевые поля:

• Name — любое имя ноды;
• FQDN — домен или IP ноды (Panel будет ходить сюда по 8080);
• Behind NAT — отметьте, если нода за NAT (см. выбор VPS);
• остальные порты оставьте стандартными: daemon 8080, SFTP 2022.

После сохранения откройте ноду → вкладка Configuration. Два способа отдать конфиг Wings:

1. Скопируйте содержимое блока в /etc/pterodactyl/config.yml на ноде;
2. или нажмите Generate Token и выполните готовую bash-команду на ноде — она сама скачает и положит конфиг (токен живёт недолго).

Заметка

Данные ноды (папка серверов, лимиты одновременных сборок и т.п.) можно править позже прямо в config.yml — справочник параметров официальной документации.

Шаг 5. SSL-сертификат ноды

Если Panel работает по HTTPS (а с шага прошлого гайда так и есть), нода тоже должна отдавать HTTPS. Варианты:

• Let’s Encrypt на FQDN ноды — если у ноды домен и открытые 80/443;
• самоподписанный сертификат — достаточно для теста и связки Panel↔Wings:

mkdir -p /etc/pterodactyl/certs
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 \
  -keyout /etc/pterodactyl/certs/node.key \
  -out /etc/pterodactyl/certs/node.crt

Пути к сертификату указываются в config.yml (блок api.ssl).

Шаг 6. Первый запуск (отладка)

Запустите Wings вручную и посмотрите лог:

wings --debug

Если нода успешно подключилась к Panel, в логе появится информация о серверах (пока пустая) и слушающие порты 8080/2022. Прервите по Ctrl+C и переходите к systemd.

Частые ошибки шага

Ошибки подключения к панели почти всегда одно из трёх:

• SSL — сертификат из шага 5 не создан или пути в config.yml неверны;
• FQDN — Panel не может разрешить/достучаться до ноды: проверьте curl https://panel.example.com с ноды и доступность 8080 снаружи;
• токен/конфиг — config.yml устарел: перегенерируйте на вкладке Configuration.

Шаг 7. Systemd-сервис

/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

systemctl enable --now wings

Не забудьте файрвол:

ufw allow 8080/tcp      # API Panel ↔ Wings
ufw allow 2022/tcp      # SFTP
ufw allow 25565:25585/tcp   # ваш диапазон аллокаций

Шаг 8. Аллокации

Аллокация = IP:порт, который получит игровой сервер. Узнайте IP ноды:

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

В Panel: Admin → Nodes → ваша нода → Allocation → добавьте IP и диапазон портов, например 25565–25585.

Нода за NAT

За NAT в аллокации указывается внутренний IP ноды, а снаружи игроки подключаются на проброшенные хостером порты. Не используйте 127.0.0.1.

Шаг 9. Первый сервер

В Panel: Servers → Create Server:

1. Владелец — ваш пользователь; нода — только что созданная.
2. Nest/Egg — Minecraft → нужное яйцо (Paper, Vanilla, Forge…). Если нужного нет — яйца импортируются из community-репозитория через Admin → Nests.
3. Аллокация — выберите порт из добавленных.
4. Лимиты — RAM/диск по возможностям ноды (ориентиры — в гайде по выбору VPS). CPU-лимит 0 значит «без лимита» — для чужих серверов так делать не стоит.
5. Docker-образ оставьте предложенный яйцом, переменные (версия, память) — по желанию.
6. Отметьте Start server when installed и создайте.

Сервер пройдёт установку (яйцо скачает файлы игры — в первый раз это минуты), затем стартует. Откройте его консоль в Panel и убедитесь, что Minecraft поднялся; подключитесь клиентом на ip:порт аллокации.

Частые ошибки шага

• Сервер висит в «Installing» — смотрите лог на странице сервера: обычно нода не может скачать файлы игры (нет интернета на ноде или медленное зеркало).
• Нода «offline» в списке — возвращайтесь к шагу 6: SSL/FQDN/файрвол. Диагностика на ноде: journalctl -u wings -n 50.
• Игроки не подключаются — порт аллокации не открыт в файрволе или не проброшен у хостера.

Что дальше

• Атака крашера — почему диск ноды может заполниться за секунды и что сделать заранее.
• DiskGuard: установка — 5 минут, чтобы дисковая атака не положила все серверы.

Нужен VPS под Pterodactyl?

Серверы Xipher в России. Старт продаж — декабрь 2026: первые 100 мест из листа ожидания получат лучшие условия на старт.

В лист ожидания