Pterodactyl Wings: dodanie węzła, alokacje i pierwszy serwer

Wings to usługa Pterodactyla, która uruchamia serwery gier w kontenerach Dockera na Twoim serwerze. Zainstalujemy ją, połączymy z Panelem, otworzymy potrzebne porty i utworzymy pierwszy serwer.

Jak to działa#

Panel to tylko interfejs WWW. Prawdziwą pracę wykonuje Wings na węźle (serwerze, na którym działają gry). Wings przyjmuje polecenia z Panelu, pobiera obrazy Dockera, uruchamia serwery gier w izolowanych kontenerach, pilnuje ich RAM i dysku oraz obsługuje konsolę i pliki.

Istotne jest, kto gdzie się łączy:

Serwery gier dostają wewnętrzną sieć Dockera pterodactyl_nw. Na VPS pojawia się interfejs sieciowy pterodactyl0 z adresem 172.18.0.1; kontenery docierają przez niego do samego serwera (użyjesz tego przy database hoście). Dane serwerów leżą w /var/lib/pterodactyl/volumes.

Sprawdzenie wirtualizacji#

Wings potrzebuje Dockera, a Docker pełnej wirtualizacji. VPS StormHost działają na KVM, który się nadaje. Sprawdzisz to przez:

systemd-detect-virt

kvm

Wynik openvz lub lxc oznaczałby, że Docker (a więc i Wings) najprawdopodobniej nie zadziała.

Instalacja Dockera#

Zainstaluj Dockera z oficjalnego repozytorium Dockera. Każde polecenie szczegółowo objaśnia poradnik Docker i Docker Compose; tutaj tylko kroki:

Następnie włącz Dockera przy starcie i go przetestuj:

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

• systemctl enable --now docker – Docker startuje od razu, a potem przy każdym uruchomieniu VPS.
• docker run --rm hello-world – pobiera i uruchamia kontener testowy; --rm usuwa go po zakończeniu. Zobaczysz tekst Hello from Docker!.

Pobieranie 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 – katalog na konfigurację Wings.
• curl -L -o /usr/local/bin/wings "…" – pobiera najnowsze wydanie Wings jako program /usr/local/bin/wings. -L podąża za przekierowaniami GitHuba.
• $([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64") – wybiera właściwy plik dla architektury CPU: uname -m wypisuje x86_64 (typowe serwery), dla którego pobierany jest build amd64.
• chmod u+x – pozwala właścicielowi (root) uruchamiać plik.

Kontrola: wings version wypisuje numer wersji.

Domena i certyfikat dla węzła#

Panel działa na HTTPS, więc Wings także musi używać HTTPS. Inaczej przeglądarka zablokowałaby połączenie z węzłem. Certyfikat jest powiązany z domeną węzła (pole FQDN w Panelu).

Po odnowieniu certyfikatu Wings trzeba zrestartować, inaczej używa dalej starego certyfikatu. Utwórz deploy hook (skrypt, który Certbot uruchamia po każdym udanym odnowieniu):

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

• Certbot uruchamia pliki z katalogu renewal-hooks/deploy po każdym odnowieniu certyfikatu.
• systemctl restart wings – restartuje Wings. Nie zatrzymuje to działających serwerów gier; Wings po starcie łączy się z nimi ponownie.
• chmod 755 – skrypt musi być wykonywalny.

Lokalizacja#

Każdy węzeł należy do lokalizacji. Lokalizacja to tylko etykieta do porządkowania węzłów (na przykład według centrum danych).

1. W Panelu otwórz część administracyjną (ikona koła zębatego w prawym górnym rogu) i kliknij Locations po lewej.
2. Kliknij Create New.
3. Wypełnij Short Code, krótki identyfikator o długości 1–⁠60 znaków, na przykład cz-praha.
4. Wypełnij Description, opis lokalizacji dla Ciebie i innych adminów, na przykład VPS w Pradze.
5. Kliknij Create.

Węzeł w Panelu#

W części administracyjnej kliknij Nodes po lewej, a potem Create New. Wypełnij formularz według tabeli:

Kliknij Create Node. Panel otworzy szczegóły węzła.

Konfiguracja Wings#

W szczegółach węzła otwórz zakładkę Configuration. Konfigurację przeniesiesz na VPS na jeden z dwóch sposobów.

Sposób A, automatyczny: kliknij Generate Token. Panel pokaże polecenie zaczynające się od cd /etc/pterodactyl && sudo wings configure --panel-url https://panel.example.cz --token …. Skopiuj je w całości i uruchom na VPS węzła. Wings pobierze konfigurację z Panelu.

Sposób B, ręczny:

1. Na VPS otwórz plik:

   nano /etc/pterodactyl/config.yml

2. Wklej cały blok z zakładki Configuration, zapisz (Ctrl+O, Enter) i zamknij (Ctrl+X).

Co jest w konfiguracji:

Przy pierwszym starcie Wings dopisuje do pliku kolejne wartości domyślne, na przykład ustawienia sieci Dockera (docker.network, adres 172.18.0.1) i serwery DNS dla kontenerów (1.1.1.1, 1.0.0.1).

Pierwsze uruchomienie w trybie debugowania#

Zanim uruchomisz w tle, wypróbuj Wings ręcznie, aby widzieć ewentualne błędy:

wings --debug

• --debug – szczegółowy log wszystkiego, co robi Wings.

Przy pierwszym starcie Wings tworzy sieć Dockera (creating missing pterodactyl0 interface…) i zgłasza, że nasłuchuje (configuring internal webserver). Potem otwórz Nodes w Panelu. Węzeł pokazuje zielone pulsujące serce = Panel połączył się z Wings. Czerwone serce oznacza, że połączenie nie działa (zobacz Rozwiązywanie problemów).

Gdy serce jest zielone, zatrzymaj Wings przez Ctrl+C.

Wings jako usługa#

Aby Wings działał stale i startował automatycznie po restarcie VPS, utwórz usługę 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

Włącz i uruchom usługę:

systemctl enable --now wings
systemctl status wings

Zobaczysz Active: active (running). Serce węzła w Panelu pozostaje zielone.

Alokacje#

Alokacja to kombinacja adresu IP i portu, którą dostaje serwer gier. Każdy serwer potrzebuje co najmniej jednej (głównej); kolejne możesz dodać dla RCON, query lub pluginów.

1. Znajdź publiczny adres IPv4 VPS. Znajdziesz go w strefie klienta w zakładce Sieć albo wypisze go:

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

   • hostname -I – wypisuje wszystkie adresy IP VPS; awk '{print $1}' bierze pierwszy.

2. W szczegółach węzła otwórz zakładkę Allocation.

3. Po prawej w Assign New Allocations wypełnij pola według tabeli i kliknij Submit.

Typowe porty domyślne: Minecraft Java 25565, Rust 28015 (i 28016 dla RCON), FiveM 30120. Dla kilku serwerów tej samej gry dodaj zakres; każdy serwer dostaje inny port.

Firewall#

Otwórz porty w firewallu w strefie klienta (poradnik: Firewall w strefie klienta). Jeśli ruch przychodzący jest ustawiony na Blokuj wszystko poza dozwolonym, dodaj reguły Przychodzący · Zezwól:

Jeśli używasz UFW na VPS, zezwól w nim na API i SFTP:

ufw allow 8080/tcp
ufw allow 2022/tcp

Portów gier nie musisz zezwalać w UFW. Docker publikuje porty kontenerów własnymi regułami, które omijają UFW (szczegóły w poradniku Firewall UFW). Porty gier ograniczaj więc firewallem w strefie klienta; stoi przed VPS i dotyczy wszystkiego.

Pierwszy serwer#

1. W części administracyjnej kliknij Servers, a potem Create New.
2. Wypełnij formularz według tabeli i kliknij Create Server na dole.

3. Wings pobiera obraz Dockera i rozpoczyna instalację. Postęp śledź w konsoli serwera: kliknij nazwę Panelu w lewym górnym rogu (przenosi z części administracyjnej do przeglądu serwerów) i otwórz nowy serwer. Jeśli serwer należy do innego użytkownika, przełącz w przeglądzie przełącznik Showing your servers na Showing others' servers.
4. Przy Minecrafcie po pierwszym starcie pojawi się okno Accept Minecraft® EULA. Kliknięcie I Accept oznacza zgodę na warunki licencji Minecrafta i serwer startuje.

Weryfikacja#

• Węzeł w Nodes pokazuje zielone serce.
• Po instalacji serwer działa, a w konsoli widzisz jego wyjście (przy Minecrafcie linię Done (…)! For help, type "help").
• W grze możesz połączyć się z 203.0.113.10:25565 (albo z IP Alias).
• Przez SFTP możesz połączyć się z adresem węzła i portem 2022 (na przykład sftp://panel.example.cz:2022). Adres i nazwę użytkownika znajdziesz w zakładce Settings serwera w SFTP Details (Server Address, Username). Hasło jest takie samo jak do Panelu.

Kontrola na VPS:

systemctl is-active docker wings
docker ps

• docker ps – wypisuje działające kontenery; każdy serwer gier to jeden kontener.

Aktualizacja Wings#

Wings aktualizuj zawsze po aktualizacji Panelu (kroki dla Panelu):

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 – zatrzymuje Wings, aby dało się nadpisać program. Działające serwery gier nie są dotknięte.
• curl … i chmod … – to samo co przy instalacji; pobierają najnowszą wersję.
• systemctl restart wings – uruchamia nową wersję; otwarte połączenia łączą się ponownie same.

Rozwiązywanie problemów#

Czerwone serce przy węźle#

Panel nie mógł dotrzeć do Wings. Przejdź przyczyny od najczęstszych:

1. Czy Wings działa? systemctl status wings. Jeśli nie, uruchom wings --debug i przeczytaj błąd.
2. Czy port 8080 jest otwarty w firewallu strefy klienta i w UFW?
3. Czy FQDN węzła wskazuje na właściwe IP? getent hosts node.example.cz.
4. Czy certyfikat działa? Na VPS Panelu uruchom curl https://node.example.cz:8080. Odpowiedź {"error":"The required authorization heads were not present in the request."} jest w porządku: Wings odpowiada, tylko nie wysłano tokenu logowania. Błąd certyfikatu (SSL certificate problem) oznacza zły lub wygasły certyfikat.
5. Czy domena węzła przechodzi przez proxy Cloudflare (pomarańczowa chmurka)? Przełącz ją na DNS only.
6. Czy config.yml zgadza się z tym, co pokazuje zakładka Configuration w Panelu? Usunięcie i ponowne utworzenie węzła zmienia token.
7. Sprawdź, czy rozszerzenie przeglądarki, takie jak AdBlock, nie blokuje połączenia.

failed to configure HTTPS server#

Wings nie znalazł certyfikatu. Wyjście zwykle zawiera też no such file or directory ze ścieżką. Ścieżka w config.yml (api.ssl.cert) musi zgadzać się z posiadanym certyfikatem (certbot certificates). Jeśli zmieniono FQDN węzła, uzyskaj certyfikat także dla nowej domeny.

address already in use#

Port 8080 lub 2022 zajmuje już inny program. Ustal który:

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

• ss -tulpn – wypisuje nasłuchujące porty (TCP i UDP) i trzymające je programy.

Przenieś program gdzie indziej albo zmień Daemon Port w ustawieniach węzła, skopiuj nową konfigurację i zrestartuj Wings.

Konsola serwera się nie łączy#

Przeglądarka pokazuje Failed to connect to websocket instance after multiple attempts: try refreshing the page. Przeglądarka nie mogła dotrzeć do FQDN:8080. Przyczyny są takie same jak przy czerwonym sercu, ale port 8080 musi działać też z Twojego komputera, nie tylko z Panelu. Otwórz w przeglądarce https://node.example.cz:8080. Jeśli strona się nie ładuje, problem jest w firewallu, DNS lub certyfikacie.

Instalacja serwera nie udaje się przy pobieraniu#

Konsola instalacji pokazuje komunikaty typu Could not resolve host. Kontenery nie mają działającego DNS. Domyślnie Wings daje im serwery 1.1.1.1 i 1.0.0.1. Serwery DNS VPS znajdziesz przez resolvectl status (linie DNS Servers) albo, jeśli polecenie nie istnieje na Debianie, w /etc/resolv.conf (linie nameserver). Wpisz je do /etc/pterodactyl/config.yml w miejsce domyślnych (w docker: › network: › dns:). Nie używaj 127.0.0.53; działa tylko na samym VPS, nie w kontenerze. Potem zrestartuj Wings: systemctl restart wings.

Serwer nie powstaje, Panel zgłasza brak miejsca lub pamięci#

Łączna RAM lub dysk serwerów przekroczyłyby Total Memory lub Total Disk Space węzła. Podnieś wartości w ustawieniach węzła (zakładka Settings), jeśli VPS naprawdę ma pojemność, albo obniż limity serwerów.

Serwer po chwili sam się wyłącza#

Przekroczył limit dysku (Wings bezpiecznie go zatrzymuje) albo zalał konsolę wyjściem (ochrona przed floodem). Sprawdź w Panelu zużycie dysku serwera i wyjście konsoli przed wyłączeniem.

Dalsza lektura#

• Pterodactyl: Installing Wings (otwiera się w nowym oknie)
• Pterodactyl: Upgrading Wings (otwiera się w nowym oknie)
• Pterodactyl: Wings Additional Configuration (otwiera się w nowym oknie)
• Pterodactyl: Creating a New Node (otwiera się w nowym oknie)
• Pterodactyl: Creating SSL Certificates (otwiera się w nowym oknie)
• Cloudflare: porty sieciowe (otwiera się w nowym oknie)