SFTP verbinden
SFTP (Secure File Transfer Protocol) is een manier om bestanden tussen je computer en je server over te zetten. Het is sneller dan de web-gebaseerde File Manager, vooral voor grote bestanden of veel bestanden tegelijk.
Waarom SFTP gebruiken?
De web File Manager is handig voor snelle wijzigingen, maar SFTP heeft voordelen:
- Sneller voor grote uploads - Hele modpacks of werelden uploaden gaat veel vlotter
- Hervatbare uploads - Als je verbinding wegvalt, kun je doorgaan waar je was
- Bulk operaties - Honderden bestanden tegelijk verplaatsen
- Synchronisatie - Lokaal bewerken en dan syncen naar de server
- Geen bestandsgrootte limiet - De File Manager heeft een 100MB limiet, SFTP niet
Gebruik File Manager voor: Snelle config edits, kleine bestanden, één bestand tegelijk
Gebruik SFTP voor: Grote uploads, werelden, modpacks, mass bestand operaties
SFTP gegevens vinden
- Klik op je server in het dashboard
- Klik in de sidebar op Instellingen
- Scroll naar beneden tot de sectie SFTP Details
Je ziet de volgende informatie:
- Server Address - Het adres van de SFTP server (bijvoorbeeld
sftp.hytalenode.nl) - Gebruikersnaam - Je unieke SFTP gebruikersnaam
- Wachtwoord - Hetzelfde wachtwoord als je paneel login!
- Poort - Standaard 2022 (niet 22 zoals bij normale SFTP)
Belangrijk: Je SFTP wachtwoord is hetzelfde als je paneel wachtwoord. Wijzig je paneel wachtwoord? Dan wijzigt je SFTP wachtwoord ook automatisch.
SFTP client installeren
Je hebt een SFTP programma nodig om te verbinden. Twee populaire gratis opties:
FileZilla (aanbevolen voor beginners)
- Platform: Windows, Mac, Linux
- Download: filezilla-project.org
- Gratis en gebruiksvriendelijk
WinSCP (alleen Windows)
- Platform: Windows
- Download: winscp.net
- Gratis, extra features voor gevorderden
Voor deze gids gebruiken we FileZilla, maar de stappen zijn vergelijkbaar voor andere clients.
Verbinden met FileZilla
Na installatie van FileZilla:
- Open FileZilla
- Klik bovenaan op Bestand > Sitebeheer (of druk Ctrl+S)
- Klik linksonder op Nieuwe site
- Geef de site een naam, bijvoorbeeld "Mijn HytaleNode Server"
- Vul rechts de gegevens in:
- Protocol: SFTP - SSH File Transfer Protocol
- Host:
sftp.hytalenode.nl(of wat er bij Server Address staat) - Poort:
2022 - Inlogtype: Normaal
- Gebruiker: Je SFTP gebruikersnaam uit het paneel
- Wachtwoord: Je paneel wachtwoord
- Klik op Verbinden
Eerste verbinding - Host key waarschuwing
De eerste keer dat je verbindt, krijg je een waarschuwing over de "host key". Dit is normaal en betekent dat FileZilla de server nog niet kent.
- Vink aan: "Altijd deze host vertrouwen, deze sleutel toevoegen..."
- Klik op OK
Je bent nu verbonden! Je ziet:
- Links - Je lokale computer (je eigen bestanden)
- Rechts - Je server (alle server bestanden)
Bestanden uploaden met SFTP
Het werkt heel intuïtief, net als bestanden kopiëren tussen mappen:
Je ziet onderaan een voortgangsbalk met de upload status en snelheid.
Voorbeelden:
Plugin uploaden
- Download de plugin .jar naar je computer
- In FileZilla links: navigeer naar je Downloads map
- In FileZilla rechts: navigeer naar
/plugins - Sleep de .jar van links naar rechts
- Klaar! Herstart je server om de plugin te laden
Wereld uploaden
- Pak je wereld map lokaal uit (als het een .zip is)
- Links: navigeer naar waar de wereld map staat
- Rechts: navigeer naar de server root (
/) - Sleep de hele wereld map naar rechts
- Wacht tot alle bestanden zijn geüpload (kan even duren voor grote werelden!)
Bestanden downloaden met SFTP
Andersom werkt precies hetzelfde:
Voorbeeld: Wereld backup downloaden
Bestanden bewerken via SFTP
FileZilla heeft een handige ingebouwde editor:
- Rechtsklik op een tekstbestand (bijvoorbeeld
server.properties) - Kies Bekijken/Bewerken
- Het bestand opent in je standaard teksteditor
- Maak je wijzigingen
- Sla op (Ctrl+S)
- FileZilla vraagt: "Het bestand is gewijzigd, opnieuw uploaden?"
- Klik Ja
- Het bestand wordt automatisch terug geüpload naar de server
Tip: Voor YAML/JSON bestanden gebruik je beter een goede editor zoals Notepad++ (Windows) of VSCode voor syntax highlighting.
Mappen synchroniseren (geavanceerd)
Wil je een lokale map syncen met je server? FileZilla kan dit!
- Rechtsklik op een map rechts (server)
- Kies Gesynchroniseerd bladeren
- Selecteer de overeenkomstige lokale map
- Nu wanneer je in een map gaat rechts, gaat FileZilla automatisch in dezelfde map links
- Handig voor het syncen van bijvoorbeeld plugin configs tussen lokaal ontwikkelen en server
Verbinding opslaan
Als je via Sitebeheer hebt verbonden (zie boven), wordt je verbinding automatisch opgeslagen. De volgende keer:
- Open FileZilla
- Klik op het dropdown menu naast het Sitebeheer icoon
- Kies je opgeslagen site
- Direct verbonden!
Of gebruik Quickconnect (niet aanbevolen):
- Vul bovenaan in de balk in: Host, Gebruikersnaam, Wachtwoord, Poort
- Klik Quickconnect
- Je moet dit elke keer opnieuw invullen - daarom is Sitebeheer handiger
Problemen oplossen
Kan niet verbinden - "Connection timed out"
- Check of je het juiste adres en poort hebt (vaak
sftp.hytalenode.nl:2022) - Let op: poort 2022, niet 22!
- Controleer je firewall - staat SFTP verkeer toe?
- Probeer vanaf een ander netwerk (bijvoorbeeld mobiele hotspot)
"Authentication failed" of verkeerd wachtwoord
- Je SFTP wachtwoord is hetzelfde als je paneel wachtwoord
- Probeer opnieuw in te loggen op het paneel om je wachtwoord te checken
- Let op hoofdletters/kleine letters
- Heb je recent je paneel wachtwoord gewijzigd? Update het in FileZilla
"Permission denied" bij uploaden
- Je probeert te schrijven in een map waar je geen rechten hebt
- Upload alleen in je eigen server directory (
/en submappen) - Probeer niet in systeem mappen te schrijven
Upload stagneert of gaat heel langzaam
- Grote uploads kunnen lang duren - wees geduldig
- Check je internet snelheid (upload speed is vaak veel lager dan download!)
- Probeer op een ander moment als het netwerk rustig is
- Voor zeer grote bestanden (10GB+): upload 's nachts en laat het draaien
Verbinding valt steeds weg
- FileZilla instellingen: Bewerken > Instellingen > Verbinding