SFTP-toegang tot de gameserver – bestanden beheren

SFTP is de praktische manier om bestanden van je gameserver buiten het panel te beheren: configuraties aanpassen, plugins of mods uploaden, logs veiligstellen en werelden downloaden. Je hebt alleen een geschikte client nodig, de inloggegevens uit het dashboard en wat zorgvuldigheid bij het overschrijven van belangrijke bestanden.

Wat SFTP voor je gameserver doet

SFTP staat voor SSH File Transfer Protocol en verstuurt bestanden via een versleutelde verbinding. Voor gameservers is dat vooral handig, omdat je niet elke wijziging via een bestandsbeheerder in de browser hoeft te doen. Grote mappen, veel pluginbestanden of lokale back-ups kun je met een desktopclient meestal overzichtelijker beheren.

Belangrijk is het onderscheid: SFTP is niet hetzelfde als klassiek FTP. Als je client meerdere protocollen aanbiedt, kies je expliciet SFTP. FileZilla noemt SFTP in de officiële documentatie als ondersteund protocol; WinSCP beschrijft zichzelf officieel als client voor bestandsoverdrachten, onder andere via SFTP. Gebruik daarom de officiële downloads en vermijd onofficiële installers van externe sites.

Vereisten

Je hebt een actieve gameserver nodig, toegang tot je game-serverhosting-dashboard en een SFTP-client op je computer. Daarnaast moet je vóór riskante wijzigingen een back-up maken of in ieder geval de betreffende bestanden lokaal downloaden. Dat geldt vooral voor werelden, databases, serverconfiguraties en pluginmappen.

Als je net van een andere aanbieder komt, helpt de gids Gameserver verhuizen: van elke hoster naar game-serverhosting je met de volgorde van back-up, upload en controle. Voor Minecraft-specifieke uitbreidingen vult de gids Minecraft-plugins installeren en beheren – Spigot/Paper in het panel de SFTP-stappen aan met plugindetails.

SFTP-client installeren

Voor Windows is WinSCP vaak prettig, omdat interface, editorintegratie en synchronisatie duidelijk gescheiden zijn. FileZilla is platformonafhankelijk en werkt goed als je op Windows, macOS of Linux op een vergelijkbare manier wilt werken. Cyberduck is ook een optie als je een eenvoudige interface wilt.

Verbinding maken

Open je SFTP-client en maak een nieuwe verbinding aan. De waarden vind je in het dashboard van je server. Stuur ze niet via een screenshot naar anderen en sla wachtwoorden alleen op apparaten op die je vertrouwt.

Klik daarna op Verbinden. Bij de eerste verbinding kan je client om een hostsleutel vragen. Controleer of je met de juiste host verbindt en bevestig de sleutel alleen als de servergegevens kloppen. Daarna toont de client meestal twee gedeelten: links je lokale bestanden, rechts de bestanden op de gameserver.

Typische mappenstructuur

De exacte structuur hangt af van het spel en het gebruikte servertype. Veel setups zijn echter gebaseerd op een containermap zoals deze:

/home/container/
├── server.properties     # Serverconfig
├── plugins/              # Plugins (Paper/Spigot)
├── mods/                 # Mods (Forge/Fabric)
├── world/                # Spelwereld
├── logs/                 # Serverlogs
└── backups/              # Back-ups

Bewerk bestanden zo gericht mogelijk. Download eerst een configuratiebestand, pas het lokaal aan in een geschikte editor en upload het daarna weer. Let erop dat je geen bestandsextensies verandert. Van server.properties mag bijvoorbeeld niet per ongeluk server.properties.txt worden gemaakt.

Veelvoorkomende taken

• Config bewerken: Bestand downloaden → bewerken → uploaden
• Plugins installeren: JAR naar /plugins/ uploaden
• Back-ups downloaden: Map /world/ downloaden
• Logs controleren: latest.log downloaden

Bij plugins of mods moet je serverversie, loader en afhankelijkheden controleren voordat je bestanden uploadt. Een Paper-plugin hoort meestal in /plugins/, een Forge- of Fabric-mod in /mods/. Na het uploaden is meestal een herstart nodig, zodat de server het nieuwe bestand laadt.

Voor wereldback-ups is een duidelijke werkwijze aan te raden: server stoppen, wereldmap downloaden, lokale kopie zinvol benoemen en pas daarna grotere wijzigingen doen. Als de server tijdens het kopiëren actief schrijft, kan een back-up onvolledig of inconsistent worden.

Resultaat controleren

Na een wijziging controleer je eerst of de upload volledig is afgerond. Veel SFTP-clients tonen mislukte overdrachten in een wachtrij of foutentab. Daarna herstart je de gameserver indien nodig en controleer je de logs. Bij Minecraft is latest.log vaak het eerste punt om te bekijken, bij andere spellen zijn er eigen logbestanden in de betreffende servermap.

Test daarna in het spel of in het panel of de wijziging echt actief is. Een geüpload bestand alleen betekent nog niet dat het door de server is gelezen. Belangrijk is of de start zonder fouten doorloopt en de gewenste functie zichtbaar is.

Tips voor netjes werken

• Drag & drop: Bestanden eenvoudig via drag & drop overzetten
• Dubbelklik: Bestanden direct in de editor openen
• Synchroniseren: Sommige clients bieden mapsynchronisatie
• Sleutel-auth: SSH-keys in plaats van wachtwoord voor meer veiligheid

Werk toch gecontroleerd: synchronisatie kan lokale fouten snel naar de server overzetten. Als je veel bestanden vervangt, controleer dan vooraf de doelmap en de richting van de synchronisatie. Bij configuratiebestanden is een lokale kopie vóór elke wijziging verstandig.

Troubleshooting

Als de verbinding mislukt, controleer dan eerst protocol, host, poort, gebruikersnaam en wachtwoord. Een veelvoorkomende fout is dat per ongeluk FTP in plaats van SFTP wordt gekozen of dat de poort verkeerd wordt ingevuld. De standaardpoort die in veel Pterodactyl-setups wordt gebruikt is 2022; doorslaggevend zijn echter altijd de waarden uit je dashboard.

Als de upload afbreekt, kan de lokale verbinding instabiel zijn of kan de doelmap ontbreken. Herhaal de overdracht en let erop of je client een bestand slechts gedeeltelijk heeft geüpload. Verwijder bij twijfel het onvolledige doelbestand en upload het opnieuw.

Als de server na een wijziging niet start, zet dan het laatst werkende bestand terug of verwijder de laatst geüploade plugin of mod. Controleer daarna de logs. Voor basiswerk in de terminal rond serverbestanden helpt daarnaast de gids Linux-gameservercommando's – de belangrijkste terminalcommands.

Controle, grenzen en veilige weg terug

De handleiding „SFTP-toegang tot de gameserver – bestanden beheren“ geldt voor het in het artikel beschreven servertype en de versiestand die op het moment van controle zichtbaar was. Menunamen, beschikbare versies, mod- of plugincompatibiliteit en benodigde resources kunnen na updates afwijken. Neem daarom geen waarden ongecontroleerd over naar een andere game-, loader- of serverversie.

Maak vóór wijzigingen aan wereld, spelstand, configuratie of uitbreidingen een back-up van de betreffende bestanden. Wijzig daarna slechts één samenhangende stap en controleer die met dezelfde client- en serverversie waarmee je later wilt spelen.

Een geslaagde losse test is geen prestatie- of beschikbaarheidsgarantie. Wereldgrootte, mods, plugins, spelersaantal, netwerkroute en gelijktijdige belasting kunnen het resultaat veranderen. Documenteer versie, wijziging en testresultaat, zodat je latere afwijkingen kunt herleiden.

FAQ

Is SFTP veiliger dan FTP?

Ja, SFTP verstuurt bestanden via een versleutelde verbinding. Belangrijk blijft wel dat je inloggegevens beschermt, alleen betrouwbare clients gebruikt en opgeslagen wachtwoorden niet op gedeelde apparaten bewaart.

Welke SFTP-client moet ik gebruiken?

Neem de client waarmee je betrouwbaar kunt werken. FileZilla is platformonafhankelijk, WinSCP is op Windows erg populair, Cyberduck werkt op macOS en Windows. Download de client direct van de officiële website.

Moet ik de gameserver vóór elke upload stoppen?

Niet bij elk bestand. Voor logs of eenvoudige downloads is dat meestal niet nodig. Bij wereldmappen, databases, mods, plugins of centrale configuraties is stoppen of herstarten afhankelijk van de wijziging verstandig, zodat er niet tegelijk naar bestanden wordt geschreven.

Waarom zie ik mijn geüploade wijziging niet in het spel?

Mogelijke redenen zijn een ontbrekende herstart, een verkeerde doelmap, een incompatibele plugin- of modversie of een fout in de configuratie. Controleer eerst de upload, daarna de serverlogs en vervolgens de exacte padvermelding.

Kan ik volledige back-ups via SFTP downloaden?

Ja, je kunt mappen zoals /world/ of bestaande back-upmappen downloaden. Voor consistente back-ups van spelwerelden moet je de server vooraf stoppen of de back-upfunctie van je panel gebruiken, als die voor je server beschikbaar is.