Pterodactyl Wings: Node hinzufügen, Allocations und Ihr erster Server

Wings ist der Pterodactyl-Dienst, der Gameserver in Docker-Containern auf Ihrem Server betreibt. Wir installieren ihn, verbinden ihn mit dem Panel, öffnen die nötigen Ports und erstellen den ersten Server.

So funktioniert es#

Das Panel ist nur eine Weboberfläche. Die eigentliche Arbeit erledigt Wings auf einer Node (dem Server, auf dem die Spiele laufen). Wings nimmt Anweisungen vom Panel entgegen, lädt Docker-Images herunter, betreibt Gameserver in isolierten Containern, überwacht ihren RAM und ihre Festplatte und kümmert sich um Konsole und Dateien.

Wichtig ist, wer sich wohin verbindet:

Gameserver erhalten das interne Docker-Netzwerk pterodactyl_nw. Auf dem VPS erscheint eine Netzwerkschnittstelle pterodactyl0 mit der Adresse 172.18.0.1; über sie erreichen Container den Server selbst (das nutzen Sie für den Database Host). Serverdaten liegen in /var/lib/pterodactyl/volumes.

Virtualisierung prüfen#

Wings braucht Docker, und Docker braucht vollständige Virtualisierung. StormHost-VPS laufen auf KVM, was funktioniert. Prüfen können Sie es mit:

systemd-detect-virt

kvm

Ein Ergebnis openvz oder lxc würde bedeuten, dass Docker (und damit Wings) höchstwahrscheinlich nicht funktioniert.

Docker installieren#

Installieren Sie Docker aus dem offiziellen Repository von Docker. Jeder Befehl ist in der Anleitung Docker und Docker Compose ausführlich erklärt; hier nur die Schritte:

Aktivieren Sie Docker dann beim Booten und testen Sie es:

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

• systemctl enable --now docker – Docker startet sofort und danach bei jedem Booten des VPS.
• docker run --rm hello-world – lädt einen Testcontainer herunter und führt ihn aus; --rm löscht ihn nach dem Ende. Sie sehen den Text Hello from Docker!.

Wings herunterladen#

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 – ein Verzeichnis für die Wings-Konfiguration.
• curl -L -o /usr/local/bin/wings "…" – lädt das neueste Wings-Release als Programm /usr/local/bin/wings herunter. -L folgt den Weiterleitungen von GitHub.
• $([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64") – wählt die passende Datei für die CPU-Architektur: uname -m gibt x86_64 aus (typische Server), wofür der Build amd64 heruntergeladen wird.
• chmod u+x – erlaubt dem Besitzer (root), die Datei auszuführen.

Prüfung: wings version gibt die Versionsnummer aus.

Domain und Zertifikat für die Node#

Das Panel läuft auf HTTPS, also muss auch Wings HTTPS verwenden. Sonst würde der Browser die Verbindung zur Node blockieren. Das Zertifikat ist an die Domain der Node gebunden (Feld FQDN im Panel).

Nach einer Zertifikatserneuerung muss Wings neu gestartet werden, sonst verwendet es weiterhin das alte Zertifikat. Erstellen Sie einen Deploy-Hook (ein Skript, das Certbot nach jeder erfolgreichen Erneuerung ausführt):

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 führt Dateien im Verzeichnis renewal-hooks/deploy nach jeder Zertifikatserneuerung aus.
• systemctl restart wings – startet Wings neu. Laufende Gameserver werden dadurch nicht gestoppt; Wings verbindet sich nach dem Start wieder mit ihnen.
• chmod 755 – das Skript muss ausführbar sein.

Location#

Jede Node gehört zu einer Location. Eine Location ist nur eine Bezeichnung zum Sortieren von Nodes (zum Beispiel nach Rechenzentrum).

1. Öffnen Sie im Panel den Admin-Bereich (Zahnradsymbol oben rechts) und klicken Sie links auf Locations.
2. Klicken Sie auf Create New.
3. Füllen Sie Short Code aus, eine kurze Kennung mit 1–⁠60 Zeichen, zum Beispiel cz-praha.
4. Füllen Sie Description aus, eine Beschreibung der Location für Sie und andere Admins, zum Beispiel VPS in Prag.
5. Klicken Sie auf Create.

Die Node im Panel#

Klicken Sie im Admin-Bereich links auf Nodes und dann auf Create New. Füllen Sie das Formular gemäß der Tabelle aus:

Klicken Sie auf Create Node. Das Panel öffnet die Details der Node.

Wings konfigurieren#

Öffnen Sie in den Details der Node die Registerkarte Configuration. Die Konfiguration bekommen Sie auf eine von zwei Arten auf den VPS.

Methode A, automatisch: Klicken Sie auf Generate Token. Das Panel zeigt einen Befehl, der mit cd /etc/pterodactyl && sudo wings configure --panel-url https://panel.example.cz --token … beginnt. Kopieren Sie ihn vollständig und führen Sie ihn auf dem Node-VPS aus. Wings lädt seine Konfiguration vom Panel herunter.

Methode B, manuell:

1. Öffnen Sie auf dem VPS die Datei:

   nano /etc/pterodactyl/config.yml

2. Fügen Sie den gesamten Block aus der Registerkarte Configuration ein, speichern Sie (Strg+O, Eingabe) und schließen Sie (Strg+X).

Was in der Konfiguration steht:

Beim ersten Start ergänzt Wings in der Datei weitere Standardwerte, zum Beispiel die Einstellungen des Docker-Netzwerks (docker.network, Adresse 172.18.0.1) und DNS-Server für Container (1.1.1.1, 1.0.0.1).

Erster Start im Debug-Modus#

Bevor Sie es im Hintergrund laufen lassen, probieren Sie Wings von Hand, damit Sie eventuelle Fehler sehen:

wings --debug

• --debug – ein ausführliches Log von allem, was Wings tut.

Beim ersten Start erstellt Wings das Docker-Netzwerk (creating missing pterodactyl0 interface…) und meldet, dass es lauscht (configuring internal webserver). Öffnen Sie dann im Panel Nodes. Die Node zeigt ein grünes pulsierendes Herz = das Panel hat sich mit Wings verbunden. Ein rotes Herz bedeutet, dass die Verbindung nicht funktioniert (siehe Fehlerbehebung).

Sobald das Herz grün ist, stoppen Sie Wings mit Strg+C.

Wings als Dienst#

Damit Wings dauerhaft läuft und nach einem Neustart des VPS automatisch startet, erstellen Sie einen systemd-Dienst:

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

Aktivieren und starten Sie den Dienst:

systemctl enable --now wings
systemctl status wings

Sie sehen Active: active (running). Das Herz der Node im Panel bleibt grün.

Allocations#

Eine Allocation ist eine Kombination aus IP-Adresse und Port, die ein Gameserver erhält. Jeder Server braucht mindestens eine (die primäre); weitere können Sie für RCON, Query oder Plugins hinzufügen.

1. Ermitteln Sie die öffentliche IPv4-⁠Adresse des VPS. Sie finden sie im Kundenbereich in der Registerkarte Netzwerk, oder dieser Befehl gibt sie aus:

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

   • hostname -I – gibt alle IP-Adressen des VPS aus; awk '{print $1}' nimmt die erste.

2. Öffnen Sie in den Details der Node die Registerkarte Allocation.

3. Füllen Sie rechts unter Assign New Allocations die Felder gemäß der Tabelle aus und klicken Sie auf Submit.

Typische Standardports: Minecraft Java 25565, Rust 28015 (und 28016 für RCON), FiveM 30120. Für mehrere Server desselben Spiels fügen Sie einen Bereich hinzu; jeder Server erhält einen anderen Port.

Firewall#

Öffnen Sie die Ports in der Firewall im Kundenbereich (Anleitung: Firewall im Kundenbereich). Steht eingehender Verkehr auf Alles blockieren außer Erlaubtem, fügen Sie Regeln Eingehend · Erlauben hinzu:

Verwenden Sie UFW auf dem VPS, erlauben Sie darin API und SFTP:

ufw allow 8080/tcp
ufw allow 2022/tcp

Spielports müssen Sie in UFW nicht erlauben. Docker veröffentlicht Container-Ports mit eigenen Regeln, die UFW umgehen (Details in der Anleitung Firewall UFW). Beschränken Sie Spielports also mit der Firewall im Kundenbereich; sie sitzt vor dem VPS und gilt für alles.

Erster Server#

1. Klicken Sie im Admin-Bereich auf Servers und dann auf Create New.
2. Füllen Sie das Formular gemäß der Tabelle aus und klicken Sie unten auf Create Server.

3. Wings lädt das Docker-Image herunter und startet die Installation. Verfolgen Sie den Fortschritt in der Serverkonsole: Klicken Sie oben links auf den Panel-Namen (das bringt Sie vom Admin-Bereich zur Serverübersicht) und öffnen Sie den neuen Server. Gehört der Server einem anderen Benutzer, schalten Sie in der Übersicht den Umschalter Showing your servers auf Showing others' servers.
4. Bei Minecraft erscheint nach dem ersten Start ein Fenster Accept Minecraft® EULA. Ein Klick auf I Accept bedeutet, dass Sie den Minecraft-Lizenzbedingungen zustimmen, und der Server startet.

Überprüfung#

• Die Node unter Nodes zeigt ein grünes Herz.
• Nach der Installation läuft der Server, und Sie sehen seine Ausgabe in der Konsole (bei Minecraft die Zeile Done (…)! For help, type "help").
• Im Spiel können Sie sich mit 203.0.113.10:25565 (oder dem IP Alias) verbinden.
• Per SFTP können Sie sich mit der Adresse der Node und Port 2022 verbinden (zum Beispiel sftp://panel.example.cz:2022). Adresse und Benutzername finden Sie in der Registerkarte Settings des Servers unter SFTP Details (Server Address, Username). Das Passwort ist dasselbe wie Ihr Panel-Passwort.

Prüfung auf dem VPS:

systemctl is-active docker wings
docker ps

• docker ps – listet laufende Container auf; jeder Gameserver ist ein Container.

Wings aktualisieren#

Aktualisieren Sie Wings immer nach dem Aktualisieren des Panels (Panel-Schritte):

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 – stoppt Wings, damit das Programm überschrieben werden kann. Laufende Gameserver sind nicht betroffen.
• curl … und chmod … – dasselbe wie bei der Installation; sie laden die neueste Version herunter.
• systemctl restart wings – startet die neue Version; offene Verbindungen verbinden sich von selbst neu.

Fehlerbehebung#

Rotes Herz bei der Node#

Das Panel konnte Wings nicht erreichen. Gehen Sie die Ursachen von der häufigsten an durch:

1. Läuft Wings? systemctl status wings. Falls nicht, führen Sie wings --debug aus und lesen Sie den Fehler.
2. Ist Port 8080 in der Firewall des Kundenbereichs und in UFW offen?
3. Zeigt der FQDN der Node auf die richtige IP? getent hosts node.example.cz.
4. Funktioniert das Zertifikat? Führen Sie auf dem Panel-VPS curl https://node.example.cz:8080 aus. Die Antwort {"error":"The required authorization heads were not present in the request."} ist in Ordnung: Wings antwortet, Sie haben nur keinen Anmelde-Token gesendet. Ein Zertifikatsfehler (SSL certificate problem) bedeutet ein falsches oder abgelaufenes Zertifikat.
5. Läuft die Domain der Node über den Cloudflare-Proxy (orangefarbene Wolke)? Schalten Sie sie auf DNS only.
6. Passt config.yml zu dem, was die Registerkarte Configuration im Panel zeigt? Das Löschen und Neuanlegen einer Node ändert den Token.
7. Prüfen Sie, dass keine Browser-Erweiterung wie AdBlock die Verbindung blockiert.

failed to configure HTTPS server#

Wings hat das Zertifikat nicht gefunden. Die Ausgabe enthält meist auch no such file or directory mit einem Pfad. Der Pfad in config.yml (api.ssl.cert) muss zu dem Zertifikat passen, das Sie haben (certbot certificates). Haben Sie den FQDN der Node geändert, holen Sie auch ein Zertifikat für die neue Domain.

address already in use#

Port 8080 oder 2022 wird bereits von einem anderen Programm verwendet. Finden Sie heraus, von welchem:

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

• ss -tulpn – listet lauschende Ports (TCP und UDP) und die Programme auf, die sie halten.

Verschieben Sie das Programm woandershin oder ändern Sie den Daemon Port in den Node-Einstellungen, kopieren Sie die neue Konfiguration und starten Sie Wings neu.

Die Serverkonsole verbindet sich nicht#

Der Browser zeigt Failed to connect to websocket instance after multiple attempts: try refreshing the page. Der Browser konnte FQDN:8080 nicht erreichen. Die Ursachen sind dieselben wie beim roten Herz, aber Port 8080 muss auch von Ihrem Computer aus funktionieren, nicht nur vom Panel. Öffnen Sie https://node.example.cz:8080 in Ihrem Browser. Lädt die Seite nicht, liegt das Problem bei Firewall, DNS oder Zertifikat.

Die Serverinstallation scheitert beim Herunterladen#

Die Installationskonsole zeigt Meldungen wie Could not resolve host. Die Container haben kein funktionierendes DNS. Standardmäßig gibt Wings ihnen die Server 1.1.1.1 und 1.0.0.1. Ermitteln Sie die DNS-Server des VPS mit resolvectl status (die Zeilen DNS Servers) oder, falls der Befehl unter Debian nicht existiert, in /etc/resolv.conf (die Zeilen nameserver). Tragen Sie sie in /etc/pterodactyl/config.yml anstelle der Standardwerte ein (unter docker: › network: › dns:). Verwenden Sie nicht 127.0.0.53; es funktioniert nur auf dem VPS selbst, nicht in einem Container. Starten Sie Wings dann neu: systemctl restart wings.

Der Server wird nicht erstellt, das Panel meldet zu wenig Platz oder Speicher#

Der gesamte RAM oder die Festplatte der Server würde Total Memory oder Total Disk Space der Node überschreiten. Erhöhen Sie die Werte in den Node-Einstellungen (Registerkarte Settings), wenn der VPS die Kapazität wirklich hat, oder senken Sie die Limits der Server.

Der Server schaltet sich nach einer Weile selbst ab#

Er hat sein Festplattenlimit überschritten (Wings stoppt ihn sicher) oder die Konsole mit Ausgabe geflutet (Flood-Schutz). Prüfen Sie im Panel die Festplattennutzung des Servers und die Konsolenausgabe vor dem Herunterfahren.

Weiterführende Links#

• Pterodactyl: Installing Wings (öffnet sich in einem neuen Fenster)
• Pterodactyl: Upgrading Wings (öffnet sich in einem neuen Fenster)
• Pterodactyl: Wings Additional Configuration (öffnet sich in einem neuen Fenster)
• Pterodactyl: Creating a New Node (öffnet sich in einem neuen Fenster)
• Pterodactyl: Creating SSL Certificates (öffnet sich in einem neuen Fenster)
• Cloudflare: Netzwerkports (öffnet sich in einem neuen Fenster)