Pterodactyl ist ein Open-Source-Panel zur Verwaltung von Game-Servern mit Docker. Diese Anleitung führt Sie durch die Installation des Panels und des Wings-Daemons auf Debian 12.
apt update && apt upgrade -y
reboot
apt install -y curl tar unzip git redis-server mariadb-server \
software-properties-common certbot python3-certbot-nginx \
nginx php8.2 php8.2-cli php8.2-common php8.2-mbstring php8.2-gd \
php8.2-xml php8.2-bcmath php8.2-curl php8.2-zip php8.2-fpm \
php8.2-mysql
MariaDB sichern und root-Passwort setzen:
mysql_secure_installation
Neue Datenbank für Pterodactyl anlegen:
mysql -u root -p
CREATE DATABASE pterodactyl;
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'STRONG_PASSWORD';
GRANT ALL PRIVILEGES ON pterodactyl.* TO 'pterodactyl'@'127.0.0.1';
FLUSH PRIVILEGES;
EXIT;
Hinweis: Das Passwort muss auf ein sichers Passwort abgeändert werden!
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
Abhängigkeiten per Composer installieren:
curl -sS https://getcomposer.org/installer | php
php composer.phar install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate
Bearbeiten Sie die .env Datei und tragen Sie Ihre Datenbankinformationen ein:
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=pterodactyl
DB_USERNAME=pterodactyl
DB_PASSWORD=STRONG_PASSWORD
Hinweis: Das Passwort muss auf das von Ihnen gewählte Passwort abgeändert werden!
php artisan p:environment:setup
php artisan p:environment:database
php artisan migrate --seed --force
Erstellen Sie einen Admin-Benutzer:
php artisan p:user:make
Erstellen Sie eine neue Nginx-Konfigurationsdatei:
nano /etc/nginx/sites-available/pterodactyl
Inhalt:
server {
listen 80;
server_name panel.example.com;
root /var/www/pterodactyl/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
Hinweis: Den Serverport und die Domain, können Sie hier abändern.
Nginx aktivieren:
ln -s /etc/nginx/sites-available/pterodactyl /etc/nginx/sites-enabled/
systemctl reload nginx
certbot --nginx -d panel.example.com
# Die Domain muss mit Ihrer Domain erstezt werden.
Hinweis: Hier müssen Sie Ihre Domain eintragen.
curl -Lo /usr/local/bin/wings https://github.com/pterodactyl/wings/releases/latest/download/wings
chmod u+x /usr/local/bin/wings
Daemon konfigurieren:
mkdir -p /etc/pterodactyl
cd /etc/pterodactyl
curl -Lo config.yml https://raw.githubusercontent.com/pterodactyl/wings/develop/config.yml.example
apt install docker.io -y
systemctl enable --now docker
nano /etc/systemd/system/wings.service
Inhalt:
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
ExecStart=/usr/local/bin/wings
Restart=always
StartLimitInterval=120
StartLimitBurst=5
[Install]
WantedBy=multi-user.target
systemctl enable --now wings
Nach der Installation ist das Panel erreichbar unter:
Loggen Sie sich mit Ihrem Admin-Benutzer ein und starten Sie mit der Konfiguration Ihrer Game-Server.
Troubleshooting
Panel zeigt 500-Fehler?
chown -R www-data:www-data /var/www/pterodactyl
php artisan queue:restart
Wings startet nicht?
systemctl restart wings
journalctl -xeu wings
Fazit
Mit dieser Anleitung ist Pterodactyl auf Debian 12 installiert und betriebsbereit. Das Panel ermöglicht die einfache Verwaltung und Bereitstellung von Game-Servern mit Docker und bietet umfangreiche Verwaltungsoptionen.