sftp-commando: verbinden, bestanden overzetten met put en get en batchmodus gebruiken

TestomgevingRHEL-familieAlmaLinux 9.8gewoon gebruikersaccount
Netwerkcommando'ssftpLocatie/usr/bin/sftp
Uploaden en downloaden van serverbestanden gecontroleerd

Het sftp-commando is het bestandsoverdrachtsprogramma van OpenSSH dat bestanden uitwisselt met een server waarmee via SSH is verbonden: na het verbinden wordt bij de prompt sftp> tussen externe mappen gewisseld, met put geüpload en met get opgehaald. Op een AlmaLinux 9-testserver is met sleutelauthenticatie verbonden, zijn bestanden en mappen uitgewisseld en is ook een -b batchbestand uitgevoerd: bestanden met dezelfde naam werden zonder vraag overschreven, en de batch stopte ter plekke zodra een commando halverwege mislukte en eindigde met exitcode 1.

De uitvoer hieronder is letterlijk het resultaat op een AlmaLinux 9-testserver waarop de accounts user1 en admin1 zijn aangemaakt en waarbij vanuit admin1 via localhost is verbonden met user1 op dezelfde server. De verbindingsnaam server is een voorbeeldnaam die in de SSH-configuratie van admin1 zo is ingesteld dat hij naar 127.0.0.1 verwijst, daarom staat in foutregels 127.0.0.1. Ook de account- en bestandsnamen zijn voorbeeldwaarden, en bij een echte externe server komt op de plek van server het adres of de naam van die server.

1️⃣ Verbinden met het sftp-commando

Staat na sftp [account@server], dan wordt via SSH verbonden en verschijnt daarna de prompt sftp>. Op de testserver was de onder admin1 gemaakte ed25519-sleutel geregistreerd in authorized_keys van user1, waardoor niet om een wachtwoord werd gevraagd.

sftp user1@server
The authenticity of host 'server (127.0.0.1)' can't be established.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added 'server' (ED25519) to the list of known hosts.
Connected to server.
sftp> pwd
Remote working directory: /home/user1
sftp> bye

Bij een server waarmee voor het eerst wordt verbonden, verschijnt een vraag om de hostsleutel te controleren, en op het echte scherm volgt na de eerste regel nog een regel met de vingerafdruk van de sleutel, die per server verschilt (in het kader hierboven weggelaten). Na het invoeren van yes werd de server aan known_hosts toegevoegd, en na de regel [Connected to server.] verscheen de prompt sftp>.

pwd toont de externe werkmap. De sftp-verbinding wordt beëindigd met bye, en exit en quit doen hetzelfde als bye.

Bij een account zonder geregistreerde sleutel vraagt de server bij het verbinden om het wachtwoord, en in interactieve modus wordt het bij deze vraag direct ingevoerd. Op de testserver is voor user1 een tijdelijk wachtwoord ingesteld terwijl de sleutel van admin1 niet was geregistreerd, en daarna is hetzelfde commando uitgevoerd.

sftp user1@server
user1@server's password:
Connected to server.

Het ingevoerde wachtwoord verscheen niet op het scherm, en na de regel [Connected to server.] verscheen de prompt sftp>.

Bij een server waarvan de SSH-poort is gewijzigd in een ander nummer dan 22, wordt het poortnummer opgegeven met -P. Op de testserver is nog een SSH-server gestart op poort 2222, waarna met -P 2222 is verbonden.

sftp -P 2222 user1@server
Connected to server.
sftp> pwd
Remote working directory: /home/user1
sftp> bye

-P voor de poort is een hoofdletter, en de kleine -p is de optie die de wijzigingstijd en rechten van het bestand behoudt.

Is het sleutelbestand onder een andere naam dan de standaardnaam gemaakt, dan wordt het privésleutelbestand opgegeven met -i. Hieronder staat het resultaat van verbinden met user1_key waarbij alleen pwd en bye zijn uitgevoerd. -b - is de batchmodus die commando's van de standaardinvoer leest, en is hier alleen gebruikt om het resultaat van de verbinding te controleren.

sftp -i ~/.ssh/user1_key -b - user1@server
sftp> pwd
Remote working directory: /home/user1
sftp> bye

Bij controle van het verbindingsverloop met -v bleek dat maar één sleutel was geprobeerd, de met -i opgegeven user1_key, en dat de authenticatie via de methode publickey verliep.

Wie dezelfde SFTP-verbinding met een GUI-programma zoals FileZilla wil maken, kan het artikel Wat is FTP? (&SFTP) raadplegen, en de instellingen om te verbinden met het account en de sleutel van de hostingprovider zijn in de artikelen Verbinding maken met Cloudways via SFTP en Verbinding maken met AWS Lightsail via SFTP te vinden.

2️⃣ Gebruik van sftp en basiscommando's

ls, cd en pwd die bij de prompt sftp> worden uitgevoerd, werken op de externe server. De lokale mappen aan de kant waar sftp is gestart, worden bediend met lls, lcd en lpwd, met een l ervoor, en bestanden om te uploaden worden gezocht met lls.

De kaders hieronder tonen resultaten waarbij telkens na een paar commandoregels opnieuw is verbonden, daarom begint de externe werkmap bij /home/user1 en de lokale werkmap bij /home/admin1.

Na het invoeren van help verschijnen de beschikbare commando's met een beschrijving van één regel.

help
Available commands:
bye                                Quit sftp
cd path                            Change remote directory to 'path'
chgrp [-h] grp path                Change group of file 'path' to 'grp'
chmod [-h] mode path               Change permissions of file 'path' to 'mode'
chown [-h] own path                Change owner of file 'path' to 'own'
copy oldpath newpath               Copy remote file
cp oldpath newpath                 Copy remote file
df [-hi] [path]                    Display statistics for current directory or
                                   filesystem containing 'path'
exit                               Quit sftp
get [-afpR] remote [local]         Download file
help                               Display this help text
lcd path                           Change local directory to 'path'
lls [ls-options [path]]            Display local directory listing
lmkdir path                        Create local directory
ln [-s] oldpath newpath            Link remote file (-s for symlink)
lpwd                               Print local working directory
ls [-1afhlnrSt] [path]             Display remote directory listing
lumask umask                       Set local umask to 'umask'
mkdir path                         Create remote directory
progress                           Toggle display of progress meter
put [-afpR] local [remote]         Upload file
pwd                                Display remote working directory
quit                               Quit sftp
reget [-fpR] remote [local]        Resume download file
rename oldpath newpath             Rename remote file
reput [-fpR] local [remote]        Resume upload file
rm path                            Delete remote file
rmdir path                         Remove remote directory
symlink oldpath newpath            Symlink remote file
version                            Show SFTP version
!command                           Execute 'command' in local shell
!                                  Escape to local shell
?                                  Synonym for help

In de lijst hadden bye, exit en quit alle dezelfde beschrijving, [Quit sftp].

ls toont de lijst van de externe werkmap, en met -l verschijnen ook rechten, eigenaar, grootte en wijzigingstijd.

ls
config     docs       draft.txt  logs       memo.txt   notes.txt  old.txt    
run.sh     
ls -l
drwxr-xr-x    ? user1    user1        4096 Jan  1  2026 config
drwxr-xr-x    ? user1    user1        4096 Jan  1  2026 docs
-rw-r--r--    ? user1    user1           6 Jan  1  2026 draft.txt
drwxr-xr-x    ? user1    user1        4096 Jan  1  2026 logs
-rw-r--r--    ? user1    user1          10 Jan  1  2026 memo.txt
-rw-r--r--    ? user1    user1          13 Jan  1  2026 notes.txt
-rw-r--r--    ? user1    user1           4 Jan  1  2026 old.txt
-rw-r--r--    ? user1    user1          18 Jan  1  2026 run.sh

Met cd is de externe werkmap gewijzigd in docs en daarna met pwd gecontroleerd.

cd docs
pwd
Remote working directory: /home/user1/docs

Aan de lokale kant controleert lpwd de huidige map en toont lls de lijst. Na lls kunnen de opties van de lokale ls ongewijzigd worden toegevoegd, waardoor ook lls -l werkte.

lpwd
Local working directory: /home/admin1
lls
memo.txt
report.txt
site
lls -l
total 12
-rw-r--r--. 1 admin1 admin1    9 Jan  1  2026 memo.txt
-rw-r--r--. 1 admin1 admin1   15 Jan  1  2026 report.txt
drwxr-xr-x. 3 admin1 admin1 4096 Jan  1  2026 site

Toen de lokale werkmap met lcd in site werd gewijzigd, veranderde ook het pad van lpwd in /home/admin1/site.

lcd site
lpwd
Local working directory: /home/admin1/site

Externe mappen worden gemaakt met mkdir en verwijderd met rmdir. Na het maken en na het verwijderen is de lijst met ls gecontroleerd.

mkdir backup
ls
backup     config     docs       draft.txt  logs       memo.txt   notes.txt  
old.txt    run.sh     
rmdir backup
ls
config     docs       draft.txt  logs       memo.txt   notes.txt  old.txt    
run.sh     

Bestanden worden verwijderd met rm en hernoemd met rename. Eerst is old.txt verwijderd, daarna is draft.txt hernoemd naar final.txt.

rm old.txt
ls
config     docs       draft.txt  logs       memo.txt   notes.txt  run.sh     
rename draft.txt final.txt
ls
config     docs       final.txt  logs       memo.txt   notes.txt  run.sh     

chmod wijzigt de rechten van een extern bestand. Toen run.sh op 755 werd gezet, veranderde de rechtenkolom van ls -l in -rwxr-xr-x.

ls -l run.sh
-rw-r--r--    ? user1    user1          18 Jan  1  2026 run.sh
chmod 755 run.sh
ls -l run.sh
-rwxr-xr-x    ? user1    user1          18 Jan  1  2026 run.sh

Bij notes.txt zijn de rechten gewijzigd in 600, zodat alleen de eigenaar kan lezen en schrijven.

chmod 600 notes.txt
ls -l notes.txt
-rw-------    ? user1    user1          13 Jan  1  2026 notes.txt

df toont de capaciteit van het externe bestandssysteem. Met -h verscheen die in GB.

df -h
    Size     Used    Avail   (root)    %Capacity
  23.1GB    6.2GB   15.8GB   16.9GB          26%

Een ! vóór een commando voert dat commando uit in de lokale shell. Bij !ls -l verschenen de lokale bestanden in de thuismap van admin1.

!ls -l
total 12
-rw-r--r--. 1 admin1 admin1    9 Jan  1  2026 memo.txt
-rw-r--r--. 1 admin1 admin1   15 Jan  1  2026 report.txt
drwxr-xr-x. 3 admin1 admin1 4096 Jan  1  2026 site
!pwd
/home/admin1

Wordt alleen ! ingevoerd, dan gaat sftp naar de lokale shell, en na het invoeren van exit verscheen de prompt sftp> weer.

3️⃣ Bestanden uploaden en downloaden met sftp

put uploadt een lokaal bestand naar de externe werkmap, en get haalt een extern bestand op naar de lokale werkmap. Eerst is met head -c het bestand backup.tar.gz van 50MB gemaakt.

head -c 50M /dev/urandom > backup.tar.gz

Bij het interactief uploaden van dit bestand verscheen eerst een regel met het pad waarnaar wordt geüpload, en op de regel daaronder stonden bestandsnaam, voortgang, grootte, snelheid en duur.

put backup.tar.gz
Uploading backup.tar.gz to /home/user1/backup.tar.gz
backup.tar.gz                                 100%   50MB  92.5MB/s   00:00    

Staat achter get een andere naam, dan wordt onder die naam opgeslagen.

get backup.tar.gz restore.tar.gz
Fetching /home/user1/backup.tar.gz to restore.tar.gz
backup.tar.gz                                 100%   50MB 194.3MB/s   00:00    

cmp toont niets als twee bestanden gelijk zijn, daarom is er echo achter gezet, en de vergelijking van het geüploade bestand met het opnieuw opgehaalde bestand gaf same.

cmp backup.tar.gz restore.tar.gz && echo same
same

Toen put en get in batchmodus werden uitgevoerd om report.txt te uploaden en notes.txt op te halen, verschenen behalve de commandoregels met sftp> geen resultaatregels. Het opgehaalde bestand is gecontroleerd met lls -l, en notes.txt, waarvan de rechten eerder in 600 waren gewijzigd, hield ook zonder -p de rechten 600.

Mappen worden alleen met -r overgezet. Bij het uploaden van de map site zonder -r verscheen de fout dat het geen gewoon bestand is.

put site
local "site/" is not a regular file
put -r site
Entering site/
Entering site/css

Met -r verscheen voor elke map een regel Entering, en onder de externe map site kwamen de map css en index.html te staan, onder css style.css. Ook bij het ophalen van een externe map wordt -r aan get toegevoegd.

get -r logs
Retrieving /home/user1/logs

Controle met lls -l logs liet zien dat app.log en error.log waren gedownload. Bij de poging de map docs zonder -r op te halen eindigde ook get met de fout [not a regular file].

get docs
download /home/user1/docs/: not a regular file

Met -p blijven de wijzigingstijd en rechten van de bron behouden. De wijzigingstijd van de lokale report.txt is op 1 januari gezet, daarna is het bestand met -p geüpload onder de naam report-p.txt.

put -p report.txt report-p.txt
ls -l report-p.txt
-rw-r--r--    ? user1    user1          15 Jan  1  2026 report-p.txt

In report-p.txt bleef de wijzigingstijd van de bron behouden, terwijl report.txt, eerder zonder -p geüpload, de tijd van het uploaden kreeg. Ook bij readme.txt, opgehaald met get -p, bleef de wijzigingstijd van het externe bestand behouden.

get -p docs/readme.txt
lls -l readme.txt
-rw-r--r--. 1 admin1 admin1 7 Jan  1  2026 readme.txt

Ook als er al een bestand met dezelfde naam bestaat, overschrijft put het zonder te vragen. Eerst is de inhoud van de lokale memo.txt en de externe memo.txt gecontroleerd.

cat memo.txt
local v2
ssh user1@server cat memo.txt
remote v1
put memo.txt
ssh user1@server cat memo.txt
local v2

Zonder bevestigingsvraag werd de externe memo.txt vervangen door de lokale inhoud, en ook de interactief uitgevoerde put uploadde meteen zonder te vragen. Is er een extern bestand dat bewaard moet blijven, dan wordt achter put een andere naam gezet bij het uploaden.

Een paar bestanden één keer versturen lukt ook in één regel met het scp-commando, en voor het herhaaldelijk gelijktrekken van dezelfde map past het rsync-commando, dat alleen gewijzigde bestanden verstuurt. sftp past wanneer met een open verbinding de externe lijst wordt bekeken en de over te zetten bestanden worden gekozen, of wanneer met een batchbestand meerdere commando's na elkaar worden uitgevoerd. Op de testserver zaten sftp en scp in hetzelfde pakket openssh-clients, en rsync in het pakket rsync.

CommandoGeschikt voor
sshMet een shell verbinden met een externe server of externe commando's uitvoeren
sftpMet een open verbinding de externe lijst bekijken en bestanden uploaden en ophalen, met een batchbestand meerdere commando's uitvoeren
scpBestanden en mappen kopiëren met één commandoregel
rsyncBron en bestemming vergelijken en alleen gewijzigde bestanden overzetten

4️⃣ Batchmodus van sftp

De werkwijze waarbij put en get regel voor regel bij de prompt sftp> worden ingevoerd, is in cron of shellscripts niet zomaar bruikbaar. Wordt bij -b een bestand met commando's opgegeven, dan voert sftp de commando's uit dat bestand na elkaar uit en stopt het. In batchmodus kan geen wachtwoord worden ingevoerd, daarom raadt ook de handleiding aan deze te gebruiken met authenticatie zonder invoer, zoals sleutelauthenticatie.

upload.batch is een batchbestand dat report.txt naar de externe map public_html uploadt. Voordat het batchbestand wordt uitgevoerd, moet de externe map public_html bestaan. In dit artikel is die vooraf gemaakt met [put -r site public_html] uit het praktijkvoorbeeld hieronder.

cat upload.batch
cd public_html
put report.txt
ls -l

Dit bestand is uitgevoerd met -b, en net als in een script is de uitvoer weggegooid en is aan de exitcode gecontroleerd of het is gelukt.

if sftp -b upload.batch user1@server > /dev/null; then echo "upload OK"; else echo "upload FAILED (rc=$?)"; fi
upload OK

Mislukt een commando midden in het batchbestand, dan stopt sftp op die plek. Dit is gecontroleerd met fail.batch, waarin cd nodir staat, dat naar een niet-bestaande map gaat.

cat fail.batch
cd public_html
cd nodir
put memo.txt
ls -l
sftp -b fail.batch user1@server; echo "rc=$?"
sftp> cd public_html
sftp> cd nodir
stat remote: No such file or directory
rc=1

Na de fout [No such file or directory] bij cd nodir werden put en ls niet uitgevoerd, en de exitcode was 1. De handleiding legt uit dat de batch stopt als commando's zoals cd, get, put, rm en ls mislukken. Toen met hetzelfde bestand een if-statement werd uitgevoerd, verscheen [upload FAILED (rc=1)].

if sftp -b fail.batch user1@server > /dev/null; then echo "upload OK"; else echo "upload FAILED (rc=$?)"; fi
stat remote: No such file or directory
upload FAILED (rc=1)

Voor een commando waarna ook bij een mislukking met de volgende regel moet worden doorgegaan, komt een -. Uitgevoerd is fail-dash.batch, waarin alleen cd nodir uit fail.batch is gewijzigd in -cd nodir.

cat fail-dash.batch
cd public_html
-cd nodir
put memo.txt
ls -l
sftp -b fail-dash.batch user1@server
sftp> cd public_html
sftp> -cd nodir
stat remote: No such file or directory
sftp> put memo.txt
sftp> ls -l

Bij -cd nodir trad dezelfde fout op, maar put memo.txt en ls -l op de volgende regels werden toch uitgevoerd, en de exitcode was 0. In het kader hierboven is de lijstregel van ls -l met datum en tijd weggelaten, en in die lijst stond memo.txt geüpload.

Om commando's via de standaardinvoer in plaats van via een bestand aan te leveren, wordt -b - gebruikt. In het shellscript zijn ze zoals hieronder met een here-document aangeleverd, en de door sftp uitgevoerde commando's verschenen mee als regels sftp>. In de lijst stond ook memo.txt, geüpload met fail-dash.batch.

sftp -b - user1@server <<'EOF'
cd public_html
ls
EOF
sftp> cd public_html
sftp> ls
css          index.html   memo.txt     report.txt   

In batchmodus kunnen vragen niet worden beantwoord, daarom mislukt een server waarmee voor het eerst wordt verbonden bij de controle van de hostsleutel. Bij verbinden met de naam localhost, die niet in known_hosts staat, verscheen [Host key verification failed.] en was de exitcode 255.

sftp -b - user1@localhost
Host key verification failed.
Connection closed

Daarom wordt met een server die een script voor het eerst benadert, eerst één keer met interactieve sftp of ssh verbonden om de hostsleutel in known_hosts te registreren.

🔲 Opties van het sftp-commando

OptieKopiërenUitleg
-PGeeft het poortnummer van de SSH-server voor de verbinding op
-iGeeft het privésleutelbestand voor authenticatie met een publieke sleutel op
-bVoert de commando's uit het batchbestand na elkaar uit en stopt bij het mislukte commando
-b -Leest batchcommando's van de standaardinvoer
-vToont het verbindingsverloop als debug1-regels
put -rUploadt een lokale map met submappen
get -rDownloadt een externe map met submappen
put -pUploadt met behoud van wijzigingstijd en rechten
get -pDownloadt met behoud van wijzigingstijd en rechten
ls -lToont de externe lijst met rechten, eigenaar, grootte en wijzigingstijd
df -hToont de capaciteit van het externe bestandssysteem in een eenheid zoals GB
!commandoVoert een commando uit in de lokale shell, alleen ! invoeren gaat naar de lokale shell
OptieKopiërenUitleg
-4Verbindt alleen via IPv4-adressen
-6Verbindt alleen via IPv6-adressen
-aHervat een onderbroken overdracht zonder te overschrijven
-CZet over met compressie ingeschakeld via -C van ssh
-FGeeft het gebruikersconfiguratiebestand op dat ssh leest
-JVerbindt via een jump host met de doelserver
-lBeperkt de bandbreedte van de overdracht in Kbit/s
-NSchakelt de stille modus uit die -b inschakelt
-oGeeft ssh-opties op in ssh_config-vorm
-pZet over met behoud van wijzigingstijd, toegangstijd en rechten van het bestand
-qToont de voortgangsregel en de waarschuwingen en diagnostische meldingen van ssh niet
-rZet een map met submappen over
ls -aToont ook bestanden die met een punt (.) beginnen
ls -tSorteert op wijzigingstijd
regetHervat een onderbroken download (gelijk aan get -a)
reputHervat een onderbroken upload (gelijk aan put -a)
lmkdirMaakt een lokale map
progressSchakelt de voortgangsregel in of uit

🔲 sftp-opdrachtsimulator

Worden in de simulator hieronder de sftp-verbinding uit het artikel en de commando's van de prompt sftp> met de chips of het toetsenbord ingevoerd, dan verschijnt dezelfde uitvoer. Bij interactief uitgevoerde put en get verschijnen ook de regels Uploading en Fetching en de voortgangsregel. De simulator start met de sleutel geregistreerd, waardoor ook [sftp user1@server] uit het kader voor wachtwoordverbinding zonder wachtwoordvraag verbindt.

sftp-opdrachtsimulatorAlmaLinux 9.8
[root@server work]#
Werkt alleen in je browser. Overdrachten en verwijderingen zijn een nabootsing die alleen de toestand van de virtuele server op dit scherm verandert.

5️⃣ Praktijkvoorbeelden van het sftp-commando

  • ↪️ Configuratiebestand back-uppen en webmap uploaden, verbindingsfouten en fouten lezen

De verbinding en de basiscommando's kunnen hierboven direct worden ingevoerd in de sftp-opdrachtsimulator.

🔲 Configuratiebestand back-uppen en map uploaden met sftp

Wordt een extern configuratiebestand vóór het bewerken onder een andere naam opgehaald, dan kan het worden gebruikt om terug te draaien. Met de opslagnaam achter get is app.conf opgehaald als app.conf.bak, en met !cat is de opgehaalde inhoud gecontroleerd.

get config/app.conf app.conf.bak
!cat app.conf.bak
port=8080
log=/var/log/app.log

Om een webmap in zijn geheel te uploaden, komt achter put -r de naam van de externe map. Met de naam public_html, die extern nog niet bestond, werd een map met die naam gemaakt, en controle met ls -l liet zien dat de map css en index.html uit site direct onder public_html stonden.

put -r site public_html
Entering site/
Entering site/css

Wordt de naam van een al bestaande map opgegeven, dan wordt de map site als geheel onder die map geüpload. Nadat met mkdir www was gemaakt en het commando in dezelfde vorm was uitgevoerd, werd het pad van index.html www/site/index.html.

mkdir www
put -r site www
Entering site/
Entering site/css

Bestaat de externe map, dan wordt de map als geheel geüpload, en anders alleen de inhoud, daarom wordt vóór het uploaden eerst met ls gecontroleerd of de externe map bestaat.

🔲 Veelgemaakte fouten bij het gebruik van sftp

Staat bij -P een ander nummer dan de SSH-poort van de server, dan eindigt sftp al bij het verbinden. Er is met -P 2222 verbonden terwijl op poort 2222 geen SSH-server draaide.

sftp -P 2222 user1@server
ssh: connect to host 127.0.0.1 port 2222: Connection refused
Connection closed

Omdat op die poort geen SSH-server wachtte, verscheen [Connection refused] en was de exitcode 255. Bij deze fout wordt eerst gecontroleerd of het nummer bij -P overeenkomt met de SSH-poort van de server.

Staat het privésleutelbestand zo open dat ook andere gebruikers het kunnen lezen, dan gebruikt ssh die sleutel niet. De rechten van de standaardsleutel id_ed25519 zijn in 644 gewijzigd, daarna is verbonden.

chmod 644 ~/.ssh/id_ed25519
sftp -b - user1@server
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/admin1/.ssh/id_ed25519' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
Load key "/home/admin1/.ssh/id_ed25519": bad permissions
user1@127.0.0.1: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).
Connection closed

De sleutel werd genegeerd met de waarschuwing [UNPROTECTED PRIVATE KEY FILE], en omdat er geen ander authenticatiemiddel was, eindigde de verbinding met [Permission denied]. Nadat de rechten waren teruggezet naar 600, lukte de verbinding met hetzelfde commando.

chmod 600 ~/.ssh/id_ed25519
sftp -b - user1@server
sftp> pwd
Remote working directory: /home/user1
sftp> bye

Ook toen de met -i opgegeven sleutel 644 had, verscheen dezelfde waarschuwing, en in dat geval probeerde ssh de standaardsleutel id_ed25519 niet, ook al had die 600, waardoor er geen verbinding kwam.

Nadat de authenticatie in korte tijd meerdere keren was mislukt, werd de verbinding vóór de authenticatie verbroken, ook toen direct na het terugzetten van de rechten van de met -i opgegeven user1_key naar 600 opnieuw met die sleutel werd verbonden.

sftp -i ~/.ssh/user1_key -b - user1@server
Connection closed by 127.0.0.1 port 22
Connection closed

Op de testserver met OpenSSH 9.9p1 bleef in het serverlog de regel [penalty: failed authentication] achter, en na ongeveer 1 minuut 25 seconden lukte de verbinding met hetzelfde commando.

Ook bij een verkeerd geschreven accountnaam verschijnt dezelfde regel [Permission denied]. Dit is het resultaat met usr1 in plaats van user1.

sftp -b - usr1@server
usr1@127.0.0.1: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).
Connection closed

De uitvoer is gelijk aan die bij een sleutelprobleem, daarom wordt bij deze regel naast het sleutelbestand eerst de accountnaam vóór de @ gecontroleerd.

Is het externe pad verkeerd geschreven, dan mislukt ook put. Het pad /home/user1, met de accountnaam erin, is geschreven als /home/usr1.

put report.txt /home/usr1/report.txt
dest open "/home/usr1/report.txt": No such file or directory

Stond in het lokale doelpad van get een niet-bestaande map, dan was de fout [open local].

get notes.txt nodir/notes.txt
open local "nodir/notes.txt": No such file or directory

Ook get overschrijft zonder te vragen als lokaal een bestand met dezelfde naam bestaat. De lokale notes.txt is gewijzigd, daarna is de externe notes.txt met get opgehaald.

echo "local edit" > notes.txt
cat notes.txt
local edit
get notes.txt
cat notes.txt
remote notes

De lokaal gewijzigde inhoud werd vervangen door de inhoud van het externe bestand. Om het lokale bestand te bewaren, komt achter get een andere opslagnaam.

🔲 Uitvoer en exitcode van sftp controleren

Bij ls -l van sftp stond in de tweede kolom een ? in plaats van het aantal links. Bij lls -l, dat de lokale ls ongewijzigd uitvoert, staat in die kolom het aantal links (bestand 1, map site 3), en aan het eind van de rechten stond een punt (.). Staat in de tweede kolom dus een ?, dan is het de externe lijst, en staat er een getal, dan de lokale lijst.

Bij chmod was er in batchmodus behalve de commandoregel met sftp> geen resultaatregel, en toen in interactieve modus de rechten van de met mkdir gemaakte tmpdir werden gewijzigd, verscheen één regel [Changing mode on].

mkdir tmpdir
chmod 700 tmpdir
Changing mode on /home/user1/tmpdir

De regel [Connected to server.] en de regels Uploading en Fetching van put en get verschenen niet in batchmodus met -b. Dat komt doordat -b ook de stille modus inschakelt, zoals de handleiding bij -N beschrijft.

Aan het begin van de foutregel is te zien of de fout extern of lokaal is ontstaan. De fout bij een externe cd was [stat remote], en bij put van een bestand dat lokaal niet bestaat verscheen [stat nolocal.txt], met de bestandsnaam op de plek van remote.

cd nodir
stat remote: No such file or directory
put nolocal.txt
stat nolocal.txt: No such file or directory

Bij get van een bestand dat extern niet bestaat, eindigde het commando met [not found.], samen met het volledige externe pad.

get nofile.txt
File "/home/user1/nofile.txt" not found.

De exitcode was 255 bij een mislukking tijdens het verbinden en 1 als na het verbinden cd, put of get uit de batch mislukte, en in scripts wordt aan deze waarde onderscheiden in welke fase het stopte. Bij ls zonder argument na cd /root was de exitcode echter 0, ook al verscheen [Permission denied], daarom wordt bij een batch die lijsten leest ook de uitvoer gecontroleerd.

🔢 FAQ & aanbevolen content

Worden achter het adres een dubbele punt en een extern pad gezet, dan haalt sftp na het verbinden alleen dat bestand op en stopt het. Bij het uitvoeren van [sftp user1@server:config/app.conf app.conf.copy] verscheen na [Connected to server.] de regel [Fetching /home/user1/config/app.conf to app.conf.copy] en eindigde het commando met exitcode 0. Is het pad een map, dan begint sftp na het verbinden in die map. Na verbinden met [user1@server:docs] gaf pwd /home/user1/docs.

rmdir verwijderde alleen lege mappen. Bij [rmdir docs] op de map docs met readme.txt en guide.txt eindigde het commando met [Failure]. rm uit de help-lijst is het commando dat externe bestanden verwijdert, daarom worden voor het verwijderen van een map eerst de bestanden erin met rm verwijderd en wordt daarna rmdir uitgevoerd.

sftp werkt met de rechten van het verbonden externe account. Bij [ls /root] als user1 verscheen [Permission denied], en ook [get /etc/shadow] eindigde in de stap [remote open] met dezelfde fout. [cd /root] ging zonder fout naar de map, maar toen daar ls werd uitgevoerd, verscheen [Permission denied] in plaats van de lijst.

ℹ️ Affiliatemelding
De content van deze site bevat affiliatelinks. Koopt een bezoeker via een van deze links een product of dienst, dan ontvangt deze site een commissie van de verkoper. Het bedrag dat de koper betaalt (bij acties gaat het omlaag ↓) wordt daardoor niet hoger. De vermelde prijzen, kortingen en voorraad gelden op het moment van schrijven en kunnen afwijken; controleer ze daarom vóór je aankoop bij de verkoper. Producten worden gekozen en beoordeeld volgens onze eigen criteria, en commissies hebben geen invloed op de volgorde of de inhoud van de beoordelingen.

Geef een reactie

Je e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *

Laat zien dat je geen machine bent: 3   +   9   =