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 oplossing voor het beheer van gameservers die het volgende combineert:

• Ondersteuning voor 50+ games: Biedt kant-en-klare templates voor de snelle installatie van populaire gameservers. Configureert software, afhankelijkheden en opstartparameters automatisch, ondersteunt de selectie van gameversies en het toevoegen van aangepaste templates.
• Precieze resourcebeheer: Controleert 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 belangrijke bestanden). Slaat back-ups lokaal of in de cloud (S3, FTP, GDrive) op met encryptie en directe herstelopties.
• 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 rolgebaseerd 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 kleurcodering, commandohistorie, snelle actieknoppen en event-notificaties.
• Real-time statistieken monitoring: Toont grafieken voor resourcegebruik (CPU, RAM, schijf, netwerk) en gamemetrics (online spelers, TPS, ping). Maakt het maken van aangepaste dashboards mogelijk, configureert waarschuwingen en exporteert gegevens naar CSV.
• Vereenvoudigd mod/plugin beheer: Biedt een ingebouwde store voor automatische mod-installatie, versie- en afhankelijkheidsbeheer. Inclusief een visuele configuratie-editor met syntax highlighting en update-notificaties.
• Automatische updates: Zorgt voor een ononderbroken systeemwerking. Update gameservers 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. Update de Wings daemon automatisch, wat zorgt voor compatibiliteit met verschillende Linux-distributies.

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 dat u heeft geregistreerd, waarin staat 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 het API control panel — Invapi.

Autorisatiagegevens 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 paneel, voegt u /admin toe aan de hoofdlink;
• Login: admin;
• Wachtwoord: 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 paneeladres

2. Klik op Login:

   

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

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

   

Een gebruiker aanmaken¶

1. Klik in het linkermenu van het admin paneel 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. "Datacenter in de VS");

4. Klik op Create:

   

Een Node aanmaken¶

Voorbereiding voor het aanmaken van een Node¶

Voordat u een node aanmaakt, zorg er dan voor dat:

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

Een Node aanmaken in het Panel¶

1. Selecteer in het linkermenu van het admin paneel 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 domeinnaam van het paneel (bijv. pterodactyl50514.hostkey.in) of het IP-adres;
   • Communicate Over SSL: vink het vakje aan als het 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 schijf rekening houdend met reserve);
   • Disk Over-Allocation: specificeer 0 (geen over-allocatie);
   • Daemon Port: 8080 (laat standaard);
   • Daemon SFTP Port: 2022 (laat standaard).

   

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 (houdt 1.5GB over voor het systeem)
    Memory Over-Allocation: 0
    Total Disk Space: 102400 MB (houdt 20GB over voor het systeem)
    Disk Over-Allocation: 0

Allocaties configureren¶

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

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. De aangemaakte allocaties verschijnen in de tabel Existing Allocations (linkerkant). Elke rij vertegenwoordigt een aparte IP:poort combinatie die kan worden toegewezen aan een gameserver.

   

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 paneel naar het tabblad Configuration van de aangemaakte node;

2. Klik in de sectie Auto-Deploy (rechterkant) 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 zou moeten verschijnen: Successfully configured wings.

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) aangeven.

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 het 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 Paneel¶

1. Open het admin paneel: 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 het Panel:

   • Controleer de panel-URL in de configuratie: cat /etc/pterodactyl/config.yml | grep remote;
   • Zorg dat het Panel bereikbaar 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 het 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 paneel 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 type server (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 het Panel¶

1. Ga in het admin paneel 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 de geïmporteerde egg in de lijst (bijv. Paper);

2. Klik erop om de instellingen te bekijken;

3. Zorg dat het volgende is ingevuld:

   • Docker Images: lijst met 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 dit vakje aangevinkt.

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 mee 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 keer opstarten 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 via de API, volgt u deze instructies.