SFTP verbinden

SFTP (Secure File Transfer Protocol) ist eine Möglichkeit, Dateien zwischen deinem Computer und deinem Server zu übertragen. Es ist schneller als der webbasierte Dateimanager, besonders für große Dateien oder viele Dateien gleichzeitig.

Warum SFTP verwenden?

Der webbasierte Dateimanager ist praktisch für schnelle Änderungen, aber SFTP hat Vorteile:

Schneller für große Uploads – Ganze Modpacks oder Welten hochladen geht viel flüssiger
Fortsetzbare Uploads – Wenn die Verbindung abbricht, kannst du dort weitermachen, wo du warst
Massenoperationen – Hunderte Dateien gleichzeitig verschieben
Synchronisation – Lokal bearbeiten und dann mit dem Server synchronisieren
Keine Dateigrößenbeschränkung – Der Dateimanager hat ein 100-MB-Limit, SFTP nicht

Verwende Dateimanager für: Schnelle Config-Edits, kleine Dateien, eine Datei auf einmal

Verwende SFTP für: Große Uploads, Welten, Modpacks, Massen-Dateioperationen

SFTP-Daten finden

Klicke auf deinen Server im Dashboard
Klicke in der Sidebar auf Einstellungen
Scrolle nach unten zum Abschnitt SFTP Details

Du siehst folgende Informationen:

Server Address – Die Adresse des SFTP-Servers (zum Beispiel sftp.hytalenode.nl)
Benutzername – Dein eindeutiger SFTP-Benutzername
Passwort – Dasselbe Passwort wie dein Panel-Login!
Port – Standard 2022 (nicht 22 wie bei normalem SFTP)

Wichtig: Dein SFTP-Passwort ist dasselbe wie dein Panel-Passwort. Änderst du dein Panel-Passwort? Dann ändert sich auch automatisch dein SFTP-Passwort.

SFTP-Client installieren

Du brauchst ein SFTP-Programm, um zu verbinden. Zwei beliebte kostenlose Optionen:

FileZilla (empfohlen für Einsteiger)

Plattform: Windows, Mac, Linux
Download: filezilla-project.org
Kostenlos und benutzerfreundlich

WinSCP (nur Windows)

Plattform: Windows
Download: winscp.net
Kostenlos, extra Features für Fortgeschrittene

Für diese Anleitung verwenden wir FileZilla, aber die Schritte sind für andere Clients ähnlich.

Mit FileZilla verbinden

Nach der Installation von FileZilla:

Öffne FileZilla
Klicke oben auf Datei > Servermanager (oder drücke Strg+S)
Klicke unten links auf Neuer Server
Gib der Site einen Namen, zum Beispiel „Mein HytaleNode Server“
Trage rechts die Daten ein:
- Protokoll: SFTP - SSH File Transfer Protocol
- Host: sftp.hytalenode.nl (oder was bei Server Address steht)
- Port: 2022
- Anmeldetyp: Normal
- Benutzer: Dein SFTP-Benutzername aus dem Panel
- Passwort: Dein Panel-Passwort
Klicke auf Verbinden

Erste Verbindung – Host-Key-Warnung

Beim ersten Verbinden erhältst du eine Warnung über den „Host Key“. Das ist normal und bedeutet, dass FileZilla den Server noch nicht kennt.

Aktiviere: „Diesem Host immer vertrauen, diesen Schlüssel hinzufügen...“
Klicke auf OK

Du bist jetzt verbunden! Du siehst:

Links – Dein lokaler Computer (deine eigenen Dateien)
Rechts – Dein Server (alle Serverdateien)

Dateien mit SFTP hochladen

Es funktioniert sehr intuitiv, genau wie Dateien zwischen Ordnern kopieren:

Links: Navigiere zum Ordner auf deinem Computer, in dem die Datei liegt
Rechts: Navigiere zum Ordner auf deinem Server, in den du hochladen möchtest
Klicke die Datei an und ziehe sie von links nach rechts
Oder: Rechtsklick auf eine Datei/einen Ordner links und wähle Hochladen

Unten siehst du einen Fortschrittsbalken mit Upload-Status und Geschwindigkeit.

Beispiele:

Plugin hochladen

Lade die Plugin-.jar auf deinen Computer herunter
In FileZilla links: Navigiere zu deinem Downloads-Ordner
In FileZilla rechts: Navigiere zu /plugins
Ziehe die .jar von links nach rechts
Fertig! Starte deinen Server neu, um das Plugin zu laden

Welt hochladen

Entpacke deinen Weltordner lokal (falls es eine .zip ist)
Links: Navigiere dorthin, wo der Weltordner liegt
Rechts: Navigiere zum Server-Root (/)
Ziehe den gesamten Weltordner nach rechts
Warte, bis alle Dateien hochgeladen sind (kann bei großen Welten eine Weile dauern!)

Dateien mit SFTP herunterladen

Umgekehrt funktioniert es genauso:

Rechts: Navigiere zur Datei auf deinem Server
Links: Navigiere dorthin, wo du sie lokal speichern möchtest
Ziehe die Datei von rechts nach links
Oder: Rechtsklick rechts und wähle Herunterladen

Beispiel: Welt-Backup herunterladen

Rechts: Navigiere zu /world
Rechtsklick auf den Ordner world
Wähle Herunterladen
Links: Wähle, wo du speichern möchtest
Die gesamte Welt wird jetzt auf deinen Computer heruntergeladen

Dateien über SFTP bearbeiten

FileZilla hat einen praktischen integrierten Editor:

Rechtsklick auf eine Textdatei (zum Beispiel server.properties)
Wähle Ansehen/Bearbeiten
Die Datei öffnet sich in deinem Standard-Texteditor
Nimm deine Änderungen vor
Speichern (Strg+S)
FileZilla fragt: „Die Datei wurde geändert, erneut hochladen?“
Klicke Ja
Die Datei wird automatisch zurück auf den Server hochgeladen

Tipp: Für YAML/JSON-Dateien verwendest du besser einen guten Editor wie Notepad++ (Windows) oder VSCode für Syntax-Highlighting.

Ordner synchronisieren (fortgeschritten)

Möchtest du einen lokalen Ordner mit deinem Server synchronisieren? FileZilla kann das!

Rechtsklick auf einen Ordner rechts (Server)
Wähle Synchronisiertes Durchsuchen
Wähle den entsprechenden lokalen Ordner
Wenn du jetzt rechts in einen Ordner gehst, geht FileZilla automatisch im selben Ordner links
Praktisch zum Synchronisieren von z. B. Plugin-Configs zwischen lokaler Entwicklung und Server

Verbindung speichern

Wenn du über den Servermanager verbunden hast (siehe oben), wird deine Verbindung automatisch gespeichert. Beim nächsten Mal:

Öffne FileZilla
Klicke auf das Dropdown-Menü neben dem Servermanager-Symbol
Wähle deine gespeicherte Site
Sofort verbunden!

Oder verwende Quickconnect (nicht empfohlen):

Trage oben in der Leiste ein: Host, Benutzername, Passwort, Port
Klicke Quickconnect
Du musst das jedes Mal neu eingeben – deshalb ist der Servermanager praktischer

Probleme beheben

Kann nicht verbinden – „Connection timed out“

Prüfe, ob du die richtige Adresse und den richtigen Port hast (oft sftp.hytalenode.nl:2022)
Achtung: Port 2022, nicht 22!
Kontrolliere deine Firewall – ist SFTP-Traffic erlaubt?
Probiere es von einem anderen Netzwerk (zum Beispiel mobiler Hotspot)

„Authentication failed“ oder falsches Passwort

Dein SFTP-Passwort ist dasselbe wie dein Panel-Passwort
Versuche erneut, dich im Panel anzumelden, um dein Passwort zu prüfen
Achte auf Groß-/Kleinschreibung
Hast du kürzlich dein Panel-Passwort geändert? Aktualisiere es in FileZilla

„Permission denied“ beim Hochladen

Du versuchst, in einen Ordner zu schreiben, für den du keine Rechte hast
Lade nur in dein eigenes Server-Verzeichnis hoch (/ und Unterordner)
Versuche nicht, in Systemordner zu schreiben

Upload stockt oder ist sehr langsam

Große Uploads können lange dauern – sei geduldig
Prüfe deine Internetgeschwindigkeit (Upload-Geschwindigkeit ist oft viel niedriger als Download!)
Probiere es zu einem anderen Zeitpunkt, wenn das Netzwerk ruhig ist
Für sehr große Dateien (10 GB+): Lade nachts hoch und lass es laufen