Mit SFTP überträgst du Dateien über eine verschlüsselte SSH-Verbindung. Für den Zugang brauchst du die SFTP-Angaben, die dein Server-Panel oder Anbieter für genau diesen Server nennt. Prüfe beim ersten Verbindungsaufbau zusätzlich den SSH-Hostschlüssel. Vor Änderungen an Welt- oder Konfigurationsdateien gehören eine heruntergeladene Sicherung und ein nach dokumentiertem Weg gestoppter Server dazu. (OpenSSH: sftp(1))
Die richtigen Verbindungsdaten verwenden
Öffne die Serveransicht und suche dort nach den Datei- oder SFTP-Angaben. Übernimm Hostname, Port, Benutzername und angebotene Anmeldeart genau so, wie sie für den Server angezeigt werden. Es gibt keinen allgemeingültigen Gameserver-Port oder eine feste Adresse: In Pterodactyl ist der SFTP-Port zum Beispiel eine eigene Einstellung am Node. Verwende deshalb weder den Port deines Spiels noch automatisch die Adresse der Panel-Webseite. (Pterodactyl: Node einrichten)
Panel-Webseite und SFTP-Client sind zwei unterschiedliche Zugangswege. Die E-Mail-Adresse für den Weblogin ist nicht automatisch der SFTP-Benutzername. Ob ein Konto-Passwort auch für SFTP gilt oder ein Schlüssel beziehungsweise eine besondere SFTP-Angabe nötig ist, hängt von der Einrichtung ab. FileZilla weist ebenfalls darauf hin, dass Benutzername und Passwort vom üblichen Website-Login abweichen können. Richte dich nach den Angaben des Panels oder frage den Anbieter, statt Zugangsdaten zu erraten oder eine Sicherheitsfunktion abzuschalten. (FileZilla: Verbindung zu einem SFTP-Server herstellen)
Wähle im Client ausdrücklich SFTP. In einem Terminal mit OpenSSH sieht eine Verbindung beispielsweise so aus:
sftp -P PORT BENUTZER@HOST
Ersetze PORT, BENUTZER und HOST durch die für deinen Server angezeigten Werte. -P setzt den Zielport. SFTP ist nicht dasselbe wie FTP oder FTPS; OpenSSH führt SFTP über SSH aus. (OpenSSH: sftp(1))
Beim ersten Verbindungsaufbau zeigt der Client den Fingerabdruck des Server-Hostschlüssels. Vergleiche ihn mit einem Fingerabdruck, den der Anbieter über einen unabhängigen, vertrauenswürdigen Weg bestätigt. Erst wenn der Wert übereinstimmt, bestätigst du die Verbindung. Bei einer unerwarteten Warnung oder einem später geänderten Schlüssel brich ab und lass die Änderung zuerst prüfen. Klicke die Warnung nicht einfach weg und lösche einen gespeicherten Schlüssel nicht, um die Prüfung zu umgehen. (FileZilla Pro: Hostschlüssel validieren)
Vor Änderungen sichern und sauber stoppen
Für den Download einer statischen Datei musst du den Server nicht zwingend stoppen. Wenn du eine aktive Welt vollständig herunterladen oder ersetzen willst, nutze zuerst den vom Spiel dokumentierten Speichervorgang, sofern es einen gibt, und stoppe den Server danach über den vorgesehenen normalen Weg. Warte, bis das Panel den Server als gestoppt anzeigt, bevor du eine vollständige Weltkopie erstellst oder Weltdateien herunter- beziehungsweise hochlädst. Während des Betriebs kann eine solche Kopie uneinheitlich sein. Eine Panel-Sicherung ist erst dann eine brauchbare zusätzliche Kopie, wenn sie erfolgreich abgeschlossen wurde und du sie herunterladen kannst. Bewahre die heruntergeladene Sicherung getrennt vom Server auf. Für einzelne Dateien kannst du zusätzlich die unveränderte Originaldatei per SFTP auf deinen Computer laden. Die Anleitung zum Minecraft-Server-Backup erklärt, wie du eine Sicherung prüfst.
Verwende kein erzwungenes Beenden als normalen Weg. Welche Stopplogik gilt, kann je nach Spielserver unterschiedlich konfiguriert sein; ein Chat-Befehl wie /stop funktioniert nicht bei jedem Spiel. Ein Stopp ersetzt ausserdem kein Backup. (Pelican: Egg und Stop Command)
Dateien übertragen und Rücklesen
Prüfe vor dem Upload im Client den entfernten Arbeitsordner mit pwd und ls. So reduzierst du das Risiko, eine gleichnamige Datei im falschen Server oder Verzeichnis zu ersetzen. Im OpenSSH-Client bedeuten get einen Download vom Server und put einen Upload vom eigenen Gerät. (OpenSSH: sftp(1))
Bearbeite die heruntergeladene Kopie lokal und ändere nur die nötigen Einstellungen. Ersetze nicht die ganze Konfigurationsdatei durch ein Beispiel aus einem Forum: Dabei gehen leicht individuelle Werte verloren. Manche Game-Server-Panels verwalten bestimmte Einstellungen selbst und schreiben sie beim Start in Dateien. Pelican beschreibt solche panelgesteuerten Konfigurationsfelder für Eggs; wenn eine Einstellung aus dem Panel stammt, ändere sie dort nach der passenden Dokumentation statt die Datei dauerhaft zu übersteuern. (Pelican: Konfigurationsdateien in Eggs)
Lade die bearbeitete Datei nur in das vorgesehene Verzeichnis. Falls dein Client eine Datei unter einem vorläufigen Namen hochladen kann, prüfe diese Kopie zuerst und ersetze das Original erst danach. Bewahre die getrennte Originaldatei auf, bis der Server wieder läuft. Lade die Datei nach dem Upload erneut herunter oder öffne sie im Panel und lies den tatsächlichen Serverstand zurück. Prüfe Dateiname, Ordner und geänderte Zeilen. Eine angezeigte Erfolgsmeldung allein beweist nicht, dass du die richtige Datei geändert hast.
Starte den Server erst nach der Rückleseprüfung. Kontrolliere in der Konsole, ob die erwartete Version oder Einstellung geladen wurde. Wenn ein Fehler auftritt, stoppe den Server wieder und stelle gezielt die gesicherte Datei oder Sicherung wieder her. Die getrennten Anleitungen für Plugins und Mods zeigen, welche Dateien zu diesen Änderungen gehören.
Wenn die Verbindung oder der Upload scheitert
- Zeitüberschreitung oder Verbindungsfehler: Prüfe Host und SFTP-Port in den Serverdetails. Der Port der Spielverbindung ist nicht automatisch der SFTP-Port.
- Anmeldung abgelehnt: Kontrolliere SFTP-Benutzername und die ausdrücklich vorgesehene Passwort- oder Schlüsselanmeldung. Teile weder Passwort noch privaten Schlüssel im Ticket oder Chat.
- Hostschlüssel unbekannt oder geändert: Halte an und bitte den Anbieter, den Fingerabdruck über einen unabhängigen Weg zu bestätigen. Bei einem abweichenden Fingerabdruck nicht anmelden.
- Zugriff verweigert oder Ordner fehlt: Prüfe, ob du im richtigen Serververzeichnis bist und ob dein Konto dort schreiben darf. Setze keine pauschalen Dateirechte wie
777; frage bei fehlenden Rechten den Anbieter.
Wenn dir SFTP-Daten oder ein bestätigter Hostschlüssel fehlen, kläre das über den Kontaktweg. Sende keine Zugangsdaten mit.