Zum Hauptinhalt springen

Dedicated Server: Installation von Pterodactyl

Die Anleitung wurde mit folgenden Produkten erstellt:

(Einzelheiten können sich bei Produkten anderer Anbieter unterscheiden, die Grundkonzepte bleiben in der Regel unverändert)

Dedicated Server

Einführung​

Das Pterodactyl Panel ist ein Open-Source Control Panel, das entwickelt wurde, um Gameserver einfach zu verwalten und zu hosten. Es bietet eine Benutzeroberfläche, mit der Administratoren mehrere Gameserver zentral konfigurieren und steuern können.

In dieser Anleitung zeigen wir dir die notwendigen Schritte, um deine eigene Pterodactyl-Instanz auf deinem Dedicated Server einzurichten.

Vorbereitung​

Du benötigst einen Dedicated Server mit Linux, um das Pterodactyl Panel zu installieren. Verwende eines der kompatiblen Betriebssysteme aus der folgenden Tabelle.

OSKompatible Versionen
Ubuntu20.04, 22.04
CentOS7, 8
Debian11, 12

Abhängigkeiten​

Pterodactyl benötigt verschiedene Abhängigkeiten, um erfolgreich installiert und betrieben zu werden. Außerdem setzt es auf den beliebten PHP-Abhängigkeitsmanager Composer.

Liste der Abhängigkeiten​

Hier eine kurze Übersicht der Abhängigkeiten, die du für diese Anleitung brauchst. Im nächsten Abschnitt erfährst du, wie du diese installierst.

  • PHP 8.1 mit den Extensions: cli, openssl, gd, mysql, PDO, mbstring, tokenizer, bcmath, xml oder dom, curl, zip und fpm.
  • MariaDB
  • Webserver – in dieser Anleitung verwenden wir Nginx.
  • curl
  • tar
  • unzip
  • git
  • composer v2

Installation der Abhängigkeiten​

Zuerst solltest du diesen Befehl ausführen, der es dir ermöglicht, zusätzliche Pakete hinzuzufügen, die nicht standardmäßig im OS enthalten sind.

apt -y install software-properties-common curl apt-transport-https ca-certificates gnupg

Jetzt installierst du die zusätzlichen Repositories für PHP, Redis und MariaDB (MySQL).

LC_ALL=C.UTF-8 add-apt-repository -y ppa:ondrej/php

Redis musst du ebenfalls installieren, da es für die temporäre Datenspeicherung benötigt wird.

curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

Für den Webserver haben wir uns für Nginx entschieden, da es zuverlässig und Open-Source ist. Du kannst natürlich auch andere Webserver wie Apache oder Caddy nutzen, aber die passen nicht so gut zu dieser Anleitung.

sudo apt install nginx # Nginx herunterladen und installieren
sudo ufw allow 'Nginx Full' # Firewall anpassen

Wir empfehlen, http://[deine_serverip]/ im Browser aufzurufen (ersetze [deine_serverip] mit der IP deines Servers), um zu testen, ob Nginx läuft. Du solltest eine Standard-Willkommensseite sehen.

Als Nächstes installierst du MariaDB, das du als MySQL-Datenbank verwenden wirst.

curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash

Zum Schluss aktualisierst du die Paketliste und installierst die restlichen Abhängigkeiten.

apt update
apt -y install php8.1 php8.1-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip} mariadb-server nginx tar unzip git redis-server

Jetzt sollten alle notwendigen Abhängigkeiten installiert sein und du kannst mit der Installation von Composer weitermachen.

Composer installieren​

Nachdem die Hauptabhängigkeiten installiert sind, musst du Composer installieren, den beliebten PHP-Abhängigkeitsmanager. Damit kannst du den kompletten Pterodactyl-Service einfach herunterladen und installieren.

Führe einfach diesen Befehl aus:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Panel herunterladen​

Jetzt, wo alle Voraussetzungen erfüllt sind, kannst du das Pterodactyl Panel installieren.

Erstelle zunächst einen Ordner, in dem das Panel gespeichert wird:

mkdir /var/www/pterodactyl
cd /var/www/pterodactyl

Dann klonst du das offizielle Pterodactyl GitHub-Repository, um die nötigen Dateien herunterzuladen:

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/

Nach dem Download ist das Panel erfolgreich auf deinem Server. Im nächsten Abschnitt konfigurierst du wichtige Einstellungen, damit das Panel korrekt installiert ist und reibungslos läuft.

Installation​

Der erste Schritt der Installation ist das Einrichten einer MySQL-Datenbank, die alle Daten für dein Pterodactyl Panel speichert. Falls du bereits eine MySQL-Datenbank mit einem passenden Benutzer hast, kannst du den nächsten Unterabschnitt überspringen.

Datenbank einrichten​

Melde dich zunächst bei deiner MySQL-Datenbank an. Falls es eine frische MySQL-Installation ist, geht das so:

mysql -u root -p

Falls du schon eine MySQL-Instanz hast, nutze deinen Benutzernamen mit -u und das Passwort mit -p.

Sobald du eingeloggt bist, musst du einen neuen Benutzer für deine Pterodactyl-Instanz anlegen. Ersetze [dein_passwort] durch dein gewünschtes Passwort:

CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY '[dein_passwort]';

Jetzt erstellst du die Datenbank für Pterodactyl und gibst dem neuen Benutzer alle Rechte darauf:

CREATE DATABASE panel;
GRANT ALL PRIVILEGES ON panel.* TO 'pterodactyl'@'127.0.0.1' WITH GRANT OPTION;

Du hast erfolgreich einen MySQL-Benutzer und eine Datenbank für Pterodactyl angelegt. Verlasse die MySQL-Konsole mit:

exit

Installation fortsetzen​

Kopiere nun die Standard-Umgebungsdatei, in der du deine geheimen Tokens speichern wirst:

cp .env.example .env

Danach installierst du alle nötigen Pakete automatisch mit Composer:

composer install --no-dev --optimize-autoloader

Generiere außerdem einen Verschlüsselungsschlüssel für deine Anwendung:

php artisan key:generate --force

Umgebungs-Konfiguration​

Jetzt richtest du deine Pterodactyl-Instanz ein. Führe dazu die folgenden Befehle aus. Jeder startet eine interaktive Einrichtung, bei der du Einstellungen zu Sessions, E-Mail, Caching und mehr vornehmen kannst.

php artisan p:environment:setup # Erster Befehl
php artisan p:environment:database # Zweiter Befehl

Datenbank einrichten​

Der nächste Schritt ist das Einrichten der Basisdaten, die das Panel zum Laufen braucht. Dabei wird die zuvor erstellte Datenbank genutzt. Führe dazu diesen Befehl aus:

Info

Das kann einige Minuten dauern. Bitte unterbrich den Prozess nicht, sonst kann es zu Problemen kommen. Bleib geduldig :)

php artisan migrate --seed --force

Admin-Benutzer anlegen​

Jetzt, wo die Datenbank vorbereitet ist, musst du deinen ersten Administrator-Benutzer anlegen, um dich im Pterodactyl Panel einzuloggen. Das geht mit:

php artisan p:user:make

Berechtigungen setzen​

Der nächste Schritt ist, die nötigen Berechtigungen für die Dateien im Pterodactyl-Panel zu setzen, damit das Panel immer ohne Probleme lesen und schreiben kann.

Setze die Rechte mit:

chown -R www-data:www-data /var/www/pterodactyl/*

Danach solltest du dein Pterodactyl Panel über die folgende URL erreichen können (ersetze deine_ipadresse mit der IP deines Servers):

http://[deine_ipadresse]/

Queue Worker einrichten​

Der letzte Schritt bei der Installation ist das Einrichten eines Cronjobs, der in regelmäßigen Abständen läuft, sowie eines Queue Workers, der viele Hintergrundaufgaben übernimmt.

Öffne zuerst deine Crontab mit sudo crontab -e. Füge dann diesen Cronjob hinzu, der jede Minute ausgeführt wird:

* * * * * php /var/www/pterodactyl/artisan schedule:run >> /dev/null 2>&1

Jetzt erstellst du einen Queue Worker mit systemd, der den Queue-Prozess im Hintergrund am Laufen hält.

Erstelle eine neue Datei für den Worker mit dem Nano-Editor:

nano /etc/systemd/system/pteroq.service

Füge folgenden Inhalt ein:

# Pterodactyl Queue Worker Datei
# ----------------------------------

[Unit]
Description=Pterodactyl Queue Worker
After=redis-server.service

[Service]
# Auf manchen Systemen können Benutzer und Gruppe anders heißen.
# Manche Systeme nutzen `apache` oder `nginx` als Benutzer und Gruppe.
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/pterodactyl/artisan queue:work --queue=high,standard,low --sleep=3 --tries=3
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
Hinweis

Wenn du CentOS nutzt, musst du redis-server.service in der Datei durch redis.service ersetzen.

Speichere die Datei mit CTRL + X und bestätige mit Y.

Aktiviere nun den Redis-Service und deinen neuen Service, damit sie beim Systemstart automatisch starten:

sudo systemctl enable --now redis-server
sudo systemctl enable --now pteroq.service

Du hast Pterodactyl erfolgreich auf deinem Dedicated Server installiert. Du kannst das Panel jetzt über folgende URL erreichen (ersetze [deine_serverip] mit der IP deines Servers):

http://[deine_serverip]

Optional: Webserver konfigurieren​

Als Zusatzfeature kannst du deinen Webserver konfigurieren. In dieser Anleitung haben wir Nginx verwendet, deshalb zeigen wir hier, wie du die Konfiguration anpasst.

Der Vorteil einer erweiterten Webserver-Konfiguration ist, dass du das Panel über deine eigene Domain erreichbar machen und ein SSL-Zertifikat für deine Panel-Webseite einrichten kannst.

DNS-Eintrag für die Domain​

Damit dein Server über deine Domain erreichbar ist, musst du einen A DNS-Eintrag für diese Domain anlegen. Das hängt stark von deinem Provider ab, sollte aber über ein DNS Panel beim Domain-Management möglich sein. Der Eintrag muss auf die IP-Adresse deines Servers zeigen.

Standard-Konfiguration entfernen​

Entferne zuerst die Standard-Nginx-Konfiguration, indem du die Datei löschst:

rm /etc/nginx/sites-enabled/default

Jetzt kannst du eine neue Konfigurationsdatei für dein Pterodactyl Panel anlegen. Entscheide dich, ob du SSL nutzen möchtest oder nicht, denn die Konfiguration und die notwendigen Schritte unterscheiden sich leicht.

Certbot einrichten​

Damit deine Webseite ein SSL-Zertifikat bekommt, musst du ein System einrichten, das Zertifikate automatisch verwaltet und erneuert. Hier nutzen wir Certbot, das Open-Source ist.

Installiere Certbot auf deinem Server. Für Nginx brauchst du außerdem das Python3-Certbot-Paket:

sudo apt update
sudo apt install -y certbot
sudo apt install -y python3-certbot-nginx

Als nächstes richtest du die Verifikation ein, um ein Zertifikat zu generieren. Wir nutzen eine DNS-Challenge, da diese sicherer ist als eine HTTP-Challenge.

Du musst einen TXT DNS-Eintrag für deine Domain anlegen. Das hängt vom Provider ab, sollte aber über dein DNS Panel möglich sein.

Führe diesen Befehl aus, der dir den Inhalt für den TXT DNS-Eintrag anzeigt. Ersetze [deine_domain] durch deine Domain:

certbot -d [deine_domain] --manual --preferred-challenges dns certonly

Nachdem du den DNS-Eintrag gesetzt hast, richtest du die automatische Erneuerung per Cronjob ein. Öffne Crontab mit sudo crontab -e und füge diesen Eintrag hinzu, damit das Zertifikat täglich um 23:00 Uhr erneuert wird:

0 23 * * * certbot renew --quiet --deploy-hook "systemctl restart nginx"

Konfigurationsdatei erstellen​

Jetzt, wo dein SSL-Zertifikat bereit ist, kannst du die Konfigurationsdatei anlegen.

Öffne den Nano-Editor mit:

nano /etc/nginx/sites-enabled/pterodactyl.conf

Füge folgenden Inhalt ein. Ersetze [deine_domain] mit deiner Domain, für die du den DNS-Eintrag erstellt hast.

Warnung

Stelle sicher, dass das SSL-Zertifikat eingerichtet ist, sonst startet der Webserver nicht korrekt.

server_tokens off;

server {
    listen 80;
    server_name [deine_domain];
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name [deine_domain];

    root /var/www/pterodactyl/public;
    index index.php;

    access_log /var/log/nginx/pterodactyl.app-access.log;
    error_log  /var/log/nginx/pterodactyl.app-error.log error;

    client_max_body_size 100m;
    client_body_timeout 120s;

    sendfile off;

    ssl_certificate /etc/letsencrypt/live/[deine_domain]/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/[deine_domain]/privkey.pem;
    ssl_session_cache shared:SSL:10m;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
    ssl_prefer_server_ciphers on;

    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Robots-Tag none;
    add_header Content-Security-Policy "frame-ancestors 'self'";
    add_header X-Frame-Options DENY;
    add_header Referrer-Policy same-origin;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY "";
        fastcgi_intercept_errors off;
        fastcgi_buffer_size 16k;
        fastcgi_buffers 4 16k;
        fastcgi_connect_timeout 300;
        fastcgi_send_timeout 300;
        fastcgi_read_timeout 300;
        include /etc/nginx/fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

Konfiguration aktivieren​

Nachdem du die Änderungen an der Konfiguration vorgenommen hast, musst du sie aktivieren:

sudo ln -s /etc/nginx/sites-available/pterodactyl.conf /etc/nginx/sites-enabled/pterodactyl.conf # Nicht nötig bei CentOS

sudo systemctl restart nginx # Nginx neu starten

Wenn alles erfolgreich war, solltest du dein Pterodactyl Panel jetzt bequem über die Domain erreichen können, die du in diesem Abschnitt eingerichtet hast.

Du hast deinen Webserver erfolgreich konfiguriert, um deine Domain zu nutzen und ein SSL-Zertifikat für deine Webseite hinzuzufügen.

Cookie Einstellungen