Pterodactyl installieren: vollständiger Leitfaden für das Panel und Wings

Pterodactyl ist eine Open-Source-Lösung, die das Hosting und die Verwaltung von Spiele-Servern vereinfacht. Seine intuitive Web-Oberfläche kommuniziert mit einem Dämon namens Wings, um Ihre Instanzen zu steuern. Dieser Leitfaden begleitet Sie durch die vollständige Installation: Panel, Wings und Node-Konfiguration.

Was Sie vor dem Start benötigen

Bereiten Sie Ihre Umgebung mit den folgenden Elementen vor:

Kompatibler Server

• Ubuntu 20.04, 22.04 oder 24.04
• Debian 10, 11 oder 12

Erforderlicher Zugriff

• Root-Zugriff oder Benutzer mit sudo-Rechten
• Grundlegende Pakete auf dem System installiert

Aktualisieren Sie zunächst Ihr System:

apt update && apt upgrade -y

Installieren Sie dann die erforderlichen Abhängigkeiten:

apt install sudo curl

Installation des Pterodactyl-Panels

⚠️ Warnung: Das Installations-Skript ist für den privaten Gebrauch geeignet. Für eine öffentliche Produktionsumgebung bevorzugen Sie eine manuelle Installation.

Führen Sie das Installations-Skript aus:

bash <(curl -s https://pterodactyl-installer.se)

Wählen Sie die Option 0 aus, um das Panel zu installieren:

* Eingabe 0-8: 0

Datenbankkonfiguration

Akzeptieren Sie die Installation von MariaDB:

Möchten Sie den MariaDB (MySQL)-Server auch auf dem Dämon installieren? (j/N): j

Lassen Sie die Datenbankfelder leer: Das Skript generiert automatisch ein sicheres Passwort.

Allgemeine Konfiguration

Legen Sie Ihre Zeitzone fest:

Wählen Sie die Zeitzone [Europe/Stockholm]: Europe/Paris

Geben Sie eine gültige E-Mail-Adresse für Benachrichtigungen ein:

Geben Sie die E-Mail-Adresse ein: [email protected]

Administrator-Konto erstellen

Füllen Sie die Informationen für das erste Konto aus:

E-Mail: [email protected]
Benutzername: admin
Vorname: Admin
Nachname: OuiHeberg
Passwort: *****

Domain und Sicherheit

Geben Sie die Domain ein, die auf Ihren VPS zeigt:

FQDN festlegen: panel.ouiheberg.com

Lehnen Sie die automatische Konfiguration der Firewall ab, um die Kontrolle zu behalten:

Möchten Sie die UFW (Firewall) automatisch konfigurieren? (j/N): n

Aktivieren Sie das SSL-Zertifikat über Let's Encrypt:

Möchten Sie HTTPS automatisch mit Let's Encrypt konfigurieren? (j/N): j
Ich stimme zu... (j/N): j

Bestätigen Sie die Installation:

Initiale Konfiguration abgeschlossen. Installation fortsetzen? (j/N): j
(Z)ustimmen/(A)bbrechen: a

✅ Das Panel ist betriebsbereit.

Installation des Wings-Dämons

Führen Sie das Installations-Skript erneut aus:

bash <(curl -s https://pterodactyl-installer.se)

Wählen Sie die Option 1 für Wings:

* Eingabe 0-8: 1

Wings-Konfiguration

Installieren Sie MariaDB nicht erneut, wenn bereits vorhanden:

Möchten Sie MariaDB... installieren (j/N): n

Behalten Sie die manuelle Firewall-Konfiguration bei:

Möchten Sie die UFW (Firewall) automatisch konfigurieren? (j/N): n

Konfigurieren Sie HTTPS, um die Kommunikation zu sichern:

Möchten Sie HTTPS automatisch konfigurieren... (j/N): j
FQDN festlegen: node.ouiheberg.com
Ich stimme zu... (j/N): j
E-Mail-Adresse eingeben: [email protected]
Installation fortsetzen? (j/N): j

✅ Wings ist bereit.

Node mit dem Panel verbinden

Melden Sie sich bei Ihrem Panel an (z. B. panel.ouiheberg.com).

Standort erstellen

Gehen Sie zu Standorte und fügen Sie einen neuen Standort hinzu. Der Name ist frei wählbar und dient zur Organisation Ihrer Nodes nach geografischer Zone oder Verwendungszweck.

Node hinzufügen

Klicken Sie in Nodes auf Neu erstellen und füllen Sie die Felder aus:

Parameter	Beschreibung
Name	Name zur Identifizierung des Nodes
FQDN	Domain oder IP des Wings-Servers
Verbindung	HTTPS bei aktiviertem SSL, ansonsten HTTP
Gesamtspeicher	Zugewiesener Speicher (z. B. 1024 für 1 GB)
Gesamter Festplattenspeicher	Verfügbarer Festplattenspeicher
Überbelegung	Zulässiger Prozentsatz der Überbelegung (0, wenn nicht gewünscht)

Verbindung abschließen

Nach der Erstellung öffnen Sie das Konfigurations-Tab des Nodes. Generieren Sie ein Token und kopieren Sie den angezeigten Befehl.

Führen Sie diesen Befehl auf Ihrem VPS über SSH aus und aktivieren Sie Wings:

systemctl enable --now wings
systemctl start wings

Häufige Probleme beheben

Symptom	Ursache	Lösung
Panel nicht erreichbar	DNS nicht korrekt propagiert oder falsche FQDN	DNS-Konfiguration überprüfen
Node getrennt	Ports durch Firewall blockiert	Ports 8080 und 2022 öffnen
Wings startet nicht	Ungültiges SSL-Zertifikat	Logs überprüfen: journalctl -u wings
Datenbankfehler	MariaDB inaktiv oder falsch konfiguriert	Überprüfen Sie: systemctl status mariadb
SSL-Fehler	Domain zeigt nicht auf den VPS	DNS-A-Eintrag korrigieren

Sicherheitsempfehlungen

Befolgen Sie diese bewährten Methoden für eine dauerhafte Installation:

• Verwenden Sie dedizierte Domainnamen für das Panel und jeden Node
• Aktivieren Sie immer HTTPS mit einem gültigen Zertifikat
• Halten Sie Ihr System aktuell: apt update && apt upgrade -y
• Erstellen Sie separate Benutzerkonten anstelle der täglichen Verwendung des Admin-Kontos
• Planen Sie regelmäßige Backups der Datenbank und Konfigurationsdateien

Zusammenfassung

Das Installations-Skript vereinfacht die Bereitstellung von Pterodactyl erheblich, aber eine sorgfältige Netzwerk- und SSL-Konfiguration bleibt unerlässlich. Durch die Anwendung dieses Leitfadens und der Sicherheitsempfehlungen verfügen Sie über eine solide Plattform zur Bereitstellung Ihrer Spiele-Server.