Instalace Wings a propojení nodu s Pterodactyl Panelem

Wings je démon napsaný v Go, který běží na každém nodu a spouští herní servery jako Docker kontejnery. Panel s ním komunikuje přes HTTP(S) API na portu 8080, hráči a správci se k souborům připojují přes vestavěný SFTP server na portu 2022. Wings může běžet na stejném stroji jako Panel i na úplně jiném serveru.

Předpokládáme, že Panel už máte nainstalovaný (viz Instalace Pterodactyl Panelu).

Požadavky na node

64bitový Linux s podporou Dockeru (Ubuntu, Debian, Rocky…).
Virtualizace typu KVM nebo dedikovaný stroj. Kontejnerové VPS (OpenVZ, LXC) Docker často neumí spustit vůbec nebo jen s omezeními.
Doména pro node (např. node1.example.cz), pokud chcete SSL – a to chcete, pokud Panel běží na HTTPS.

Typ virtualizace ověříte příkazem:

systemd-detect-virt

Výstup kvm nebo none (bare metal) je v pořádku, openvz či lxc je varovný signál.

1. Docker

Oficiální dokumentace používá instalační skript Dockeru:

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

2. Binárka Wings

sudo mkdir -p /etc/pterodactyl
sudo 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")"
sudo chmod u+x /usr/local/bin/wings

3. Lokace a node v Panelu

V administraci otevřete Locations a vytvořte lokaci (např. cz-praha).
V Nodes → Create New vyplňte: - FQDN – doména nodu (nebo IP, pokud nepoužíváte SSL), - Communicate Over SSL – „Use SSL Connection“, pokud má Panel HTTPS, - Total Memory / Disk – kolik zdrojů může Panel přidělit serverům, - Daemon Port 8080 a Daemon SFTP Port 2022 (výchozí hodnoty).
Po uložení přejděte na záložku Configuration.

4. Konfigurační soubor config.yml

Na záložce Configuration máte dvě možnosti:

zkopírovat zobrazený YAML do /etc/pterodactyl/config.yml,
nebo kliknout na Generate Token a spustit vygenerovaný příkaz přímo na nodu – ten soubor vytvoří sám.

Výsledný soubor vypadá zhruba takto (zkráceno):

debug: false
uuid: 1a2b3c4d-...
token_id: AbCdEf...
token: ...
api:
  host: 0.0.0.0
  port: 8080
  ssl:
    enabled: true
    cert: /etc/letsencrypt/live/node1.example.cz/fullchain.pem
    key: /etc/letsencrypt/live/node1.example.cz/privkey.pem
system:
  data: /var/lib/pterodactyl/volumes
  sftp:
    bind_port: 2022
remote: 'https://panel.example.cz'

Pokud zapínáte SSL, certifikát musí existovat dřív, než Wings spustíte. Postup najdete v článku SSL pro Panel i Wings.

5. První spuštění v debug režimu

sudo wings --debug

Wings vypisuje log přímo do terminálu. Hledejte chyby typu „failed to load configuration“ nebo problémy s certifikátem. Pokud vše běží, v Panelu u nodu uvidíte zelené srdíčko. Ukončete pomocí Ctrl+C.

6. Wings jako služba

Vytvořte /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

sudo systemctl daemon-reload
sudo systemctl enable --now wings
journalctl -u wings -f

7. Firewall

Na nodu musí být otevřené:

Port	Účel
8080/tcp	API Wings (Panel a websocket konzole z prohlížeče)
2022/tcp	SFTP
herní porty	podle alokací (např. 25565 TCP/UDP)

sudo ufw allow 8080/tcp
sudo ufw allow 2022/tcp
sudo ufw allow 25565

Pozor: na port 8080 se nepřipojuje jen Panel, ale i prohlížeč uživatele (konzole běží přes websocket přímo na Wings). Nestačí tedy povolit jen IP Panelu.

8. Alokace

Než vytvoříte první server, přidejte nodu alokace – kombinace IP a portu. Na záložce Allocation zadejte IP nodu a port nebo rozsah (25565-25575). Podrobnosti v článku Alokace a porty v Pterodactylu.

Kontrola, že vše funguje

systemctl is-active wings docker vrací dvakrát active.
V seznamu nodů je zelené srdíčko a zobrazená verze Wings.
Vytvoříte testovací server, nainstaluje se a v konzoli vidíte výstup.
Připojíte se přes SFTP: sftp -P 2022 [email protected] (přesné uživatelské jméno najdete v záložce Settings u serveru).

Pokud srdíčko zůstává červené, pokračujte článkem Řešení častých chyb Pterodactylu.