SFTP (Secure File Transfer Protocol) ermöglicht es Ihnen, sich mit Ihrem Gameserver zu verbinden und Dateien direkt von Ihrem Computer zu übertragen — einschließlich großer Dateien, vollständiger Mod-Ordner und Backups. Wenn Sie etwas hochladen müssen, das der GPanel-Dateimanager nicht verarbeiten kann (z.B. ganze Verzeichnisse oder Dateien über dem Browser-Größenlimit), ist SFTP das richtige Werkzeug.
Wann SFTP verwenden: Verwenden Sie SFTP, wenn Sie Ordner, große Dateien (z.B. Weltspeicherstände, Mod-Pakete, Backups) oder mehrere Dateien gleichzeitig hochladen müssen. Für schnelle einzelne Dateibearbeitungen kann der GPanel-Dateimanager ausreichend sein.
Verbindungsdaten
Ihre SFTP-Verbindung verwendet die IP-Adresse Ihres Servers und die Anmeldedaten aus GPanel.
Ihre SFTP-Verbindungsdaten
| Host / Adresse | Die IP-Adresse Ihres Servers (angezeigt auf dem GPanel-Dashboard oder im Console-Tab) |
|---|---|
| Port | 2022 |
| Protokoll | SFTP (SSH File Transfer Protocol) |
| Benutzername | Ihr GPanel-Benutzername |
| Passwort | Zu finden im Tab Settings in GPanel |
Wichtig: Verwenden Sie immer Port 2022, nicht den Standard-SFTP-Port 22. Verbindungen über Port 22 funktionieren nicht.
Option 1 — FileZilla (Empfohlen)
FileZilla ist ein kostenloser, plattformübergreifender FTP/SFTP-Client, verfügbar für Windows, macOS und Linux.
Schritt 1 — FileZilla herunterladen und installieren
- Gehen Sie zu filezilla-project.org und laden Sie den FileZilla Client herunter (nicht FileZilla Server).
- Führen Sie das Installationsprogramm aus und folgen Sie den Bildschirmanweisungen.
Schritt 2 — Den Servermanager öffnen
- Starten Sie FileZilla.
- Klicken Sie auf File → Site Manager (oder drücken Sie Ctrl+S).
- Klicken Sie auf New Site und geben Sie einen Namen ein, z.B. Legion Hosting.
Schritt 3 — Verbindungseinstellungen eingeben
- Setzen Sie Protocol auf
SFTP - SSH File Transfer Protocol. - Setzen Sie Host auf die IP-Adresse Ihres Servers (zu finden auf dem GPanel-Dashboard).
- Setzen Sie Port auf
2022. - Setzen Sie Logon Type auf
Normal. - Geben Sie Ihren GPanel-Benutzernamen und Ihr Passwort ein (das Passwort finden Sie im Tab Settings in GPanel).
- Klicken Sie auf Connect.
Schritt 4 — Den Host-Schlüssel akzeptieren
- Bei der ersten Verbindung zeigt FileZilla einen Dialog Unknown host key an.
- Aktivieren Sie Always trust this host und klicken Sie auf OK.
Schritt 5 — Dateien hochladen
- Das linke Panel zeigt Ihren lokalen Computer. Navigieren Sie zu den Dateien oder Ordnern, die Sie hochladen möchten.
- Das rechte Panel zeigt das Dateisystem Ihres Servers. Navigieren Sie zum Zielordner (z.B.
/home/container/mods/). - Ziehen Sie Dateien oder Ordner per Drag & Drop vom linken zum rechten Panel, oder klicken Sie mit der rechten Maustaste auf eine Datei und wählen Sie Upload.
- Überwachen Sie den Übertragungsfortschritt im unteren Warteschlangen-Panel.
Option 2 — WinSCP (nur Windows)
WinSCP ist ein beliebter kostenloser SFTP-Client für Windows mit einer vertrauten Zwei-Panel-Dateiexplorer-Oberfläche.
Schritt 1 — WinSCP herunterladen und installieren
- Gehen Sie zu winscp.net und laden Sie das Installationsprogramm herunter.
- Führen Sie das Installationsprogramm aus. Wenn Sie nach einem Oberflächenstil gefragt werden, wählen Sie Commander für eine Zwei-Panel-Ansicht oder Explorer, wenn Sie eine Einzel-Panel-Ansicht bevorzugen.
Schritt 2 — Eine neue Sitzung erstellen
- Starten Sie WinSCP. Der Login-Dialog öffnet sich automatisch.
- Setzen Sie File protocol auf
SFTP. - Geben Sie die IP-Adresse Ihres Servers im Feld Host name ein (zu finden auf dem GPanel-Dashboard).
- Setzen Sie Port number auf
2022. - Geben Sie Ihren GPanel-Benutzernamen und Ihr Passwort ein (das Passwort finden Sie im Tab Settings in GPanel).
- Klicken Sie auf Login.
Schritt 3 — Host-Schlüssel akzeptieren und hochladen
- Akzeptieren Sie die Host-Schlüssel-Warnung bei der ersten Verbindung.
- Ihre lokalen Dateien erscheinen links; die Serverdateien rechts.
- Navigieren Sie zu Ihrem Zielordner auf dem Server, und ziehen Sie dann Dateien vom linken zum rechten Panel, oder verwenden Sie F5, um ausgewählte Dateien zu kopieren.
Häufige Upload-Aufgaben
Eine Konfigurationsdatei hochladen
Konfigurationsdateien (z.B. servertest.ini, server.properties) befinden sich normalerweise in einem bestimmten Unterordner des Home-Verzeichnisses Ihres Servers. Häufige Pfade:
- Project Zomboid:
/home/container/.cache/server/ - ARK: Survival Ascended:
/home/container/ShooterGame/Saved/Config/WindowsServer/ - Minecraft:
/home/container/
Navigieren Sie zum richtigen Pfad in Ihrem SFTP-Client und ziehen Sie dann Ihre bearbeitete Konfigurationsdatei auf das Server-Panel, um die vorhandene Datei zu ersetzen.
Stoppen Sie zuerst den Server, bevor Sie aktive Konfigurationsdateien ersetzen. Das Hochladen einer Konfiguration während der Server läuft, kann dazu führen, dass der Server Ihre Datei beim Herunterfahren überschreibt.
Mods hochladen
- Stoppen Sie Ihren Server über GPanel.
- Verbinden Sie sich per SFTP und navigieren Sie zum Mods-Ordner Ihres Spiels (z.B.
/home/container/mods/oder dem spielspezifischen Pfad). - Ziehen Sie den gesamten Mod-Ordner oder die
.jar- /.pak-Datei von Ihrem lokalen Computer in das Server-Mods-Verzeichnis. - Starten Sie den Server über GPanel, sobald der Upload abgeschlossen ist.
Einen Weltspeicherstand oder ein Backup hochladen
- Stoppen Sie Ihren Server über GPanel.
- Verbinden Sie sich per SFTP und navigieren Sie zum Speicherverzeichnis für Ihr Spiel.
- Laden Sie den gesamten Speicherordner hoch (ziehen Sie den Ordner selbst, nicht nur seinen Inhalt, es sei denn, Sie möchten ihn mit einem vorhandenen Speicherstand zusammenführen).
- Bestätigen Sie, dass die Ordnerstruktur mit der vorherigen übereinstimmt.
- Starten Sie den Server über GPanel.
Tipp: Bevor Sie einen Speicherstand überschreiben, benennen Sie den vorhandenen serverseitigen Ordner zuerst um (z.B. fügen Sie
_backup am Ende hinzu), damit Sie ihn wiederherstellen können, falls etwas schiefgeht.
Fehlerbehebung
- Überprüfen Sie, ob der Port auf 2022 eingestellt ist, nicht auf 22.
- Stellen Sie sicher, dass die IP-Adresse mit der auf Ihrem GPanel-Dashboard angezeigten übereinstimmt.
- Stellen Sie sicher, dass Ihr Server läuft — der SFTP-Zugriff kann bei einigen Tarifen erfordern, dass der Gameserver-Prozess aktiv ist.
- Überprüfen Sie, ob Ihre Firewall oder Ihr Antivirenprogramm ausgehende Verbindungen auf Port 2022 blockiert.
- Verwenden Sie denselben Benutzernamen und dasselbe Passwort, mit dem Sie sich bei gpanel.legionhosting.net anmelden.
- Benutzernamen sind Groß-/Kleinschreibung-sensitiv. Kopieren Sie den Benutzernamen direkt aus GPanel, wenn Sie unsicher sind.
- Wenn Sie kürzlich Ihr GPanel-Passwort geändert haben, aktualisieren Sie es in der gespeicherten Sitzung Ihres SFTP-Clients.
- Setzen Sie Ihr GPanel-Passwort über den Kundenbereich zurück, wenn Sie es vergessen haben.
- Große Mod-Pakete oder Weltspeicherstände können mehrere Minuten dauern. Lassen Sie die Übertragung vollständig abschließen.
- In FileZilla können Sie die Anzahl gleichzeitiger Übertragungen erhöhen: Gehen Sie zu Edit → Settings → Transfers und setzen Sie die maximale Anzahl gleichzeitiger Übertragungen auf 3.
- Wenn die Verbindung während der Übertragung abbricht, kann FileZilla fortsetzen: Klicken Sie mit der rechten Maustaste auf die fehlgeschlagene Datei in der Warteschlange und wählen Sie Reset and requeue failed transfers.
- Ihr Home-Verzeichnis ist
/home/container/. Wenn der Client Sie in ein anderes Verzeichnis leitet, geben Sie diesen Pfad manuell in die Remote-Pfadleiste ein. - Stellen Sie sicher, dass Sie mit dem richtigen Benutzernamen verbunden sind — jedes GPanel-Konto hat nur Zugriff auf die Dateien des eigenen Servers.
Brauchen Sie noch Hilfe? Erstellen Sie ein Support-Ticket und geben Sie Ihre Server-IP-Adresse, den verwendeten SFTP-Client und eine Beschreibung des Fehlers an.
