Pterodactyl Wings: přidání nodu, alokace a první server

Wings je služba Pterodactylu, která na serveru spouští herní servery v kontejnerech Dockeru. Nainstalujeme ji, propojíme s Panelem, otevřeme potřebné porty a založíme první server.

Jak to funguje#

Panel je jen webové rozhraní. Skutečnou práci dělá Wings na nodu (serveru, na kterém běží hry). Wings přijímá pokyny od Panelu, stahuje obrazy Dockeru, spouští herní servery v izolovaných kontejnerech, hlídá jejich RAM a disk a zprostředkovává konzoli a soubory.

Důležité je, kdo se kam připojuje:

Herní servery dostanou vnitřní síť Dockeru pterodactyl_nw. Na VPS se objeví síťové rozhraní pterodactyl0 s adresou 172.18.0.1, přes kterou kontejnery vidí samotný server (to využijete u databázového hostitele). Data serverů leží ve složce /var/lib/pterodactyl/volumes.

Kontrola virtualizace#

Wings potřebuje Docker a Docker potřebuje plnohodnotnou virtualizaci. VPS u StormHostu běží na KVM, které vyhovuje. Ověřit to můžete příkazem:

systemd-detect-virt

kvm

Výsledky openvz nebo lxc by znamenaly, že Docker (a tedy Wings) nejspíš fungovat nebude.

Instalace Dockeru#

Docker nainstalujte z oficiálního repozitáře Dockeru. Každý příkaz je podrobně vysvětlený v návodu Docker a Docker Compose, tady je jen stručný postup:

Pak zapněte Docker po startu a ověřte ho:

systemctl enable --now docker
docker run --rm hello-world

• systemctl enable --now docker – Docker se spustí hned a pak při každém startu VPS.
• docker run --rm hello-world – stáhne a spustí testovací kontejner; --rm ho po skončení smaže. Uvidíte text Hello from Docker!.

Stažení 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

• mkdir -p /etc/pterodactyl – složka pro konfiguraci Wings.
• curl -L -o /usr/local/bin/wings "…" – stáhne nejnovější vydání Wings jako program /usr/local/bin/wings. -L následuje přesměrování GitHubu.
• $([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64") – vybere správný soubor podle architektury procesoru: uname -m vypíše x86_64 (běžné servery), pro který se stáhne verze amd64.
• chmod u+x – povolí vlastníkovi (root) soubor spouštět.

Ověření: wings version vypíše číslo verze.

Doména a certifikát pro nod#

Panel běží na HTTPS, proto musí HTTPS používat i Wings. Prohlížeč by jinak spojení s nodem zablokoval. Certifikát je vázaný na doménu nodu (v Panelu pole FQDN).

Po obnově certifikátu je potřeba Wings restartovat, jinak by dál používal starý certifikát. Vytvořte deploy hook (skript, který Certbot spustí po každé úspěšné obnově):

cat > /etc/letsencrypt/renewal-hooks/deploy/restart-wings.sh <<'EOF'
#!/bin/sh
systemctl restart wings
EOF
chmod 755 /etc/letsencrypt/renewal-hooks/deploy/restart-wings.sh

• Soubor ve složce renewal-hooks/deploy Certbot spustí po každé obnově certifikátu.
• systemctl restart wings – restartuje Wings. Běžící herní servery tím nevypnete, Wings se k nim po startu znovu připojí.
• chmod 755 – skript musí být spustitelný.

Lokace#

Každý nod patří do lokace. Lokace je jen štítek pro třídění nodů (například podle datacentra).

1. V Panelu otevřete administraci (ikona ozubeného kola vpravo nahoře) a vlevo klikněte na Locations.
2. Klikněte na Create New.
3. Vyplňte Short Code, krátký identifikátor 1–⁠60 znaků, například cz-praha.
4. Vyplňte Description, popis lokace pro vás a další administrátory, například VPS v Praze.
5. Klikněte na Create.

Nod v Panelu#

V administraci klikněte vlevo na Nodes a pak na Create New. Formulář vyplňte podle tabulky:

Klikněte na Create Node. Panel otevře detail nodu.

Konfigurace Wings#

V detailu nodu otevřete záložku Configuration. Konfiguraci do VPS dostanete jedním ze dvou způsobů.

Způsob A, automaticky: Klikněte na Generate Token. Panel zobrazí příkaz začínající cd /etc/pterodactyl && sudo wings configure --panel-url https://panel.example.cz --token …. Zkopírujte ho celý a spusťte na VPS nodu. Wings si konfiguraci stáhne z Panelu.

Způsob B, ručně:

1. Na VPS otevřete soubor:

   nano /etc/pterodactyl/config.yml

2. Vložte celý obsah bloku ze záložky Configuration, uložte (Ctrl+O, Enter) a zavřete (Ctrl+X).

Co v konfiguraci je:

Při prvním spuštění Wings do souboru doplní další výchozí hodnoty, například nastavení sítě Dockeru (docker.network, adresa 172.18.0.1) a DNS servery pro kontejnery (1.1.1.1, 1.0.0.1).

První spuštění v režimu ladění#

Před spuštěním na pozadí vyzkoušejte Wings ručně, ať vidíte případné chyby:

wings --debug

• --debug – podrobný výpis všeho, co Wings dělá.

Při prvním startu Wings vytvoří síť Dockeru (creating missing pterodactyl0 interface…) a vypíše, že poslouchá (configuring internal webserver). Pak v Panelu otevřete Nodes. U nodu se zobrazí zelené pulzující srdce = Panel se s Wings spojil. Červené srdce znamená, že spojení nefunguje (viz Když něco nefunguje).

Když je srdce zelené, ukončete Wings klávesami Ctrl+C.

Wings jako služba#

Aby Wings běžel trvale a po restartu VPS se spustil sám, vytvořte službu systemd:

nano /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

Zapněte a spusťte službu:

systemctl enable --now wings
systemctl status wings

Uvidíte Active: active (running). Srdce u nodu v Panelu zůstane zelené.

Alokace#

Alokace je kombinace IP adresy a portu, kterou dostane herní server. Každý server potřebuje aspoň jednu (hlavní), další můžete přidat pro RCON, query nebo pluginy.

1. Zjistěte veřejnou IPv4 adresu VPS. Najdete ji v zákaznické zóně v záložce Síť, nebo ji vypíše:

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

   • hostname -I – vypíše všechny IP adresy VPS; awk '{print $1}' z nich vezme první.

2. V detailu nodu otevřete záložku Allocation.

3. Vpravo v části Assign New Allocations vyplňte pole podle tabulky a klikněte na Submit.

Typické výchozí porty: Minecraft Java 25565, Rust 28015 (a 28016 pro RCON), FiveM 30120. Pro víc serverů stejné hry přidejte rozsah, každý server dostane jiný port.

Firewall#

Otevřete porty ve firewallu v zákaznické zóně (návod: Firewall v zákaznické zóně). Pokud máte příchozí provoz v režimu Blokovat vše kromě povoleného, přidejte pravidla Příchozí · Povolit:

Pokud ve VPS používáte UFW, povolte v něm API a SFTP:

ufw allow 8080/tcp
ufw allow 2022/tcp

Herní porty v UFW povolovat nemusíte. Docker zveřejňuje porty kontejnerů vlastními pravidly, která UFW obcházejí (podrobnosti v návodu Firewall UFW). Herní porty proto omezujte firewallem v zákaznické zóně, ten stojí před VPS a platí pro všechno.

První server#

1. V administraci klikněte na Servers a pak na Create New.
2. Vyplňte formulář podle tabulky a dole klikněte na Create Server.

3. Wings stáhne obraz Dockeru a spustí instalaci. Průběh sledujte v konzoli serveru: klikněte vlevo nahoře na název Panelu (přejdete z administrace na přehled serverů) a otevřete nový server. Pokud server patří jinému uživateli, přepněte na přehledu přepínač Showing your servers na Showing others' servers.
4. U Minecraftu se po prvním startu objeví okno Accept Minecraft® EULA. Kliknutím na I Accept souhlasíte s licenčními podmínkami Minecraftu a server se spustí.

Ověření#

• U nodu v Nodes svítí zelené srdce.
• Server po instalaci běží a v konzoli vidíte jeho výpis (u Minecraftu řádek Done (…)! For help, type "help").
• Ve hře se připojíte na 203.0.113.10:25565 (nebo na IP Alias).
• Přes SFTP se připojíte na adresu nodu a port 2022 (například sftp://panel.example.cz:2022). Adresu a uživatelské jméno najdete u serveru v záložce Settings v části SFTP Details (Server Address, Username). Heslo je stejné jako heslo k Panelu.

Kontrola na VPS:

systemctl is-active docker wings
docker ps

• docker ps – vypíše běžící kontejnery; každý herní server je jeden kontejner.

Aktualizace Wings#

Aktualizujte Wings vždy po aktualizaci Panelu (postup pro Panel):

systemctl stop wings
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
systemctl restart wings

• systemctl stop wings – zastaví Wings, aby šel program přepsat. Běžící herní servery to neovlivní.
• curl … a chmod … – stejné jako při instalaci, stáhnou nejnovější verzi.
• systemctl restart wings – spustí novou verzi; otevřená spojení se obnoví sama.

Když něco nefunguje#

Červené srdce u nodu#

Panel se k Wings nedostal. Postupujte od nejčastější příčiny:

1. Běží Wings? systemctl status wings. Když ne, spusťte wings --debug a přečtěte si chybu.
2. Je port 8080 otevřený ve firewallu zákaznické zóny a v UFW?
3. Ukazuje FQDN nodu na správnou IP? getent hosts node.example.cz.
4. Funguje certifikát? Na VPS s Panelem spusťte curl https://node.example.cz:8080. Odpověď {"error":"The required authorization heads were not present in the request."} je v pořádku: Wings odpovídá, jen jste neposlali přihlašovací token. Chyba certifikátu (SSL certificate problem) znamená špatný nebo prošlý certifikát.
5. Neběží doména nodu přes proxy Cloudflare (oranžový mráček)? Přepněte ji na DNS only.
6. Sedí config.yml s tím, co ukazuje záložka Configuration v Panelu? Po smazání a novém vytvoření nodu se token mění.
7. Zkontrolujte, že spojení neblokuje doplněk prohlížeče typu AdBlock.

failed to configure HTTPS server#

Wings nenašel certifikát. Ve výpisu bývá i no such file or directory s cestou. Cesta v config.yml (api.ssl.cert) musí odpovídat certifikátu, který máte (certbot certificates). Pokud jste FQDN nodu změnili, získejte certifikát i pro novou doménu.

address already in use#

Port 8080 nebo 2022 už používá jiný program. Zjistěte který:

ss -tulpn | grep -E ':8080|:2022'

• ss -tulpn – vypíše naslouchající porty (TCP i UDP) a programy, které je drží.

Program přesuňte jinam, nebo v nastavení nodu změňte Daemon Port, zkopírujte novou konfiguraci a restartujte Wings.

Konzole serveru se nepřipojí#

V prohlížeči se ukáže Failed to connect to websocket instance after multiple attempts: try refreshing the page. Prohlížeč se nedostal na FQDN:8080. Příčiny jsou stejné jako u červeného srdce, navíc musí port 8080 fungovat z vašeho počítače, ne jen z Panelu. Otevřete v prohlížeči https://node.example.cz:8080. Pokud stránka nejde načíst, je problém ve firewallu, DNS nebo certifikátu.

Instalace serveru selže na stahování#

V konzoli instalace jsou hlášky jako Could not resolve host. Kontejnery nemají funkční DNS. Wings jim ve výchozím stavu dává servery 1.1.1.1 a 1.0.0.1. Zjistěte DNS servery VPS příkazem resolvectl status (řádky DNS Servers), a pokud příkaz na Debianu neexistuje, v souboru /etc/resolv.conf (řádky nameserver). Zapište je do /etc/pterodactyl/config.yml místo výchozích (v části docker: › network: › dns:). Adresu 127.0.0.53 nepoužívejte, ta funguje jen na samotné VPS, ne v kontejneru. Pak restartujte Wings: systemctl restart wings.

Server se nevytvoří, Panel hlásí nedostatek místa nebo paměti#

Součet RAM nebo disku serverů by překročil Total Memory nebo Total Disk Space nodu. Zvyšte hodnoty v nastavení nodu (záložka Settings), pokud na to VPS skutečně má, nebo serverům limity snižte.

Server se po chvíli sám vypne#

Překročil limit disku (Wings ho bezpečně zastaví) nebo se zahltil výpisem do konzole (ochrana proti zahlcení). Zkontrolujte místo v Panelu u serveru a výpis konzole před vypnutím.

Další zdroje#

• Pterodactyl: Installing Wings (otevře se v novém okně)
• Pterodactyl: Upgrading Wings (otevře se v novém okně)
• Pterodactyl: Wings Additional Configuration (otevře se v novém okně)
• Pterodactyl: Creating a New Node (otevře se v novém okně)
• Pterodactyl: Creating SSL Certificates (otevře se v novém okně)
• Cloudflare: Network ports (otevře se v novém okně)