Pterodactyl Wings: pridanie nodu, alokácie a prvý server

Wings je služba Pterodactylu, ktorá na serveri spúšťa herné servery v kontajneroch Dockeru. Nainštalujeme ju, prepojíme s Panelom, otvoríme potrebné porty a založíme prvý server.

Ako to funguje#

Panel je iba webové rozhranie. Skutočnú prácu robí Wings na node (serveri, na ktorom bežia hry). Wings prijíma pokyny od Panelu, sťahuje obrazy Dockeru, spúšťa herné servery v izolovaných kontajneroch, stráži ich RAM a disk a sprostredkúva konzolu a súbory.

Dôležité je, kto sa kam pripája:

Herné servery dostanú vnútornú sieť Dockeru pterodactyl_nw. Na VPS sa objaví sieťové rozhranie pterodactyl0 s adresou 172.18.0.1, cez ktorú kontajnery vidia samotný server (to využijete pri databázovom hostiteľovi). Dáta serverov ležia v priečinku /var/lib/pterodactyl/volumes.

Kontrola virtualizácie#

Wings potrebuje Docker a Docker potrebuje plnohodnotnú virtualizáciu. VPS u StormHostu beží na KVM, ktoré vyhovuje. Overiť to môžete príkazom:

systemd-detect-virt

kvm

Výsledky openvz alebo lxc by znamenali, že Docker (a teda Wings) najskôr fungovať nebude.

Inštalácia Dockeru#

Docker nainštalujte z oficiálneho repozitára Dockeru. Každý príkaz je podrobne vysvetlený v návode Docker a Docker Compose, tu je iba stručný postup:

Potom zapnite Docker po štarte a overte ho:

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

• systemctl enable --now docker – Docker sa spustí hneď a potom pri každom štarte VPS.
• docker run --rm hello-world – stiahne a spustí testovací kontajner; --rm ho po skončení zmaže. Uvidíte text Hello from Docker!.

Stiahnutie 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 – priečinok pre konfiguráciu Wings.
• curl -L -o /usr/local/bin/wings "…" – stiahne najnovšie vydanie Wings ako program /usr/local/bin/wings. -L nasleduje presmerovania GitHubu.
• $([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64") – vyberie správny súbor podľa architektúry procesora: uname -m vypíše x86_64 (bežné servery), pre ktorý sa stiahne verzia amd64.
• chmod u+x – povolí vlastníkovi (root) súbor spúšťať.

Overenie: wings version vypíše číslo verzie.

Doména a certifikát pre nod#

Panel beží na HTTPS, preto musí HTTPS používať aj Wings. Prehliadač by inak spojenie s nodom zablokoval. Certifikát je viazaný na doménu nodu (v Paneli pole FQDN).

Po obnove certifikátu je potrebné Wings reštartovať, inak by ďalej používal starý certifikát. Vytvorte deploy hook (skript, ktorý Certbot spustí po každej úspešnej obnove):

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

• Súbor v priečinku renewal-hooks/deploy Certbot spustí po každej obnove certifikátu.
• systemctl restart wings – reštartuje Wings. Bežiace herné servery tým nevypnete, Wings sa k nim po štarte znova pripojí.
• chmod 755 – skript musí byť spustiteľný.

Lokácie#

Každý nod patrí do lokácie. Lokácia je iba štítok na triedenie nodov (napríklad podľa dátového centra).

1. V Paneli otvorte administráciu (ikona ozubeného kolesa vpravo hore) a vľavo kliknite na Locations.
2. Kliknite na Create New.
3. Vyplňte Short Code, krátky identifikátor 1–⁠60 znakov, napríklad cz-praha.
4. Vyplňte Description, opis lokácie pre vás a ďalších administrátorov, napríklad VPS v Prahe.
5. Kliknite na Create.

Nod v Paneli#

V administrácii kliknite vľavo na Nodes a potom na Create New. Formulár vyplňte podľa tabuľky:

Kliknite na Create Node. Panel otvorí detail nodu.

Konfigurácia Wings#

V detaile nodu otvorte záložku Configuration. Konfiguráciu do VPS dostanete jedným z dvoch spôsobov.

Spôsob A, automaticky: Kliknite na Generate Token. Panel zobrazí príkaz začínajúci cd /etc/pterodactyl && sudo wings configure --panel-url https://panel.example.cz --token …. Skopírujte ho celý a spustite na VPS nodu. Wings si konfiguráciu stiahne z Panelu.

Spôsob B, ručne:

1. Na VPS otvorte súbor:

   nano /etc/pterodactyl/config.yml

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

Čo v konfigurácii je:

Pri prvom spustení Wings do súboru doplní ďalšie predvolené hodnoty, napríklad nastavenie siete Dockeru (docker.network, adresa 172.18.0.1) a DNS servery pre kontajnery (1.1.1.1, 1.0.0.1).

Prvé spustenie v režime ladenia#

Pred spustením na pozadí vyskúšajte Wings ručne, aby ste videli prípadné chyby:

wings --debug

• --debug – podrobný výpis všetkého, čo Wings robí.

Pri prvom štarte Wings vytvorí sieť Dockeru (creating missing pterodactyl0 interface…) a vypíše, že počúva (configuring internal webserver). Potom v Paneli otvorte Nodes. Pri node sa zobrazí zelené pulzujúce srdce = Panel sa s Wings spojil. Červené srdce znamená, že spojenie nefunguje (pozri Keď niečo nefunguje).

Keď je srdce zelené, ukončite Wings klávesmi Ctrl+C.

Wings ako služba#

Aby Wings bežal trvalo a po reštarte VPS sa spustil sám, vytvorte 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

Zapnite a spustite službu:

systemctl enable --now wings
systemctl status wings

Uvidíte Active: active (running). Srdce pri node v Paneli zostane zelené.

Alokácie#

Alokácia je kombinácia IP adresy a portu, ktorú dostane herný server. Každý server potrebuje aspoň jednu (hlavnú), ďalšie môžete pridať pre RCON, query alebo pluginy.

1. Zistite verejnú IPv4 adresu VPS. Nájdete ju v zákazníckom účte v záložke Sieť, alebo ju vypíše:

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

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

2. V detaile nodu otvorte záložku Allocation.

3. Vpravo v časti Assign New Allocations vyplňte polia podľa tabuľky a kliknite na Submit.

Typické predvolené porty: Minecraft Java 25565, Rust 28015 (a 28016 pre RCON), FiveM 30120. Pre viac serverov rovnakej hry pridajte rozsah, každý server dostane iný port.

Firewall#

Otvorte porty vo firewalle v zákazníckom účte (návod: Firewall v zákazníckom účte). Ak máte prichádzajúcu prevádzku v režime Blokovať všetko okrem povoleného, pridajte pravidlá Prichádzajúce · Povoliť:

Ak vo VPS používate UFW, povoľte v ňom API a SFTP:

ufw allow 8080/tcp
ufw allow 2022/tcp

Herné porty v UFW povoľovať nemusíte. Docker zverejňuje porty kontajnerov vlastnými pravidlami, ktoré UFW obchádzajú (podrobnosti v návode Firewall UFW). Herné porty preto obmedzujte firewallom v zákazníckom účte, ten stojí pred VPS a platí pre všetko.

Prvý server#

1. V administrácii kliknite na Servers a potom na Create New.
2. Vyplňte formulár podľa tabuľky a dole kliknite na Create Server.

3. Wings stiahne obraz Dockeru a spustí inštaláciu. Priebeh sledujte v konzole servera: kliknite vľavo hore na názov Panelu (prejdete z administrácie na prehľad serverov) a otvorte nový server. Ak server patrí inému používateľovi, prepnite na prehľade prepínač Showing your servers na Showing others' servers.
4. Pri Minecrafte sa po prvom štarte objaví okno Accept Minecraft® EULA. Kliknutím na I Accept súhlasíte s licenčnými podmienkami Minecraftu a server sa spustí.

Overenie#

• Pri node v Nodes svieti zelené srdce.
• Server po inštalácii beží a v konzole vidíte jeho výpis (pri Minecrafte riadok Done (…)! For help, type "help").
• V hre sa pripojíte na 203.0.113.10:25565 (alebo na IP Alias).
• Cez SFTP sa pripojíte na adresu nodu a port 2022 (napríklad sftp://panel.example.cz:2022). Adresu a používateľské meno nájdete pri serveri v záložke Settings v časti SFTP Details (Server Address, Username). Heslo je rovnaké ako heslo k Panelu.

Kontrola na VPS:

systemctl is-active docker wings
docker ps

• docker ps – vypíše bežiace kontajnery; každý herný server je jeden kontajner.

Aktualizácia Wings#

Aktualizujte Wings vždy po aktualizácii Panelu (postup pre 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 sa program dal prepísať. Bežiace herné servery to neovplyvní.
• curl … a chmod … – rovnaké ako pri inštalácii, stiahnu najnovšiu verziu.
• systemctl restart wings – spustí novú verziu; otvorené spojenia sa obnovia samy.

Keď niečo nefunguje#

Červené srdce pri node#

Panel sa k Wings nedostal. Postupujte od najčastejšej príčiny:

1. Beží Wings? systemctl status wings. Keď nie, spustite wings --debug a prečítajte si chybu.
2. Je port 8080 otvorený vo firewalle zákazníckeho účtu a v UFW?
3. Ukazuje FQDN nodu na správnu IP? getent hosts node.example.cz.
4. Funguje certifikát? Na VPS s Panelom spustite curl https://node.example.cz:8080. Odpoveď {"error":"The required authorization heads were not present in the request."} je v poriadku: Wings odpovedá, iba ste neposlali prihlasovací token. Chyba certifikátu (SSL certificate problem) znamená nesprávny alebo prešlý certifikát.
5. Nebeží doména nodu cez proxy Cloudflare (oranžový obláčik)? Prepnite ju na DNS only.
6. Sedí config.yml s tým, čo ukazuje záložka Configuration v Paneli? Po zmazaní a novom vytvorení nodu sa token mení.
7. Skontrolujte, že spojenie neblokuje doplnok prehliadača typu AdBlock.

failed to configure HTTPS server#

Wings nenašiel certifikát. Vo výpise býva aj no such file or directory s cestou. Cesta v config.yml (api.ssl.cert) musí zodpovedať certifikátu, ktorý máte (certbot certificates). Ak ste FQDN nodu zmenili, získajte certifikát aj pre novú doménu.

address already in use#

Port 8080 alebo 2022 už používa iný program. Zistite ktorý:

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

• ss -tulpn – vypíše počúvajúce porty (TCP aj UDP) a programy, ktoré ich držia.

Program presuňte inam, alebo v nastavení nodu zmeňte Daemon Port, skopírujte novú konfiguráciu a reštartujte Wings.

Konzola servera sa nepripojí#

V prehliadači sa ukáže Failed to connect to websocket instance after multiple attempts: try refreshing the page. Prehliadač sa nedostal na FQDN:8080. Príčiny sú rovnaké ako pri červenom srdci, navyše musí port 8080 fungovať z vášho počítača, nie iba z Panelu. Otvorte v prehliadači https://node.example.cz:8080. Ak sa stránka nedá načítať, je problém vo firewalle, DNS alebo certifikáte.

Inštalácia servera zlyhá na sťahovaní#

V konzole inštalácie sú hlásenia ako Could not resolve host. Kontajnery nemajú funkčné DNS. Wings im v predvolenom stave dáva servery 1.1.1.1 a 1.0.0.1. Zistite DNS servery VPS príkazom resolvectl status (riadky DNS Servers), a ak príkaz na Debiane neexistuje, v súbore /etc/resolv.conf (riadky nameserver). Zapíšte ich do /etc/pterodactyl/config.yml namiesto predvolených (v časti docker: › network: › dns:). Adresu 127.0.0.53 nepoužívajte, tá funguje iba na samotnom VPS, nie v kontajneri. Potom reštartujte Wings: systemctl restart wings.

Server sa nevytvorí, Panel hlási nedostatok miesta alebo pamäte#

Súčet RAM alebo disku serverov by prekročil Total Memory alebo Total Disk Space nodu. Zvýšte hodnoty v nastavení nodu (záložka Settings), ak na to VPS skutočne má, alebo serverom limity znížte.

Server sa po chvíli sám vypne#

Prekročil limit disku (Wings ho bezpečne zastaví) alebo sa zahltil výpisom do konzoly (ochrana proti zahlteniu). Skontrolujte miesto v Paneli pri serveri a výpis konzoly pred vypnutím.

Ďalšie zdroje#

• Pterodactyl: Installing Wings (otvorí sa v novom okne)
• Pterodactyl: Upgrading Wings (otvorí sa v novom okne)
• Pterodactyl: Wings Additional Configuration (otvorí sa v novom okne)
• Pterodactyl: Creating a New Node (otvorí sa v novom okne)
• Pterodactyl: Creating SSL Certificates (otvorí sa v novom okne)
• Cloudflare: Network ports (otvorí sa v novom okne)