Pterodactyl Control Panel¶

In dit artikel

• Pterodactyl. Belangrijkste functies
• Implementatiefuncties
• Aan de slag na de Pterodactyl implementatie
• Een gebruiker aanmaken
• Een locatie aanmaken
• Een Node aanmaken
• Allocaties configureren
• Wings installeren
• Probleemoplossing
• Een Nest aanmaken en een Egg toevoegen
• Een Server aanmaken
• De Server starten en configureren
• Performance Check
• Bestel een Pterodactyl Server via de API

Pterodactyl. Belangrijkste functies¶

Pterodactyl is een moderne game server management oplossing die het volgende combineert:

• Ondersteuning voor 50+ games: Biedt kant-en-klare templates voor de snelle installatie van populaire game servers. Configureert automatisch software, dependencies en opstartparameters, ondersteunt de selectie van gameversies en het toevoegen van aangepaste templates.
• Precieze resource management: Beheert RAM, CPU, schijfruimte en prioriteitsverdeling tussen servers. Voorkomt overbelasting, wijst resources toe op basis van quota en gebruikt SWAP-geheugen voor stabiliteit.
• Betrouwbare automatische back-ups: Zorgt voor flexibele, geplande back-ups met dataselectie (de volledige server of specifieke bestanden). Slaat back-ups lokaal of in de cloud (S3, FTP, GDrive) op met encryptie en instant herstel.
• Efficiënte multi-server capaciteit: Draait elke server in een geïsoleerde Docker-container. Verdeelt de belasting automatisch over nodes, wijst poorten zonder conflicten toe en maakt het groeperen van gerelateerde servers mogelijk.
• Flexibele multi-user toegang: Beheert permissies via een role-based model (voorinstellingen + aangepaste rollen) met meer dan 50 granulaire permissies. Ondersteunt tijdelijke toegang, actie-auditing en tweestapsverificatie.
• Real-time management console: Biedt volledige controle via een webinterface met een interactieve terminal (vergelijkbaar met SSH). Inclusief kleurformattering, command history, snelle actieknoppen en event-notificaties.
• Real-time statistieken monitoring: Toont grafieken van het resourcegebruik (CPU, RAM, disk, netwerk) en game-metrieken (online spelers, TPS, ping). Maakt het maken van aangepaste dashboards mogelijk, configureert alerts en exporteert gegevens naar CSV.
• Vereenvoudigd mod/plugin beheer: Biedt een ingebouwde store voor automatische mod-installatie, versie- en dependency management. Inclusief een visuele config-editor met syntax highlighting en update-notificaties.
• Automatische updates: Zorgt voor een ononderbroken systeemwerking. Update game servers volgens schema met een testmodus en rollback bij fouten. Update het control panel met één commando (php artisan p:upgrade), waarbij compatibiliteit wordt gecontroleerd en de database wordt gemigreerd zonder gegevensverlies. Auto-updates Wings daemon, waardoor compatibiliteit met verschillende Linux-distributies behouden blijft.

Implementatiefuncties¶

Belangrijkste systeemcomponenten:¶

Configuratiebestanden¶

Aan de slag na de Pterodactyl implementatie¶

Nadat u voor uw bestelling heeft betaald, ontvangt u een melding op het e-mailadres waarmee u zich heeft geregistreerd, waarin u wordt geïnformeerd dat uw server klaar is voor gebruik. Deze bevat het VPS IP-adres, evenals een login en wachtwoord voor de verbinding. De klanten van ons bedrijf beheren hardware in de servers en API control panel — Invapi.

Autorisatiegegevens die te vinden zijn in het tabblad Configuration >> Tags van het server control panel of in de e-mail, zijn als volgt te vinden:

• Link: in de webpanel tag. Om toegang te krijgen tot het admin panel, voegt u /admin toe aan de hoofdlink;
• Login: admin;
• Password: verzonden via e-mail naar uw adres wanneer de server klaar is voor gebruik na de software-implementatie.

Eerste login¶

1. Open een webbrowser en navigeer naar uw Pterodactyl panel adres

2. Klik op Login:

   

3. Na succesvolle autorisatie wordt u naar de hoofdpagina van het panel geleid.

4. Om toegang te krijgen tot het admin panel, klikt u op de knop:

   

Een gebruiker aanmaken¶

1. Klik in het linkermenu van het admin panel op de sectie Users;

2. Klik op de Create New knop in de rechterbovenhoek:

   

3. Vul de vereiste velden in:

   • Username: gebruikersnaam;
   • Email: e-mailadres van de gebruiker;
   • First Name: voornaam;
   • Last Name: achternaam;
   • Password: wachtwoord (minimaal 8 tekens, moet hoofdletters, kleine letters en cijfers bevatten);
4. Selecteer indien nodig Yes in de regel Administrator om administratorrechten te verlenen;

5. Klik op Create User:

   

Een locatie aanmaken¶

1. Selecteer in het linkermenu Locations;

2. Klik op de Create New knop in de rechterbovenhoek:

   

3. Vul de velden in:

   • Short Code: korte locatiecode (bijv. "US1", "EU1");
   • Description: beschrijving van de locatie (bijv. "Data center in de USA");

4. Klik op Create:

   

Een Node aanmaken¶

Voorbereiding voordat u een Node aanmaakt¶

Zorg er voordat u een node aanmaakt voor het volgende:

• Docker is geïnstalleerd op de server (voor geïnstalleerd in HOSTKEY images);
• U heeft een IP-adres of domeinnaam voor de node;
• Poorten 8080 (Wings API) en 12333 (Wings/Daemon SSL communicatie) worden geopend in de firewall.

Een Node aanmaken in de Panel¶

1. Selecteer in het linkermenu van het admin panel Nodes;

2. Klik op de Create New knop in de rechterbovenhoek:

   

3. Vul de basic settings in:

   • Name: unieke nodenaam (bijv. hostkey-us-node1);
   • Location: selecteer de eerder aangemaakte locatie;
   • Public: vink het vakje aan als de node zichtbaar moet zijn voor gebruikers;
   • FQDN: specificeer de panel domeinnaam (bijv. pterodactyl50514.hostkey.in) of het IP-adres;
   • Communicate Over SSL: vink het vakje aan als de Panel HTTPS gebruikt;
   • Behind Proxy: laat dit uitgeschakeld als de node zich niet achter een proxy bevindt.

4. Configureer de resource settings:

   • Daemon Server File Directory: /var/lib/pterodactyl/volumes (niet wijzigen);
   • Total Memory: specificeer beschikbaar RAM in MB (bijv. 4608 voor een 6GB server rekening houdend met reserve);
   • Memory Over-Allocation: specificeer 0 (geen over-allocatie);
   • Total Disk Space: specificeer beschikbare schijfruimte in MB (bijv. 102400 voor een 120GB disk rekening houdend met reserve);
   • Disk Over-Allocation: specificeer 0 (geen over-allocatie);
   • Daemon Port: 8080 (laat standaard staan);
   • Daemon SFTP Port: 2022 (laat standaard staan).

   

5. Klik op de Create Node knop.

    Name: hostkey-us-node1
    Location: US1
    Public: ☑
    FQDN: pterodactyl50514.hostkey.in
    Communicate Over SSL: ☑
    Behind Proxy: ☐

    Total Memory: 4608 MB (laat 1.5GB over voor het systeem)
    Memory Over-Allocation: 0
    Total Disk Space: 102400 MB (laat 20GB over voor het systeem)
    Disk Over-Allocation: 0

Allocaties configureren¶

Nadat u een node heeft aangemaakt, moet u allocaties configureren - dit zijn IP-adres en poort combinaties die beschikbaar zullen zijn voor toewijzing aan game servers.

1. Na het aanmaken van de node wordt de pagina automatisch geopend. Navigeer naar het tabblad Allocation;

2. In de sectie Assign New Allocations (rechterkant), vul de velden in:

   • IP Address: voer het server IP-adres in;
   • IP Alias: specificeer een beschrijving (bijv. Main IP) of laat het leeg;
   • Ports: specificeer een poortbereik (bijv. 25565-25570 voor Minecraft servers).

3. Klik op de groene Submit knop:

   

4. Aangemaakte allocaties verschijnen in de tabel Existing Allocations (linkerkant). Elke rij vertegenwoordigt een aparte IP:poort combinatie die kan worden toegewezen aan een game server.

   

Wings installeren¶

Verbind via SSH met de server en voer de volgende commando's uit:

Maak een directory aan voor de configuratie:

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

wings version

De Wings-versie moet worden weergegeven (bijv. wings vv1.12.1).

Wings configureren via Auto-Deploy (Aanbevolen)¶

1. Ga in het admin panel naar het tabblad Configuration van de aangemaakte node;

2. In de sectie Auto-Deploy (rechterkant), klik op de Generate Token knop:

   

3. Kopieer het gegenereerde commando. Het zal er ongeveer zo uitzien:

       cd /etc/pterodactyl && wings configure --panel-url https://your-domain.com --token TOKEN --node 1
   

   

4. Voer het gekopieerde commando uit op de server:

       cd /etc/pterodactyl && wings configure --panel-url https://pterodactyl50514.hostkey.in --token TOKEN --node 1
   

   De melding Successfully configured wings. zou moeten verschijnen.

5. Verifieer de aangemaakte configuratie:

       cat /etc/pterodactyl/config.yml
   

Een systemd Service aanmaken¶

Maak een systemd service aan voor het automatisch opstarten van Wings:

cat > /etc/systemd/system/wings.service <<'EOF'
[Unit]
Description=Pterodactyl Wings Daemon
After=docker.service
Requires=docker.service
PartOf=docker.service

[Service]
User=root
WorkingDirectory=/etc/pterodactyl
LimitNOFILE=4096
PIDFile=/var/run/wings/daemon.pid
ExecStart=/usr/local/bin/wings
Restart=on-failure
StartLimitInterval=180
StartLimitBurst=30
RestartSec=5s

[Install]
WantedBy=multi-user.target
EOF

Wings starten¶

Herlaad de systemd-configuratie

systemctl daemon-reload

systemctl enable --now wings

systemctl status wings

De status moet Active: active (running) weergeven.

Werking controleren¶

Controleer de Wings-logs:

journalctl -u wings -n 50

De logs moeten de volgende berichten bevatten:

• fetching list of servers from API - Wings is verbonden met de Panel;
• configuring internal webserver - De Wings webserver is gestart;
• sftp server listening for connections - De SFTP-server werkt.

Verifieer de aanmaak van de serverdirectory:

ls -la /var/lib/pterodactyl/volumes/

Statuscontrole in het Admin Panel¶

1. Open het admin panel: https://your-domain.com/admin;
2. Navigeer naar: Admin > Nodes > uw node;
3. Vernieuw de pagina (F5);
4. De groene Online statusindicator moet rechtsboven worden weergegeven;
5. Op het tabblad About moeten de resource-informatie worden weergegeven (CPU, RAM, Disk).

Probleemoplossing¶

Node toont de status Offline¶

Controleer de Wings-status:

systemctl status wings

Als Wings niet draait, start het dan handmatig:

systemctl start wings

Controleer de logs op fouten:

journalctl -u wings -n 100

Veelvoorkomende problemen:

1. Wings kan geen verbinding maken met de Panel:

   • Controleer de panel URL in de configuratie: cat /etc/pterodactyl/config.yml | grep remote;
   • Zorg dat de Panel toegankelijk is: curl -I https://your-domain.com.

2. Poort 8080 wordt geblokkeerd door de firewall:

   • Controleer de poort: netstat -tulpn | grep 8080;
   • Open de poort: ufw allow 8080/tcp.

3. SSL-problemen:

   • Als de Panel HTTPS gebruikt, moet Wings ook met SSL werken;
   • Controleer de SSL-instellingen in /etc/pterodactyl/config.yml.

Handmatige configuratie (Alternatieve methode)¶

Als Auto-Deploy niet werkt, kunt u Wings handmatig configureren:

1. Ga in het admin panel naar het tabblad Configuration van de node;
2. Kopieer de inhoud van het configuratiebestand uit het linker tekstveld;

3. Maak op de server een configuratiebestand aan:

   nano /etc/pterodactyl/config.yml
   

4. Plak de gekopieerde configuratie en sla op (Ctrl+X, dan Y, dan Enter);

5. Herstart Wings: systemctl restart wings;
6. Controleer de status: systemctl status wings.

Een Nest aanmaken en een Egg toevoegen¶

Een Nest aanmaken¶

1. Selecteer in het linkermenu de sectie Nests;

2. Klik op de Create New knop in de rechterbovenhoek:

3. Vul de velden in:

   • Name: naam van de nest (bijv. "Minecraft");
   • Description: beschrijving van de nest;

4. Klik op Save:

   

Download een kant-en-klare Egg¶

1. Open de website https://pelican-eggs.github.io/;

2. Zoek het gewenste spel:

   • Selecteer in de sectie Game Eggs een categorie (bijv. Minecraft);
   • Zoek het gewenste servertype (bijv. Paper, Vanilla, Forge);

3. Klik op de servernaam om de GitHub-pagina te openen;

4. Zoek het egg-name.json bestand (bijv. egg-paper.json);

5. Klik op het bestand en vervolgens op de Raw knop in de rechterbovenhoek;

6. Sla het bestand op (Ctrl+S of rechtermuisknop > Save as).

Importeer de Egg in de Panel¶

1. Ga in het admin panel naar de sectie Nests;

2. Klik op de Import Egg knop in de rechterbovenhoek:

   

3. Klik op Choose File en selecteer het gedownloade .json bestand;

4. Klik op Import:

   

De egg wordt geïmporteerd met alle instellingen, Docker-images en variabelen.

Verifieer de geïmporteerde Egg¶

1. Zoek in de egg-lijst de geïmporteerde egg (bijv. Paper);

2. Klik erop om de instellingen te bekijken;

3. Zorg ervoor dat het volgende is ingevuld:

   • Docker Images: lijst van beschikbare images;
   • Install Script: installatiescript voor de server;
   • Variables: omgevingsvariabelen (versie, instellingen).

   

   

Een Server aanmaken¶

1. Selecteer in het linkermenu Servers;

2. Klik op de Create New knop in de rechterbovenhoek:

   

3. Vul het aanmaakformulier in:

Core Details:

• Server Name: servernaam (bijv. Test Minecraft Server);
• Server Owner: selecteer de eigenaar uit de lijst;
• Server Description: beschrijving (optioneel);
• Start Server when Installed: laat het vinkje aanstaan.

Allocation Management:

• Node: selecteer de aangemaakte node;
• Default Allocation: selecteer IP-adres:poort uit de lijst;
• Additional Allocations: laat leeg.

Application Feature Limits:

• Database Limit: 0;
• Allocation Limit: 0;
• Backup Limit: 0.

Resource Management:

• CPU Limit: 0 (geen limieten);
• Memory: 2048 MiB (2GB om te starten);
• Swap: 0 MiB;
• Disk Space: 5120 MiB (5GB);
• Block IO Weight: 500;
• Enable OOM Killer: laat dit uitgeschakeld.

Nest Configuration:

• Nest: Minecraft;
• Egg: Paper (niet Sponge!);
• Docker Image: Java 21;

• Service Variables: laat de standaardwaarden staan.

• Klik onderaan de pagina op Create Server;

• Wacht tot de installatie is voltooid (de status Installing verandert in Offline):

De Server starten en configureren¶

1. Open na de installatie de server uit de lijst (Admin > Servers):

   

2. Ga naar het gebruikerspaneel (zonder /admin), log in als de eigenaar van de server;

3. Klik op de Start knop:

   

4. Bij de eerste lancering verschijnt er een venster voor het accepteren van een licentie:

   

5. Klik op I Accept om de Minecraft EULA te accepteren;

6. Wacht tot de server is gestart (de status verandert in Running):

   

Performance Check¶

Open in uw browser (vervang IP door uw eigen IP):

https://api.mcsrvstat.us/3/<IP-adres>:25565

Verbindingsadres:

<IP-adres>:25565

Bestel een Pterodactyl Server via de API¶

Om deze software te installeren met behulp van de API, volgt u deze instructies.