ACLClouds
ACLClouds

Pterodactyl: was es ist und wie man es auf einem VPS installiert

Das Pterodactyl-Panel und sein Daemon Wings erklärt, dann die komplette Installation auf einem Debian- oder Ubuntu-VPS: PHP, MariaDB, Redis, nginx

Pterodactyl ist hier nicht der Flugsaurier, sondern ein Open-Source-Panel, mit dem Sie Gameserver im Browser anlegen und verwalten. Diese Anleitung erklärt, wie es aufgebaut ist und welche Maschine es braucht, und installiert es dann Schritt für Schritt auf einem VPS mit Ubuntu 24.04: das Panel mit PHP 8.3, MariaDB, Redis und nginx, HTTPS mit certbot, danach Wings und Docker für die Server. Die Befehle folgen der offiziellen Pterodactyl-Dokumentation und werden als root ausgeführt.

  • Pterodactyl besteht aus zwei Programmen: dem Webpanel (PHP, MariaDB, Redis) und Wings, das jeden Gameserver in einem Docker-Container startet.
  • Sie brauchen einen KVM-VPS mit Ubuntu, Debian, Rocky oder AlmaLinux, eine Domain für HTTPS und 2 GB RAM für das Panel allein.
  • Läuft Wings auf derselben Maschine, ist der RAM-Bedarf der des Panels plus der jedes Gameservers.
  • Sichern Sie die Datei .env (APP_KEY), die Panel-Datenbank und die Server-Volumes außerhalb des VPS.

Was ist Pterodactyl?

Pterodactyl ist ein Panel zur Verwaltung von Gameservern unter MIT-Lizenz. Es besteht aus zwei Programmen: dem Panel, einer PHP-Webanwendung, die Konten, Server und Einstellungen speichert, und Wings, einem in Go geschriebenen Daemon, der jeden Gameserver in einem eigenen Docker-Container startet. Ein Panel kann mehrere Wings-Maschinen steuern, die sogenannten Nodes.

  • Das Panel: Weboberfläche, API, MariaDB- oder MySQL-Datenbank, Cache und Job-Queue in Redis.
  • Wings: Node-API standardmäßig auf Port 8080 und SFTP auf Port 2022, Docker-Container für die Server.
  • Eggs: Servervorlagen (Minecraft Paper, Rust, ARK, Bots und mehr), die das Docker-Image, die Installation und den Startbefehl festlegen.
  • Jeder Spieler oder Kunde erhält Zugriff auf seine Server: Konsole, Dateien, Backups, geplante Aufgaben und Unterbenutzer.

Voraussetzungen: System, RAM und Virtualisierung

Die offizielle Dokumentation unterstützt Ubuntu 22.04 und 24.04, Debian 11, 12 und 13 sowie Rocky Linux und AlmaLinux 8 und 9. Das Panel braucht PHP 8.2 oder 8.3, MariaDB ab 10.2 (oder MySQL ab 5.7.22), Redis, einen Webserver und Composer 2. Wings benötigt Docker und eine vollständige Virtualisierung: KVM funktioniert, OpenVZ und LXC machen fast immer Probleme.

  • Prüfen Sie die Virtualisierung mit systemd-detect-virt: Die Ausgabe darf weder openvz noch lxc enthalten. Die VPS von ACLClouds sind KVM-Maschinen.
  • RAM: Das Panel allein kommt mit 2 GB aus. Läuft Wings auf derselben Maschine, rechnen Sie den Speicher jedes Gameservers hinzu, zum Beispiel 4 GB für einen Minecraft-Paper-Server mit rund zehn Spielern.
  • Für HTTPS brauchen Sie einen Domainnamen, der auf die IP des VPS zeigt; eine kostenlose Subdomain unter aclclouds.online reicht aus.
  • Für das Panel und ein oder zwei kleine Server genügt der Tarif Mini (8 GB RAM, 2 vCPU); darüber hinaus bietet der Tarif Essentiel (16 GB, 4 vCPU) Reserven. Siehe Linux-VPS.

PHP, MariaDB, Redis und nginx installieren

Unter Ubuntu 24.04 kommt PHP 8.3 aus dem Repository ondrej/php. Aktualisieren Sie zuerst das System mit apt update && apt -y upgrade, dann installieren Sie die Abhängigkeiten und Composer. Für Debian hat die offizielle Dokumentation eine eigene Seite mit einem anderen PHP-Repository: Folgen Sie dort statt diesen Befehlen.

  • apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg
  • LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php && apt update
  • apt -y install php8.3 php8.3-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server
  • curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

Panel herunterladen und Datenbank anlegen

Das Panel wird aus dem Archiv der neuesten GitHub-Version nach /var/www/pterodactyl installiert. Legen Sie anschließend eine MariaDB-Datenbank und einen Benutzer an, den nur das Panel verwendet, mit einem langen, einmaligen Passwort.

  • mkdir -p /var/www/pterodactyl && cd /var/www/pterodactyl
  • curl -Lo panel.tar.gz https://github.com/pterodactyl/panel/releases/latest/download/panel.tar.gz && tar -xzvf panel.tar.gz && chmod -R 755 storage/* bootstrap/cache/
  • In mariadb -u root -p: CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'einmaligesPasswort'; CREATE DATABASE panel; GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1';
  • cp .env.example .env && COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
  • php artisan key:generate --force: Der APP_KEY verschlüsselt Daten des Panels. Kopieren Sie ihn vom Server weg, denn ohne ihn ist keine Wiederherstellung möglich.

Umgebung einrichten und Administrator anlegen

Drei interaktive Assistenten füllen die Datei .env: die Panel-Adresse und die Treiber für Cache, Sitzungen und Queue (wählen Sie Redis), dann die Datenbankverbindung, dann den E-Mail-Versand. Die Migration legt danach die Tabellen und die mitgelieferten Eggs an, und der letzte Befehl erstellt das erste Administratorkonto.

  • php artisan p:environment:setup, dann php artisan p:environment:database und php artisan p:environment:mail
  • php artisan migrate --seed --force: Nicht unterbrechen, der Import der Eggs dauert einen Moment.
  • php artisan p:user:make: Beantworten Sie die Administrator-Frage mit yes.
  • chown -R www-data:www-data /var/www/pterodactyl/*: Die Dateien gehören dem Benutzer des Webservers.

Cronjob und Queue-Worker aktivieren

Das Panel braucht einen Cronjob, der jede Minute läuft (Aufräumen, geplante Serveraufgaben), und einen Worker, der die Redis-Queue abarbeitet. Ohne Worker bleiben das Anlegen von Servern und der E-Mail-Versand hängen.

  • crontab -e, dann die Zeile: * * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1
  • Legen Sie /etc/systemd/system/pteroq.service an mit User=www-data, Group=www-data, Restart=always und ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
  • systemctl enable --now redis-server, dann systemctl enable --now pteroq.service

nginx und HTTPS mit certbot einrichten

Richten Sie zuerst einen A-Eintrag der Domain, zum Beispiel panel.example.com, auf die IPv4 des VPS ein. Holen Sie dann das Zertifikat mit dem nginx-Plugin von certbot und legen Sie den Serverblock des Panels nach der nginx-Vorlage mit SSL aus der offiziellen Dokumentation an: root /var/www/pterodactyl/public, PHP über den Socket von PHP-FPM 8.3 und die Pfade des erhaltenen Zertifikats.

  • apt -y install certbot python3-certbot-nginx, dann certbot certonly --nginx -d panel.example.com
  • In /etc/nginx/sites-available/pterodactyl.conf: server_name panel.example.com, ssl_certificate /etc/letsencrypt/live/panel.example.com/fullchain.pem und fastcgi_pass unix:/run/php/php8.3-fpm.sock.
  • rm /etc/nginx/sites-enabled/default, ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/, dann nginx -t && systemctl restart nginx
  • Die Verlängerung läuft automatisch über den certbot-Timer; testen Sie sie mit certbot renew --dry-run. Details stehen in der Anleitung zum kostenlosen HTTPS-Zertifikat.

Docker und Wings installieren, dann die Node verbinden

Wings kann auf demselben VPS wie das Panel oder auf einer anderen Maschine laufen. Installieren Sie Docker mit dem offiziellen Skript, dann das Wings-Binary. Legen Sie im Panel eine Location an, dann eine Node mit ihrem Domainnamen, der SSL-Option sowie dem freizugebenden Speicher und Festplattenplatz. Der Tab Configuration der Node zeigt den Inhalt von config.yml, den Sie nach /etc/pterodactyl kopieren.

  • curl -sSL https://get.docker.com/ | CHANNEL=stable bash && systemctl enable --now docker
  • mkdir -p /etc/pterodactyl && curl -L -o /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_amd64 && chmod u+x /usr/local/bin/wings
  • Starten Sie wings --debug einmal, um Fehler zu sehen, legen Sie dann den Dienst wings.service an (ExecStart=/usr/local/bin/wings, nach docker.service) und aktivieren Sie ihn mit systemctl enable --now wings.
  • Fügen Sie der Node Allocations hinzu: die öffentliche IP aus hostname -I, niemals 127.0.0.1, und einen Portbereich, zum Beispiel 25565-25600.
  • Das Panel zeigt ein grünes Herz neben der Node, sobald Wings antwortet; sonst prüfen Sie das Zertifikat und Port 8080.

Panel und Nodes absichern

Ein Gameserver-Panel stellt eine Admin-Oberfläche, eine API und Spielports ins Netz und ist damit ein Angriffsziel. Öffnen Sie nur die nötigen Ports, schützen Sie die Konten und sichern Sie alles, was sich nicht neu installieren lässt. Die Grundlagen der VPS-Härtung stehen in unserer Linux-Sicherheitsanleitung.

  • Firewall: 22 (SSH), 80 und 443 für das Panel, 8080 und 2022 für Wings, dann die Ports der Allocations, je nach Spiel TCP und UDP.
  • Aktivieren Sie die Zwei-Faktor-Authentifizierung für Administratorkonten und deaktivieren Sie die SSH-Anmeldung per Passwort.
  • Sichern Sie die Datei .env, die Datenbank panel (mysqldump panel) und die Serverdaten in /var/lib/pterodactyl/volumes, und kopieren Sie sie vom VPS weg.
  • Aktualisieren Sie das Panel mit php artisan p:upgrade und Wings durch Austausch des Binarys, jeweils nach einem Backup und gemäß den Release Notes.

Ohne Installation: die Optionen von ACLClouds

Wenn Sie ein eigenes Panel ohne diese Schritte möchten, installiert der vorkonfigurierte Pterodactyl-VPS Panel, MariaDB, Redis, Queue-Worker und HTTPS anhand Ihrer Domain und Zugangsdaten. Der VPS mit Pterodactyl und Wings ergänzt Docker und Wings, mit bereits angelegter Node, ihrer config.yml und 100 Allocations. In beiden Fällen behalten Sie den Root-Zugang.

  • Diese Images kosten genauso viel wie die anderen VPS: Die vorkonfigurierte Installation ist inklusive.
  • Wenn Sie nur spielen und keinen Server verwalten wollen: Unsere Gameserver laufen auf dem ACLClouds-Panel, das auf Pterodactyl und Wings aufbaut. Der Server wird fertig ausgeliefert, Sie installieren nichts.

Häufig gestellte Fragen

Ist Pterodactyl kostenlos?

Ja. Panel und Wings stehen unter MIT-Lizenz, ohne Begrenzung bei Servern oder Benutzern. Sie bezahlen nur die Maschine, auf der sie laufen.

Wie viel RAM braucht Pterodactyl?

Das Panel allein läuft mit 2 GB. Läuft Wings auf demselben VPS, addieren Sie den Speicher jedes Gameservers: 8 GB reichen für einen oder zwei kleine Server, 16 GB für mehrere mittlere.

Lässt sich Pterodactyl unter Windows installieren?

Nein. Panel und Wings sind für Linux gebaut, Wings läuft nicht unter Windows. Nutzen Sie einen Linux-VPS oder zum Testen eine Linux-VM auf Ihrem PC.

Braucht Pterodactyl einen Domainnamen?

Für den echten Einsatz ja: HTTPS im Panel und die sichere Verbindung zwischen Panel und Wings beruhen auf einem Zertifikat, das an einen Namen gebunden ist. Eine kostenlose Subdomain unter aclclouds.online genügt.