SFTP-opdrachtenoverzicht
Alle opdrachten van de OpenSSH-client sftp, met syntaxis en voorbeelden - verbinden, bladeren, overzetten, rechten en scripts voor batchgebruik. Werkt identiek op Windows 10 en 11, macOS en Linux, die allemaal de OpenSSH-client meeleveren.
Bijgewerkt juli 2026
Verbinding maken met een server
SFTP loopt over SSH (standaard poort 22), dus het aanmelden en de controle van de hostsleutel werken precies als bij ssh. Deze schakelaars zet je op de opdrachtregel voordat de sessie begint:
| Opdracht of schakelaar | Wat het doet | Voorbeeld |
|---|---|---|
sftp user@host | Een interactieve SFTP-sessie starten. | sftp alice@example.com |
-P port | Verbinden met een afwijkende poort (let op: hoofdletter P, anders dan bij ssh). | sftp -P 2222 alice@example.com |
-i keyfile | Aanmelden met een bepaalde persoonlijke SSH-sleutel. | sftp -i ~/.ssh/deploy_key alice@example.com |
-b file | Batchmodus - opdrachten uit een bestand uitvoeren zonder tussenkomst. | sftp -b upload.txt alice@example.com |
-r | get en put voor de hele sessie recursief maken. | sftp -r alice@example.com |
sftp user@host:path | Rechtstreeks een bestand ophalen en afsluiten (geen interactieve sessie). | sftp alice@example.com:/logs/app.log |
Wordt de verbinding geweigerd of blijft hij hangen, controleer de server dan eerst met de SFTP-verbindingstester, en kijk welke aanmeldmethoden hij aanvaardt met de controle van SFTP-aanmeldmethoden.
Downloaden en uploaden
| Opdracht | Wat het doet | Voorbeeld |
|---|---|---|
get | Een bestand van de server downloaden. | get report.pdf |
get -r | Een map met alles erin downloaden. | get -r backups |
put | Een lokaal bestand naar de server uploaden. | put site.zip |
put -r | Een map recursief uploaden. | put -r dist |
mget | Meerdere bestanden downloaden die op een patroon passen. | mget *.log |
mput | Meerdere bestanden uploaden die op een patroon passen. | mput *.html |
reget | Een half gedownload bestand hervatten. | reget big-backup.tar |
reput | Een half geüpload bestand hervatten. | reput big-backup.tar |
progress | De voortgangsmeter voor overdrachten aan- of uitzetten. | progress |
Er is geen schakelaar ascii of binary - SFTP zet bestanden altijd byte voor byte over, dus er raakt niets beschadigd door omzetting van regeleindes.
Batchmodus en scripts
Voor overdrachten zonder tussenkomst zet je de opdrachten in een bestand (één per regel) en draai je sftp in batchmodus. De batchmodus breekt af bij de eerste fout en vereist aanmelden met een sleutel - hij kan niet om een wachtwoord vragen:
# upload.txt cd /var/www/site lcd C:\Projects\site\dist put -r . bye C:\> sftp -b upload.txt -i C:\keys\deploy_key deploy@example.com
Dit werkt, maar elke terugkerende taak betekent een script, een sleutel en een regel in de Taakplanner onderhouden. Definieer je liever in een interface dat je "deze map elke nacht om 2:00 uploadt" - met nieuwe pogingen, meldingen en geschiedenis - dan is dat wat de geplande overdrachten van FTPie doen.
Over SFTP-opdrachten
SFTP (SSH File Transfer Protocol) is geen FTP-over-SSH - het is een apart protocol, gebouwd op de verbindingslaag van SSH en vastgelegd in de IETF-reeks draft-ietf-secsh-filexfer. De opdracht sftp in Windows, macOS en Linux is de clientimplementatie van OpenSSH, en die set opdrachten is wat deze pagina beschrijft. Doordat alles binnen SSH loopt, draagt één open poort (22) het aanmelden, de opdrachten en de versleutelde gegevens - geen poortbereiken voor passieve modus en geen TLS-certificaten om in te stellen.
Kom je van klassiek FTP? De sets opdrachten overlappen elkaar, maar verschillen op belangrijke punten - zie het FTP-opdrachtenoverzicht voor de opdrachten van ftp.exe en het protocol uit RFC 959.
Veelgestelde vragen
Nee. SFTP is een ander protocol dat over SSH loopt, en de set opdrachten lijkt erop maar is niet gelijk. Kernopdrachten als get, put, cd, ls en bye werken in allebei, maar SFTP voegt Unix-achtige opdrachten toe zoals chmod, ln en df, gebruikt reget en reput om overdrachten te hervatten, en kent geen ascii- of binary-modus - elke overdracht is binair. Opdrachten als mdelete, hash of literal uit klassieke FTP-clients bestaan niet in sftp.
Gebruik de schakelaar -r (recursief): get -r projectmap haalt een hele mappenboom op, en put -r projectmap zet er een neer. De doelmap mag nog geen botsende bestanden bevatten. Je kunt de sessie ook starten met sftp -r gebruiker@host om overdrachten standaard recursief te maken.
Gebruik reget bestandsnaam om een half gedownload bestand te hervatten en reput bestandsnaam voor een upload. Het gedeeltelijke bestand moet aan de ontvangende kant nog bestaan; sftp gaat verder waar het gestopt was in plaats van opnieuw te beginnen.
Ja. Windows 10 (versie 1809 en later) en Windows 11 leveren de OpenSSH-client mee, dus je kunt sftp gebruiker@host rechtstreeks vanuit de Opdrachtprompt of PowerShell draaien - zonder extra software. Dezelfde opdrachten van deze pagina werken identiek op Windows, macOS en Linux.
Zet één opdracht per regel in een tekstbestand en voer sftp -b batch.txt gebruiker@host uit. De batchmodus vereist aanmelden zonder tussenkomst, wat er in de praktijk op neerkomt dat je eerst aanmelden met een SSH-sleutel instelt. Voor terugkerende taken - geplande uploads, back-ups, synchronisaties - bespaart een client met een ingebouwde planner je het onderhoud van scripts en regels in de Taakplanner.
Liever een grafische SFTP-client?
FTPie is een moderne SFTP-client voor Windows met aanmelden via SSH-sleutel, controle van de hostsleutel, recursieve overdrachten met slepen en neerzetten, en een ingebouwde planner - gratis voor maximaal 3 serververbindingen.
Download FTPie Free