InfrawireInfrawire LogoDokumentation

Pterodactyl Panel via Skript installieren

Diese Anleitung zeigt Ihnen, wie Sie Pterodactyl Panel und Wings auf Ihrem VPS mit dem vereinfachten automatischen Installationsskript installieren. Pterodactyl ist ein kostenloses und quelloffenes Verwaltungspanel zur Verwaltung Ihrer Spieleserver (Minecraft, FiveM, usw.).

📋 Voraussetzungen

  • Ein VPS-Server mit Root-Zugriff
  • Mindestens 1 GB RAM (2 GB empfohlen)
  • Ubuntu 22.04/24.04, Debian 11/12/13, Rocky Linux 8/9 oder AlmaLinux 8/9
  • Eine Domain, die auf Ihre VPS-IP zeigt (optional, aber empfohlen)
  • Ports 80, 443, 2022 und 8080 offen (falls Sie eine Firewall verwenden)

Important: Pterodactyl benötigt einen sauberen Server. Es wird empfohlen, auf einem frisch installierten System zu installieren, um Konflikte zu vermeiden.

💡 Infrastruktur-Empfehlung

Pterodactyl Panel ist ideal für die Verwaltung ressourcenintensiver Spieleserver. Für optimale Leistung empfehlen wir unsere Performance VPS, die Hochleistungsprozessoren und DDR5-RAM bieten und perfekt für das gleichzeitige Hosting mehrerer Spieleserver (Minecraft, FiveM usw.) sind.

Info — Um die Installation von Pterodactyl (Panel und Wings) zu automatisieren, können Sie unser Pterodactyl-Hosting wählen.

🚀 Installation des Pterodactyl Panels

Servervorbereitung

Vor der Installation von Pterodactyl bereiten Sie Ihren Server vor:

Bash
1# System aktualisieren 2sudo apt update && sudo apt upgrade -y 3 4# Curl installieren, falls erforderlich 5sudo apt install curl -y 6 7# Überprüfen, dass Sie root sind oder sudo verwenden 8whoami

Installation über vereinfachtes Skript

Das automatische Installationsskript vereinfacht die Pterodactyl-Installation erheblich:

Bash
# Pterodactyl-Installationsskript starten bash <(curl -s https://pterodactyl-installer.se)

Das Skript führt Sie Schritt für Schritt durch die Installation:

  1. Installationstyp-Auswahl:

    • Panel-Installation (Pterodactyl Panel)
    • Wings-Installation (Daemon zur Serververwaltung)
    • Vollständige Installation (Panel + Wings)
  2. Systemkonfiguration:

    • Automatische Installation von Abhängigkeiten (PHP, MySQL, Nginx, usw.)
    • Datenbankkonfiguration
    • Webserver-Konfiguration (Nginx)
    • SSL-Konfiguration (Let's Encrypt)

Nur Panel-Installation

Wenn Sie nur das Panel installieren möchten (zur Serververwaltung):

Bash
1# Skript starten 2bash <(curl -s https://pterodactyl-installer.se) 3 4# Option "1" wählen, um das Panel zu installieren 5# Den Skriptanweisungen folgen

Vollständige Installation (Panel + Wings)

Um Panel und Wings auf demselben Server zu installieren:

Bash
1# Skript starten 2bash <(curl -s https://pterodactyl-installer.se) 3 4# Option "3" für vollständige Installation wählen 5# Den Skriptanweisungen folgen

⚙️ Panel-Konfiguration

Erste Konfiguration

Nach der Panel-Installation müssen Sie konfigurieren:

  1. Administratorkonto erstellen:

    • Das Skript fragt Sie nach der Erstellung des ersten Admin-Benutzers
    • Wählen Sie eine E-Mail und ein sicheres Passwort
  2. Datenbankkonfiguration:

    • Das Skript erstellt automatisch eine MySQL-Datenbank
    • Notieren Sie die Datenbank-Anmeldedaten
  3. Domain-Konfiguration:

    • Wenn Sie eine Domain haben, konfiguriert das Skript Nginx automatisch
    • Andernfalls können Sie über die Server-IP zugreifen

Auf Panel zugreifen

Sobald die Installation abgeschlossen ist, greifen Sie auf das Panel zu:

Bash
1# Wenn Sie eine Domain konfiguriert haben 2https://ihre-domain.com 3 4# Wenn Sie keine Domain haben 5http://IHRE_SERVER_IP

Important: Wenn Sie HTTP verwenden (ohne Domain), müssen Sie das selbstsignierte Zertifikat akzeptieren oder SSL manuell konfigurieren.

🛠️ Wings installieren (Daemon)

Wings ist der Daemon, der die Spieleserver tatsächlich verwaltet. Sie können ihn auf demselben Server wie das Panel oder auf einem separaten Server installieren.

Wings auf demselben Server installieren

Bash
1# Skript starten 2bash <(curl -s https://pterodactyl-installer.se) 3 4# Option "3" für vollständige Installation wählen 5# Oder Option "2", wenn Sie das Panel bereits installiert haben

Wings auf separatem Server installieren

Wenn Sie Wings auf einem anderen Server als dem Panel installieren:

Bash
1# Auf dem Server, auf dem Sie Wings installieren möchten 2bash <(curl -s https://pterodactyl-installer.se) 3 4# Option "2" wählen, um nur Wings zu installieren 5# Den Skriptanweisungen folgen

Wings-Konfiguration

Nach der Installation müssen Sie Wings konfigurieren:

  1. API-Schlüssel abrufen:

    • Melden Sie sich beim Panel an
    • Gehen Sie zu Administration → Konfiguration → Nodes
    • Erstellen Sie einen neuen Node oder verwenden Sie den vorhandenen
    • Kopieren Sie den API-Schlüssel und FQDN
  2. Wings konfigurieren:

    Bash
    1# Wings-Konfigurationsdatei bearbeiten 2sudo nano /etc/pterodactyl/config.yml 3 4# API-Schlüssel und FQDN vom Panel einfügen 5# Speichern und beenden (Strg+X, dann Y, dann Enter)
  3. Wings starten:

    Bash
    1# Wings-Dienst starten 2sudo systemctl start wings 3 4# Wings beim Booten aktivieren 5sudo systemctl enable wings 6 7# Status überprüfen 8sudo systemctl status wings

🔧 Firewall-Konfiguration (UFW)

Wenn Sie UFW verwenden, konfigurieren Sie die notwendigen Ports:

Bash
1# Ports für Pterodactyl Panel freigeben 2sudo ufw allow 80/tcp 3sudo ufw allow 443/tcp 4 5# Wings-Port freigeben (Standard 8080) 6sudo ufw allow 8080/tcp 7 8# Wings SFTP-Port freigeben (Standard 2022) 9sudo ufw allow 2022/tcp 10 11# Regeln überprüfen 12sudo ufw status

Important: Wenn Sie die Standardports von Wings ändern, vergessen Sie nicht, sie in der Firewall zu öffnen.

📝 Nachinstallation

Installation überprüfen

Bash
1# Überprüfen, dass das Panel funktioniert 2curl -I http://localhost 3 4# Überprüfen, dass Wings funktioniert 5sudo systemctl status wings 6 7# Wings-Logs prüfen 8sudo journalctl -u wings -f

Pterodactyl aktualisieren

Um Panel oder Wings zu aktualisieren:

Bash
1# Installationsskript erneut starten 2bash <(curl -s https://pterodactyl-installer.se) 3 4# Update-Option wählen 5# Das Skript erkennt die vorhandene Installation und bietet ein Update an

Nützliche Wings-Befehle

Bash
1# Wings neu starten 2sudo systemctl restart wings 3 4# Wings stoppen 5sudo systemctl stop wings 6 7# Logs in Echtzeit anzeigen 8sudo journalctl -u wings -f 9 10# Wings-Konfiguration ohne Neustart neu laden 11sudo wings --debug

🎮 Erstellen Sie Ihren ersten Server

Im Pterodactyl Panel

  1. Benutzer erstellen:

    • Gehen Sie zu Benutzer → Neuer Benutzer
    • Erstellen Sie ein Konto für sich selbst (falls noch nicht geschehen)
  2. Server erstellen:

    • Klicken Sie auf "Neuen Server erstellen"
    • Wählen Sie einen Node (Ihre Wings)
    • Wählen Sie ein Egg (Minecraft, FiveM, usw.)
    • Konfigurieren Sie Ressourcen (RAM, CPU, Festplatte)
    • Legen Sie Namen und Beschreibung fest
  3. Server starten:

    • Sobald erstellt, klicken Sie auf Ihren Server
    • Klicken Sie auf "Power" → "Start", um zu starten

✅ Überprüfung und Tests

Überprüfen, dass alles funktioniert

Bash
1# Panel überprüfen (sollte HTTP 200 zurückgeben) 2curl -I http://localhost 3 4# Wings überprüfen 5sudo systemctl status wings 6 7# Erforderliche Dienste überprüfen 8sudo systemctl status nginx 9sudo systemctl status mysql 10sudo systemctl status redis

Panel → Wings-Verbindung testen

Im Panel:

  1. Gehen Sie zu Administration → Nodes
  2. Überprüfen Sie, dass Ihr Node online ist (grüner Status)
  3. Wenn der Node offline ist, überprüfen Sie die Wings-Konfiguration

🆘 Fehlerbehebung

Panel wird nicht angezeigt

Bash
1# Überprüfen, dass Nginx funktioniert 2sudo systemctl status nginx 3 4# Nginx-Logs prüfen 5sudo tail -f /var/log/nginx/error.log 6 7# Nginx neu starten 8sudo systemctl restart nginx 9 10# Nginx-Konfiguration überprüfen 11sudo nginx -t

Wings startet nicht

Bash
1# Wings-Logs prüfen 2sudo journalctl -u wings -n 50 3 4# Konfigurationsdatei prüfen 5sudo nano /etc/pterodactyl/config.yml 6 7# Konfigurationssyntax überprüfen 8sudo wings --debug 9 10# Überprüfen, dass Port 8080 frei ist 11sudo netstat -tlnp | grep 8080

Panel → Wings-Verbindungsfehler

Bash
1# API-Schlüssel in config.yml überprüfen 2sudo cat /etc/pterodactyl/config.yml | grep -i "api\|token" 3 4# Überprüfen, dass FQDN korrekt ist 5sudo cat /etc/pterodactyl/config.yml | grep -i "remote" 6 7# Netzwerkverbindung überprüfen 8curl -I https://IHRE_PANEL_DOMAIN 9 10# Wings neu starten 11sudo systemctl restart wings

Datenbankproblem

Bash
1# Überprüfen, dass MySQL funktioniert 2sudo systemctl status mysql 3 4# Mit MySQL verbinden 5sudo mysql -u root -p 6 7# In MySQL Datenbanken auflisten 8SHOW DATABASES; 9 10# Überprüfen, dass pterodactyl-Datenbank existiert 11USE pterodactyl; 12SHOW TABLES;

SSL/HTTPS-Fehler

Wenn Sie Probleme mit SSL haben:

Bash
1# Certbot überprüfen 2sudo certbot --version 3 4# SSL-Zertifikat erneuern 5sudo certbot renew 6 7# Nginx SSL-Konfiguration überprüfen 8sudo nginx -t 9sudo systemctl reload nginx

📚 Zusätzliche Ressourcen

❓ Häufig gestellte Fragen

F: Kann ich Panel und Wings auf separaten Servern installieren?
A: Ja, es wird sogar für große Installationen empfohlen. Installieren Sie das Panel auf einem Server und Wings auf einem oder mehreren anderen Servern. Konfigurieren Sie dann Wings so, dass es über den API-Schlüssel mit dem Panel verbunden wird.

F: Was ist der Unterschied zwischen Panel und Wings?
A: Das Panel ist die Weboberfläche zur Verwaltung Ihrer Server. Wings ist der Daemon, der auf Spieleservern läuft und Docker-Container und Spieleserver tatsächlich verwaltet.

F: Kann ich Pterodactyl ohne Domain installieren?
A: Ja, Sie können Ihre Server-IP verwenden, aber Sie müssen SSL manuell konfigurieren oder ein selbstsigniertes Zertifikat akzeptieren. Es wird dringend empfohlen, eine Domain mit Let's Encrypt zu verwenden.

F: Installiert das Skript Docker automatisch?
A: Ja, das Skript installiert automatisch Docker und Docker Compose, die für Wings erforderlich sind.

F: Wie aktualisiere ich Pterodactyl nach der Installation?
A: Starten Sie das Installationsskript erneut. Es erkennt die vorhandene Installation und bietet ein Update an:

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

F: Kann ich einen anderen Webserver als Nginx verwenden?
A: Das Skript installiert automatisch Nginx. Sie können Apache verwenden, aber Sie müssen es nach der Installation manuell konfigurieren.

F: Wie viel RAM wird benötigt, um Pterodactyl zu installieren?
A: Mindestens 1 GB RAM, aber 2 GB werden empfohlen. Zur Verwaltung von Spieleservern benötigen Sie zusätzliches RAM abhängig von der Anzahl und Größe Ihrer Server.

F: Wie erstelle ich mehrere Spieleserver?
A: Sobald Panel und Wings konfiguriert sind, können Sie im Panel so viele Server erstellen, wie Sie möchten. Jeder Server verwendet einen Teil Ihrer Ressourcen (RAM, CPU, Festplatte).

F: Kann ich Pterodactyl für Server außer Spielen verwenden?
A: Ja, Pterodactyl kann jeden Docker-Container verwalten. Sie können es für Webanwendungen, Discord-Bots, usw. verwenden.