sftp-Befehl: Verbindung, Dateiübertragung mit put und get und Batch-Modus

TestumgebungRHEL-FamilieAlmaLinux 9.8normales Benutzerkonto
NetzwerkbefehlesftpSpeicherort/usr/bin/sftp
Upload und Download von Serverdateien geprüft

Der sftp-Befehl ist das Dateiübertragungsprogramm von OpenSSH, das Dateien mit einem per SSH verbundenen Server austauscht: Nach der Verbindung wechselt man an der Eingabeaufforderung sftp> zwischen Remote-Ordnern, lädt mit put hoch und holt mit get. Auf einem AlmaLinux-9-Testserver wurden per Schlüsselauthentifizierung Dateien und Ordner ausgetauscht und die Befehle auch mit einer -b Batch-Datei ausgeführt: Dateien gleichen Namens wurden ohne Rückfrage überschrieben, und der Batch-Lauf hielt an Ort und Stelle an, sobald ein Befehl mittendrin fehlschlug, und endete mit Exit-Code 1.

Die Ausgaben unten sind unverändert das Ergebnis auf einem AlmaLinux-9-Testserver, auf dem die Konten user1 und admin1 angelegt wurden und von admin1 aus über localhost eine Verbindung zu user1 auf demselben Server hergestellt wurde. Der Verbindungsname server ist ein Beispielname, der in der SSH-Konfiguration von admin1 so eingetragen ist, dass er auf 127.0.0.1 zeigt, daher steht in Fehlerzeilen 127.0.0.1. Auch Konto- und Dateinamen sind Beispielwerte, und bei einem echten Remote-Server schreiben Sie an die Stelle von server dessen Adresse oder Namen.

1️⃣ Verbindung mit dem sftp-Befehl herstellen

Steht nach sftp die Angabe [Konto@Server], wird per SSH verbunden, und danach erscheint die Eingabeaufforderung sftp>. Auf dem Testserver war der unter admin1 erzeugte ed25519-Schlüssel in authorized_keys von user1 eingetragen, daher wurde kein Passwort abgefragt.

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

Bei einem Server, mit dem zum ersten Mal verbunden wird, erscheint eine Rückfrage zur Prüfung des Host-Schlüssels, und auf dem echten Bildschirm folgt nach der ersten Zeile noch eine Zeile mit dem Schlüssel-Fingerabdruck, der bei jedem Server anders ist (im Kasten oben weggelassen). Nach Eingabe von yes wurde der Server zu known_hosts hinzugefügt, und nach der Zeile [Connected to server.] erschien die Eingabeaufforderung sftp>.

pwd gibt den Remote-Arbeitsordner aus. Zum Beenden der sftp-Verbindung geben Sie bye ein, und exit und quit bewirken dasselbe wie bye.

Bei einem Konto ohne eingetragenen Schlüssel fragt der Server bei der Verbindung nach dem Passwort, und im interaktiven Modus wird es bei dieser Abfrage direkt eingegeben. Auf dem Testserver wurde für user1 ein vorläufiges Passwort gesetzt, ohne dass der Schlüssel von admin1 eingetragen war, und danach derselbe Befehl ausgeführt.

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

Das eingegebene Passwort wurde nicht auf dem Bildschirm angezeigt, und nach der Zeile [Connected to server.] erschien die Eingabeaufforderung sftp>.

Bei einem Server, dessen SSH-Port auf eine andere Nummer als 22 geändert wurde, geben Sie die Portnummer mit -P an. Auf dem Testserver wurde ein weiterer SSH-Server auf Port 2222 gestartet und dann mit -P 2222 verbunden.

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

-P für die Portangabe ist ein Großbuchstabe, das kleine -p ist die Option, die Änderungszeit und Rechte der Datei erhält.

Wurde die Schlüsseldatei unter einem anderen als dem Standardnamen erzeugt, geben Sie die private Schlüsseldatei mit -i an. Unten steht das Ergebnis einer Verbindung mit user1_key, bei der nur pwd und bye ausgeführt wurden. -b - ist der Batch-Modus, der Befehle von der Standardeingabe liest, und diente hier nur dazu, das Ergebnis der Verbindung zu prüfen.

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

Bei der Prüfung des Verbindungsablaufs mit -v zeigte sich, dass nur ein Schlüssel versucht wurde, nämlich der mit -i angegebene user1_key, und dass die Authentifizierung über das Verfahren publickey erfolgte.

Wie dieselbe SFTP-Verbindung mit einem GUI-Programm wie FileZilla hergestellt wird, zeigt der Beitrag Was ist FTP? (&SFTP) und bei den Einstellungen für die Verbindung mit Konto und Schlüssel vom Hoster helfen die Beiträge Per SFTP zu Cloudways verbinden, Per SFTP zu AWS Lightsail verbinden weiter.

2️⃣ sftp-Verwendung und Grundbefehle

ls, cd und pwd, die an der Eingabeaufforderung sftp> ausgeführt werden, arbeiten auf dem Remote-Server. Die lokalen Ordner auf der Seite, auf der sftp gestartet wurde, werden mit lls, lcd und lpwd behandelt, denen ein l vorangestellt ist, und Dateien zum Hochladen sucht man mit lls.

Die Kästen unten zeigen Ergebnisse, für die jeweils nach einigen Befehlszeilen neu verbunden wurde, daher beginnt der Remote-Arbeitsordner bei /home/user1 und der lokale Arbeitsordner bei /home/admin1.

Nach Eingabe von help erscheinen die verfügbaren Befehle mit je einer Zeile Beschreibung.

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 der Liste hatten bye, exit und quit alle dieselbe Beschreibung [Quit sftp].

ls gibt die Liste des Remote-Arbeitsordners aus, und mit -l erscheinen zusätzlich Rechte, Besitzer, Größe und Änderungszeit.

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

Mit cd wurde der Remote-Arbeitsordner auf docs gewechselt und mit pwd geprüft.

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

Auf der lokalen Seite prüft lpwd den aktuellen Ordner, und lls gibt die Liste aus. Nach lls lassen sich die Optionen des lokalen ls unverändert anhängen, daher funktionierte auch lls -l.

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

Nach dem Wechsel des lokalen Arbeitsordners auf site mit lcd änderte sich auch der Pfad von lpwd in /home/admin1/site.

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

Remote-Ordner werden mit mkdir angelegt und mit rmdir gelöscht. Nach dem Anlegen und nach dem Löschen wurde die Liste mit ls geprüft.

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     

Dateien werden mit rm gelöscht und mit rename umbenannt. Zuerst wurde old.txt gelöscht, danach draft.txt in final.txt umbenannt.

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 ändert die Rechte einer Remote-Datei. Nachdem run.sh auf 755 gesetzt wurde, änderte sich die Rechtespalte von 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

Bei notes.txt wurden die Rechte auf 600 geändert, sodass nur der Besitzer lesen und schreiben kann.

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

df gibt die Kapazität des Remote-Dateisystems aus. Mit -h erschien die Ausgabe in GB.

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

Ein ! vor einem Befehl führt diesen Befehl in der lokalen Shell aus. Bei !ls -l erschienen die lokalen Dateien im Home-Ordner von 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

Wird nur ! eingegeben, wechselt sftp in die lokale Shell, und nach Eingabe von exit erschien wieder die Eingabeaufforderung sftp>.

3️⃣ Dateien mit sftp hochladen und herunterladen

put lädt eine lokale Datei in den Remote-Arbeitsordner hoch, get holt eine Remote-Datei in den lokalen Arbeitsordner. Zuerst wurde mit head -c die 50MB große Datei backup.tar.gz erzeugt.

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

Beim interaktiven Hochladen dieser Datei erschien zuerst eine Zeile mit dem Zielpfad, und in der Zeile darunter standen Dateiname, Fortschritt, Größe, Geschwindigkeit und Dauer.

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

Steht hinter get ein anderer Name, wird unter diesem Namen gespeichert.

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 gibt nichts aus, wenn zwei Dateien gleich sind, daher wurde echo angehängt, und der Vergleich der hochgeladenen mit der wieder geholten Datei ergab same.

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

Als put und get im Batch-Modus ausgeführt wurden, um report.txt hochzuladen und notes.txt zu holen, erschienen außer den Befehlszeilen mit sftp> keine Ergebniszeilen. Die geholte Datei wurde mit lls -l geprüft, und notes.txt, deren Rechte zuvor auf 600 geändert worden waren, behielt auch ohne -p die Rechte 600.

Ordner werden nur mit -r übertragen. Beim Hochladen des Ordners site ohne -r erschien der Fehler, dass es keine reguläre Datei ist.

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

Mit -r erschien für jeden Ordner eine Zeile Entering, und unter dem Remote-Ordner site lagen danach der Ordner css und index.html, unter css die Datei style.css. Auch beim Holen eines Remote-Ordners wird get mit -r verwendet.

get -r logs
Retrieving /home/user1/logs

Die Prüfung mit lls -l logs zeigte, dass app.log und error.log heruntergeladen waren. Beim Versuch, den Ordner docs ohne -r zu holen, endete auch get mit dem Fehler [not a regular file].

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

Mit -p bleiben Änderungszeit und Rechte der Quelle erhalten. Die Änderungszeit der lokalen report.txt wurde auf den 1. Januar gesetzt, danach wurde die Datei mit -p unter dem Namen report-p.txt hochgeladen.

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 blieb die Änderungszeit der Quelle erhalten, während report.txt, die zuvor ohne -p hochgeladen wurde, die Zeit des Hochladens erhielt. Auch bei readme.txt, die mit get -p geholt wurde, blieb die Änderungszeit der Remote-Datei erhalten.

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

Auch wenn bereits eine Datei gleichen Namens vorhanden ist, überschreibt put sie ohne Rückfrage. Zuerst wurde der Inhalt der lokalen memo.txt und der Remote-Datei memo.txt geprüft.

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

Ohne Rückfrage wurde die Remote-Datei memo.txt durch den lokalen Inhalt ersetzt, und auch das interaktiv ausgeführte put lud sofort ohne Rückfrage hoch. Gibt es eine Remote-Datei, die erhalten bleiben muss, schreiben Sie hinter put einen anderen Namen und laden damit hoch.

Für wenige Dateien, die einmal gesendet werden, genügt auch eine Zeile mit dem scp-Befehl, und zum wiederholten Abgleichen desselben Ordners passt der rsync-Befehl, der nur geänderte Dateien sendet. sftp passt, wenn man bei bestehender Verbindung die Remote-Liste ansieht und die zu übertragenden Dateien auswählt oder mit einer Batch-Datei mehrere Befehle nacheinander ausführt. Auf dem Testserver gehörten sftp und scp zum selben Paket openssh-clients, rsync zum Paket rsync.

BefehlGeeignet für
sshPer Shell mit einem Remote-Server verbinden oder Remote-Befehle ausführen
sftpBei bestehender Verbindung die Remote-Liste ansehen und Dateien hochladen und holen, mit einer Batch-Datei mehrere Befehle ausführen
scpDateien und Ordner mit einer Befehlszeile kopieren
rsyncQuelle und Ziel vergleichen und nur geänderte Dateien übertragen

4️⃣ sftp-Batch-Modus

Die Arbeitsweise, put und get an der Eingabeaufforderung sftp> Zeile für Zeile einzugeben, lässt sich in Cron oder Shell-Skripten nicht unverändert verwenden. Wird bei -b eine Datei mit Befehlen angegeben, führt sftp die Befehle dieser Datei nacheinander aus und beendet sich. Im Batch-Modus lässt sich kein Passwort eingeben, daher empfiehlt auch das Handbuch die Verwendung zusammen mit einer Authentifizierung ohne Eingabe wie der Schlüsselauthentifizierung.

upload.batch ist eine Batch-Datei, die report.txt in den Remote-Ordner public_html hochlädt. Vor dem Ausführen der Batch-Datei muss der Remote-Ordner public_html vorhanden sein. In diesem Artikel wurde er vorab mit [put -r site public_html] aus dem Praxisbeispiel unten angelegt.

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

Diese Datei wurde mit -b ausgeführt, und wie in einem Skript wurde die Ausgabe verworfen und der Erfolg am Exit-Code geprüft.

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

Schlägt ein Befehl mitten in der Batch-Datei fehl, hält sftp an dieser Stelle an. Geprüft wurde das mit fail.batch, in die cd nodir für den Wechsel in einen nicht vorhandenen Ordner eingefügt wurde.

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

Nach dem Fehler [No such file or directory] bei cd nodir wurden put und ls nicht ausgeführt, und der Exit-Code war 1. Das Handbuch erklärt, dass der Batch-Lauf anhält, wenn Befehle wie cd, get, put, rm und ls fehlschlagen. Als mit derselben Datei eine if-Anweisung ausgeführt wurde, erschien [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)

Befehlen, nach deren Fehlschlag mit der nächsten Zeile fortgefahren werden soll, wird ein - vorangestellt. Ausgeführt wurde fail-dash.batch, in der nur cd nodir aus fail.batch in -cd nodir geändert wurde.

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

Bei -cd nodir trat derselbe Fehler auf, aber put memo.txt und ls -l in den folgenden Zeilen wurden noch ausgeführt, und der Exit-Code war 0. Im Kasten oben wurde die Listenzeile von ls -l mit Datum und Uhrzeit weggelassen, und in dieser Liste stand die hochgeladene memo.txt.

Sollen Befehle statt aus einer Datei über die Standardeingabe kommen, wird -b - verwendet. Im Shell-Skript wurden sie wie unten als Here-Dokument übergeben, und die von sftp ausgeführten Befehle erschienen mit als Zeilen sftp>. In der Liste stand auch die mit fail-dash.batch hochgeladene memo.txt.

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

Im Batch-Modus lassen sich Rückfragen nicht beantworten, daher scheitert ein Server, mit dem zum ersten Mal verbunden wird, an der Prüfung des Host-Schlüssels. Bei der Verbindung über den Namen localhost, der nicht in known_hosts steht, erschien [Host key verification failed.], und der Exit-Code war 255.

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

Deshalb verbinden Sie sich mit einem Server, den ein Skript zum ersten Mal erreicht, einmal mit interaktivem sftp oder ssh und tragen den Host-Schlüssel zuerst in known_hosts ein.

🔲 Optionen des sftp-Befehls

OptionKopierenBeschreibung
-PGibt die Portnummer des SSH-Servers für die Verbindung an
-iGibt die private Schlüsseldatei für die Public-Key-Authentifizierung an
-bFührt die Befehle der Batch-Datei nacheinander aus und hält beim fehlgeschlagenen Befehl an
-b -Liest Batch-Befehle von der Standardeingabe
-vGibt den Verbindungsablauf als debug1-Zeilen aus
put -rLädt einen lokalen Ordner samt Unterordnern hoch
get -rLädt einen Remote-Ordner samt Unterordnern herunter
put -pLädt mit erhaltener Änderungszeit und erhaltenen Rechten hoch
get -pLädt mit erhaltener Änderungszeit und erhaltenen Rechten herunter
ls -lGibt die Remote-Liste mit Rechten, Besitzer, Größe und Änderungszeit aus
df -hGibt die Kapazität des Remote-Dateisystems in Einheiten wie GB aus
!befehlFührt einen Befehl in der lokalen Shell aus, nur ! allein wechselt in die lokale Shell
OptionKopierenBeschreibung
-4Verbindet nur über IPv4-Adressen
-6Verbindet nur über IPv6-Adressen
-aSetzt eine abgebrochene Übertragung fort, ohne zu überschreiben
-CSchaltet mit -C von ssh die Kompression ein und überträgt
-FGibt die Benutzerkonfigurationsdatei an, die ssh liest
-JVerbindet über einen Jump-Host mit dem Zielserver
-lBegrenzt die Bandbreite der Übertragung in Kbit/s
-NSchaltet den von -b aktivierten stillen Modus aus
-oGibt ssh-Optionen im ssh_config-Format an
-pÜberträgt mit erhaltener Änderungszeit, Zugriffszeit und erhaltenen Rechten der Datei
-qGibt Fortschrittszeile sowie Warn- und Diagnosemeldungen von ssh nicht aus
-rÜberträgt einen Ordner samt Unterordnern
ls -aGibt auch Dateien aus, die mit einem Punkt (.) beginnen
ls -tSortiert nach Änderungszeit
regetSetzt einen abgebrochenen Download fort (wie get -a)
reputSetzt einen abgebrochenen Upload fort (wie put -a)
lmkdirLegt einen lokalen Ordner an
progressSchaltet die Fortschrittszeile ein oder aus

🔲 sftp-Befehlssimulator

Geben Sie im Simulator unten die sftp-Verbindung aus dem Artikel und die Befehle der Eingabeaufforderung sftp> per Chip oder Tastatur ein, sehen Sie dieselbe Ausgabe. Bei interaktiv ausgeführtem put und get erscheinen auch die Zeilen Uploading und Fetching sowie die Fortschrittszeile. Der Simulator startet mit eingetragenem Schlüssel, daher verbindet auch [sftp user1@server] aus dem Kasten zur Passwortverbindung ohne Passwortabfrage.

sftp-BefehlssimulatorAlmaLinux 9.8
[root@server work]#
Läuft nur in deinem Browser. Übertragen und Löschen sind nur nachgeahmt und ändern nur den Zustand des virtuellen Servers auf diesem Bildschirm.

5️⃣ Praxisbeispiele für den sftp-Befehl

  • ↪️ Konfigurationsdatei sichern und Webordner hochladen, Verbindungsfehler und Fehlermeldungen lesen

Die Verbindung und die Grundbefehle lassen sich direkt eingeben im obigen sftp-Befehlssimulator.

🔲 Konfigurationsdatei sichern und Ordner hochladen mit sftp

Wird eine Remote-Konfigurationsdatei vor dem Bearbeiten unter einem anderen Namen geholt, lässt sie sich zum Zurücksetzen verwenden. Mit dem Speichernamen hinter get wurde app.conf als app.conf.bak geholt, und mit !cat wurde der geholte Inhalt geprüft.

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

Um einen Webordner komplett hochzuladen, schreiben Sie hinter put -r den Namen des Remote-Ordners. Mit dem Namen public_html, den es auf der Remote-Seite noch nicht gab, wurde ein Ordner dieses Namens angelegt, und die Prüfung mit ls -l zeigte den Ordner css und index.html aus site direkt unter public_html.

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

Wird der Name eines bereits vorhandenen Ordners angegeben, wird der Ordner site als Ganzes unter diesen Ordner hochgeladen. Nachdem mit mkdir der Ordner www angelegt und der Befehl in derselben Form ausgeführt wurde, lautete der Pfad von index.html www/site/index.html.

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

Ist der Remote-Ordner vorhanden, wird der Ordner als Ganzes hochgeladen, andernfalls nur sein Inhalt, prüfen Sie daher vor dem Hochladen zuerst mit ls, ob der Remote-Ordner vorhanden ist.

🔲 Häufige Fehler bei der Nutzung von sftp

Steht bei -P eine andere Nummer als der SSH-Port des Servers, endet sftp bereits beim Verbindungsaufbau. Die Verbindung wurde mit -P 2222 versucht, während auf Port 2222 kein SSH-Server lief.

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

Da auf diesem Port kein SSH-Server wartete, erschien [Connection refused], und der Exit-Code war 255. Bei diesem Fehler prüfen Sie zuerst, ob die Nummer bei -P dem SSH-Port des Servers entspricht.

Ist die private Schlüsseldatei so offen, dass auch andere Benutzer sie lesen können, verwendet ssh diesen Schlüssel nicht. Die Rechte des Standardschlüssels id_ed25519 wurden auf 644 geändert, danach wurde verbunden.

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

Der Schlüssel wurde mit der Warnung [UNPROTECTED PRIVATE KEY FILE] ignoriert, und da es kein anderes Authentifizierungsmittel gab, endete die Verbindung mit [Permission denied]. Nach dem Zurücksetzen der Rechte auf 600 gelang die Verbindung mit demselben Befehl.

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

Auch als der mit -i angegebene Schlüssel 644 hatte, erschien dieselbe Warnung, und in diesem Fall versuchte ssh den Standardschlüssel id_ed25519 nicht, obwohl dieser 600 hatte, sodass keine Verbindung zustande kam.

Nachdem die Authentifizierung in kurzer Zeit mehrmals fehlgeschlagen war, wurde die Verbindung noch vor der Authentifizierung getrennt, obwohl direkt nach dem Zurücksetzen der Rechte des mit -i angegebenen user1_key auf 600 erneut mit diesem Schlüssel verbunden wurde.

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

Auf dem Testserver mit OpenSSH 9.9p1 blieb im Serverprotokoll die Zeile [penalty: failed authentication] zurück, und nach etwa 1 Minute 25 Sekunden gelang die Verbindung mit demselben Befehl.

Auch bei einem falsch geschriebenen Kontonamen erscheint dieselbe Zeile [Permission denied]. Hier das Ergebnis, wenn statt user1 usr1 geschrieben wird.

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

Die Ausgabe ist dieselbe wie bei einem Schlüsselproblem, prüfen Sie bei dieser Zeile daher neben der Schlüsseldatei zuerst den Kontonamen vor dem @.

Ist der Remote-Pfad falsch geschrieben, schlägt auch put fehl. Der Pfad /home/user1 mit dem Kontonamen wurde als /home/usr1 geschrieben.

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

Stand im lokalen Zielpfad von get ein nicht vorhandener Ordner, lautete der Fehler [open local].

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

Auch get überschreibt ohne Rückfrage, wenn lokal eine Datei gleichen Namens vorhanden ist. Die lokale notes.txt wurde geändert, danach wurde die Remote-Datei notes.txt mit get geholt.

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

Der lokal geänderte Inhalt wurde durch den Inhalt der Remote-Datei ersetzt. Soll die lokale Datei erhalten bleiben, schreiben Sie hinter get einen anderen Speichernamen.

🔲 sftp-Ausgabe und Exit-Code prüfen

Bei ls -l von sftp stand in der zweiten Spalte statt der Linkanzahl ein ?. Bei lls -l, das das lokale ls unverändert ausführt, steht in dieser Spalte die Linkanzahl (Datei 1, Ordner site 3), und am Ende der Rechte hing ein Punkt (.). Steht in der zweiten Spalte also ?, ist es die Remote-Liste, steht dort eine Zahl, die lokale Liste.

Bei chmod gab es im Batch-Modus außer der Befehlszeile mit sftp> keine Ergebniszeile, und als im interaktiven Modus die Rechte des mit mkdir angelegten tmpdir geändert wurden, erschien eine Zeile [Changing mode on].

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

Die Zeile [Connected to server.] und die Zeilen Uploading und Fetching von put und get erschienen im Batch-Modus mit -b nicht. Der Grund ist, dass -b zugleich den stillen Modus einschaltet, wie es das Handbuch bei -N beschreibt.

Am Anfang der Fehlerzeile lässt sich erkennen, ob der Fehler auf der Remote-Seite oder lokal entstanden ist. Der Fehler bei einem Remote-cd lautete [stat remote], und beim put einer lokal nicht vorhandenen Datei erschien [stat nolocal.txt], bei dem an der Stelle von remote der Dateiname steht.

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

Beim get einer Datei, die es auf der Remote-Seite nicht gibt, endete der Befehl mit [not found.] zusammen mit dem vollständigen Remote-Pfad.

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

Der Exit-Code war 255, wenn schon der Verbindungsaufbau fehlschlug, und 1, wenn nach der Verbindung cd, put oder get im Batch-Lauf fehlschlugen, und in Skripten wird an diesem Wert unterschieden, an welcher Stelle der Ablauf anhielt. Allerdings war der Exit-Code bei ls, das nach cd /root ohne Argument ausgeführt wurde, 0, obwohl [Permission denied] erschien, prüfen Sie bei Batch-Läufen, die Listen lesen, daher auch die Ausgabe.

🔢 FAQ & empfohlene Inhalte

Wird an die Adresse ein Doppelpunkt und ein Remote-Pfad angehängt, holt sftp nach der Verbindung nur diese Datei und beendet sich. Bei [sftp user1@server:config/app.conf app.conf.copy] erschien nach [Connected to server.] die Zeile [Fetching /home/user1/config/app.conf to app.conf.copy], und der Befehl endete mit Exit-Code 0. Ist der Pfad ein Ordner, beginnt sftp nach der Verbindung in diesem Ordner. Nach der Verbindung mit [user1@server:docs] ergab pwd /home/user1/docs.

rmdir löschte nur leere Ordner. Bei [rmdir docs] für den Ordner docs mit readme.txt und guide.txt endete der Befehl mit [Failure]. rm aus der help-Liste ist der Befehl zum Löschen von Remote-Dateien, löschen Sie zum Entfernen eines Ordners daher zuerst die Dateien darin mit rm und führen Sie danach rmdir aus.

sftp arbeitet mit den Rechten des verbundenen Remote-Kontos. Bei [ls /root] als user1 erschien [Permission denied], und auch [get /etc/shadow] endete im Schritt [remote open] mit demselben Fehler. [cd /root] wechselte ohne Fehler, aber als dort ls ausgeführt wurde, erschien statt der Liste [Permission denied].

ℹ️ Affiliate-Hinweis
Die Inhalte dieser Website enthalten Affiliate-Links. Kauft ein Besucher über einen dieser Links ein Produkt oder eine Dienstleistung, erhält die Website vom Verkäufer eine Provision. Der Betrag, den der Käufer zahlt(bei Aktionsrabatten sinkt er ↓), steigt dadurch nicht. Angegebene Preise, Rabatte und Lagerbestände entsprechen dem Stand bei Erstellung und können abweichen; prüfe sie daher vor dem Kauf beim Verkäufer. Produkte werden nach eigenen Kriterien ausgewählt und bewertet, und Provisionen beeinflussen weder die Reihenfolge noch den Inhalt der Bewertungen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Beweisen Sie, dass Sie ein Mensch sind: 8   +   10   =