Pterodactyl Wings: een node toevoegen, allocaties en je eerste server

Wings is de service van Pterodactyl die op de server gameservers in Docker-containers draait. We installeren Wings, koppelen het aan het Panel, openen de benodigde poorten en maken de eerste server aan.

Hoe het werkt#

Het Panel is alleen een webinterface. Het echte werk doet Wings op de node (de server waarop de spellen draaien). Wings krijgt opdrachten van het Panel, downloadt Docker-images, draait gameservers in geïsoleerde containers, bewaakt hun RAM en schijfruimte en verzorgt de console en de bestanden.

Het is belangrijk wie waarmee verbinding maakt:

De gameservers krijgen het interne Docker-netwerk pterodactyl_nw. Op de VPS verschijnt de netwerkinterface pterodactyl0 met het adres 172.18.0.1, waarlangs de containers de server zelf zien (dat gebruik je bij de databasehost). De gegevens van de servers staan in de map /var/lib/pterodactyl/volumes.

De virtualisatie controleren#

Wings heeft Docker nodig en Docker heeft volwaardige virtualisatie nodig. Een VPS bij StormHost draait op KVM, en dat voldoet. Je kunt het controleren met het commando:

systemd-detect-virt

kvm

De uitkomsten openvz of lxc zouden betekenen dat Docker (en dus Wings) waarschijnlijk niet werkt.

Docker installeren#

Installeer Docker uit de officiële repository van Docker. Elk commando is uitgebreid uitgelegd in de handleiding Docker en Docker Compose, hier staat alleen de korte werkwijze:

Laat Docker daarna meestarten met het systeem en controleer of het werkt:

systemctl enable --now docker
docker run --rm hello-world

• systemctl enable --now docker – Docker start meteen en daarna bij elke start van de VPS.
• docker run --rm hello-world – downloadt en start een testcontainer; --rm verwijdert die na afloop. Je ziet de tekst Hello from Docker!.

Wings downloaden#

mkdir -p /etc/pterodactyl
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings

• mkdir -p /etc/pterodactyl – de map voor de configuratie van Wings.
• curl -L -o /usr/local/bin/wings "…" – downloadt de nieuwste release van Wings als het programma /usr/local/bin/wings. -L volgt de omleiding van GitHub.
• $([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64") – kiest het juiste bestand op basis van de processorarchitectuur: uname -m toont x86_64 (gewone servers), waarvoor de versie amd64 wordt gedownload.
• chmod u+x – staat de eigenaar (root) toe het bestand uit te voeren.

Controle: wings version toont het versienummer.

Domein en certificaat voor de node#

Het Panel draait op HTTPS, dus moet Wings ook HTTPS gebruiken. Anders zou de browser de verbinding met de node blokkeren. Het certificaat is gebonden aan het domein van de node (in het Panel het veld FQDN).

Na een verlenging van het certificaat moet Wings worden herstart, anders blijft het het oude certificaat gebruiken. Maak een deploy hook aan (een script dat Certbot na elke geslaagde verlenging uitvoert):

cat > /etc/letsencrypt/renewal-hooks/deploy/restart-wings.sh <<'EOF'
#!/bin/sh
systemctl restart wings
EOF
chmod 755 /etc/letsencrypt/renewal-hooks/deploy/restart-wings.sh

• Een bestand in de map renewal-hooks/deploy voert Certbot uit na elke verlenging van het certificaat.
• systemctl restart wings – herstart Wings. Draaiende gameservers zet je daarmee niet uit, Wings maakt er na de start opnieuw verbinding mee.
• chmod 755 – het script moet uitvoerbaar zijn.

Locatie#

Elke node hoort bij een locatie. Een locatie is alleen een label om nodes te ordenen (bijvoorbeeld per datacenter).

1. Open in het Panel het beheergedeelte (het tandwielpictogram rechtsboven) en klik links op Locations.
2. Klik op Create New.
3. Vul Short Code in, een korte aanduiding van 1–⁠60 tekens, bijvoorbeeld cz-praha.
4. Vul Description in, een omschrijving van de locatie voor jou en andere beheerders, bijvoorbeeld VPS in Praag.
5. Klik op Create.

De node in het Panel#

Klik in het beheergedeelte links op Nodes en daarna op Create New. Vul het formulier in volgens de tabel:

Klik op Create Node. Het Panel opent de detailpagina van de node.

Wings configureren#

Open op de detailpagina van de node het tabblad Configuration. De configuratie krijg je op een van twee manieren op de VPS.

Manier A, automatisch: Klik op Generate Token. Het Panel toont een commando dat begint met cd /etc/pterodactyl && sudo wings configure --panel-url https://panel.example.cz --token …. Kopieer het helemaal en voer het uit op de VPS van de node. Wings haalt de configuratie zelf op bij het Panel.

Manier B, handmatig:

1. Open op de VPS het bestand:

   nano /etc/pterodactyl/config.yml

2. Plak de hele inhoud van het blok op het tabblad Configuration erin, sla op (Ctrl+O, Enter) en sluit af (Ctrl+X).

Wat er in de configuratie staat:

Bij de eerste start vult Wings het bestand aan met meer standaardwaarden, bijvoorbeeld de instellingen van het Docker-netwerk (docker.network, het adres 172.18.0.1) en de DNS-servers voor de containers (1.1.1.1, 1.0.0.1).

De eerste start in debugmodus#

Probeer Wings eerst handmatig uit voordat je het op de achtergrond laat draaien, zodat je eventuele fouten ziet:

wings --debug

• --debug – gedetailleerde uitvoer van alles wat Wings doet.

Bij de eerste start maakt Wings het Docker-netwerk aan (creating missing pterodactyl0 interface…) en meldt het dat het luistert (configuring internal webserver). Open daarna in het Panel Nodes. Bij de node verschijnt een groen kloppend hartje = het Panel heeft verbinding met Wings. Een rood hartje betekent dat de verbinding niet werkt (zie Als iets niet werkt).

Is het hartje groen, sluit Wings dan af met de toetsen Ctrl+C.

Wings als service#

Om Wings permanent te laten draaien en na een herstart van de VPS vanzelf te laten starten, maak je een systemd-service aan:

nano /etc/systemd/system/wings.service

[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

Schakel de service in en start die:

systemctl enable --now wings
systemctl status wings

Je ziet Active: active (running). Het hartje bij de node in het Panel blijft groen.

Allocaties#

Een allocatie is de combinatie van een IP-adres en een poort die een gameserver krijgt. Elke server heeft er minstens één nodig (de primaire), meer kun je toevoegen voor RCON, query of plugins.

1. Zoek het openbare IPv4-⁠adres van de VPS op. Je vindt het in je klantaccount op het tabblad Netwerk, of je toont het met:

   hostname -I | awk '{print $1}'

   • hostname -I – toont alle IP-adressen van de VPS; awk '{print $1}' neemt daarvan het eerste.

2. Open op de detailpagina van de node het tabblad Allocation.

3. Vul rechts in het gedeelte Assign New Allocations de velden in volgens de tabel en klik op Submit.

Gebruikelijke standaardpoorten: Minecraft Java 25565, Rust 28015 (en 28016 voor RCON), FiveM 30120. Voeg voor meerdere servers van hetzelfde spel een bereik toe, elke server krijgt een andere poort.

Firewall#

Open de poorten in de firewall in je klantaccount (handleiding: Firewall in je klantaccount). Staat het inkomende verkeer in de modus Alles blokkeren behalve wat is toegestaan, voeg dan regels Inkomend · Toestaan toe:

Gebruik je op de VPS UFW, sta de API en SFTP daar dan in toe:

ufw allow 8080/tcp
ufw allow 2022/tcp

De gamepoorten hoef je in UFW niet toe te staan. Docker publiceert de poorten van containers met eigen regels, die UFW omzeilen (details in de handleiding Firewall UFW). Beperk de gamepoorten daarom met de firewall in je klantaccount, die staat vóór de VPS en geldt voor alles.

De eerste server#

1. Klik in het beheergedeelte op Servers en daarna op Create New.
2. Vul het formulier in volgens de tabel en klik onderaan op Create Server.

3. Wings downloadt de Docker-image en start de installatie. Volg de voortgang in de console van de server: klik linksboven op de naam van het Panel (je gaat van het beheergedeelte naar het overzicht van servers) en open de nieuwe server. Is de server van een andere gebruiker, zet dan in het overzicht de schakelaar Showing your servers op Showing others' servers.
4. Bij Minecraft verschijnt na de eerste start het venster Accept Minecraft® EULA. Door op I Accept te klikken ga je akkoord met de licentievoorwaarden van Minecraft en start de server.

Controle#

• Bij de node in Nodes brandt een groen hartje.
• De server draait na de installatie en in de console zie je de uitvoer ervan (bij Minecraft de regel Done (…)! For help, type "help").
• In het spel maak je verbinding met 203.0.113.10:25565 (of met de IP Alias).
• Via SFTP maak je verbinding met het adres van de node en poort 2022 (bijvoorbeeld sftp://panel.example.cz:2022). Het adres en de gebruikersnaam vind je bij de server op het tabblad Settings in het gedeelte SFTP Details (Server Address, Username). Het wachtwoord is hetzelfde als je wachtwoord voor het Panel.

Controle op de VPS:

systemctl is-active docker wings
docker ps

• docker ps – toont de draaiende containers; elke gameserver is één container.

Wings bijwerken#

Werk Wings altijd bij nadat je het Panel hebt bijgewerkt (werkwijze voor het Panel):

systemctl stop wings
curl -L -o /usr/local/bin/wings "https://github.com/pterodactyl/wings/releases/latest/download/wings_linux_$([[ "$(uname -m)" == "x86_64" ]] && echo "amd64" || echo "arm64")"
chmod u+x /usr/local/bin/wings
systemctl restart wings

• systemctl stop wings – stopt Wings, zodat het programma kan worden overschreven. Draaiende gameservers merken daar niets van.
• curl … en chmod … – hetzelfde als bij de installatie, ze downloaden de nieuwste versie.
• systemctl restart wings – start de nieuwe versie; open verbindingen herstellen zich vanzelf.

Als iets niet werkt#

Een rood hartje bij de node#

Het Panel kon Wings niet bereiken. Werk de oorzaken af, te beginnen met de meest voorkomende:

1. Draait Wings? systemctl status wings. Zo niet, voer dan wings --debug uit en lees de fout.
2. Staat poort 8080 open in de firewall van je klantaccount en in UFW?
3. Verwijst de FQDN van de node naar het juiste IP-adres? getent hosts node.example.cz.
4. Werkt het certificaat? Voer op de VPS met het Panel curl https://node.example.cz:8080 uit. Het antwoord {"error":"The required authorization heads were not present in the request."} is in orde: Wings antwoordt, je hebt alleen geen inlogtoken meegestuurd. Een certificaatfout (SSL certificate problem) betekent een verkeerd of verlopen certificaat.
5. Loopt het domein van de node niet via de proxy van Cloudflare (oranje wolkje)? Zet het op DNS only.
6. Komt config.yml overeen met wat het tabblad Configuration in het Panel toont? Na het verwijderen en opnieuw aanmaken van een node verandert het token.
7. Controleer of een browserextensie zoals AdBlock de verbinding niet blokkeert.

failed to configure HTTPS server#

Wings heeft het certificaat niet gevonden. In de uitvoer staat meestal ook no such file or directory met een pad. Het pad in config.yml (api.ssl.cert) moet overeenkomen met het certificaat dat je hebt (certbot certificates). Heb je de FQDN van de node gewijzigd, vraag dan ook voor het nieuwe domein een certificaat aan.

address already in use#

Poort 8080 of 2022 wordt al door een ander programma gebruikt. Zoek uit welk:

ss -tulpn | grep -E ':8080|:2022'

• ss -tulpn – toont de luisterende poorten (TCP en UDP) en de programma's die ze bezet houden.

Verplaats het programma naar een andere poort, of wijzig in de instellingen van de node Daemon Port, kopieer de nieuwe configuratie en herstart Wings.

De console van de server maakt geen verbinding#

In de browser verschijnt Failed to connect to websocket instance after multiple attempts: try refreshing the page. De browser kon FQDN:8080 niet bereiken. De oorzaken zijn dezelfde als bij het rode hartje, en daarnaast moet poort 8080 ook vanaf jouw computer werken, niet alleen vanaf het Panel. Open in de browser https://node.example.cz:8080. Laadt de pagina niet, dan zit het probleem in de firewall, de DNS of het certificaat.

De installatie van de server mislukt bij het downloaden#

In de console van de installatie staan meldingen als Could not resolve host. De containers hebben geen werkende DNS. Wings geeft ze standaard de servers 1.1.1.1 en 1.0.0.1. Zoek de DNS-servers van de VPS op met het commando resolvectl status (de regels DNS Servers), en als dat commando op Debian niet bestaat, in het bestand /etc/resolv.conf (de regels nameserver). Zet ze in /etc/pterodactyl/config.yml in plaats van de standaardwaarden (in het gedeelte docker: › network: › dns:). Gebruik het adres 127.0.0.53 niet, dat werkt alleen op de VPS zelf, niet in een container. Herstart daarna Wings: systemctl restart wings.

De server wordt niet aangemaakt, het Panel meldt te weinig ruimte of geheugen#

De som van het RAM of de schijfruimte van de servers zou Total Memory of Total Disk Space van de node overschrijden. Verhoog de waarden in de instellingen van de node (het tabblad Settings), als de VPS dat echt aankan, of verlaag de limieten van de servers.

De server gaat na een tijdje vanzelf uit#

De server heeft de schijflimiet overschreden (Wings stopt hem veilig) of heeft de console overspoeld met uitvoer (bescherming tegen overspoeling). Controleer in het Panel bij de server de schijfruimte en de uitvoer van de console vóór het uitschakelen.

Meer bronnen#

• Pterodactyl: Installing Wings (opent in een nieuw venster)
• Pterodactyl: Upgrading Wings (opent in een nieuw venster)
• Pterodactyl: Wings Additional Configuration (opent in een nieuw venster)
• Pterodactyl: Creating a New Node (opent in een nieuw venster)
• Pterodactyl: Creating SSL Certificates (opent in een nieuw venster)
• Cloudflare: Network ports (opent in een nieuw venster)