sftp-Befehl: Verbindung, Dateiübertragung mit put und get und Batch-Modus
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@serverThe 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> byeBei 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@serveruser1@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@serverConnected 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@serversftp> pwd
Remote working directory: /home/user1
sftp> byeBei 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.
helpAvailable 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 helpIn 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.
lsconfig docs draft.txt logs memo.txt notes.txt old.txt
run.sh ls -ldrwxr-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.shMit cd wurde der Remote-Arbeitsordner auf docs gewechselt und mit pwd geprüft.
cd docspwdRemote working directory: /home/user1/docsAuf 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.
lpwdLocal working directory: /home/admin1llsmemo.txt
report.txt
sitells -ltotal 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 siteNach dem Wechsel des lokalen Arbeitsordners auf site mit lcd änderte sich auch der Pfad von lpwd in /home/admin1/site.
lcd sitelpwdLocal working directory: /home/admin1/siteRemote-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 backuplsbackup config docs draft.txt logs memo.txt notes.txt
old.txt run.sh rmdir backuplsconfig 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.txtlsconfig docs draft.txt logs memo.txt notes.txt run.sh rename draft.txt final.txtlsconfig 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.shchmod 755 run.shls -l run.sh-rwxr-xr-x ? user1 user1 18 Jan 1 2026 run.shBei notes.txt wurden die Rechte auf 600 geändert, sodass nur der Besitzer lesen und schreiben kann.
chmod 600 notes.txtls -l notes.txt-rw------- ? user1 user1 13 Jan 1 2026 notes.txtdf 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 -ltotal 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/admin1Wird 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.gzBeim 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.gzUploading 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.gzFetching /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 samesameAls 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 sitelocal "site/" is not a regular fileput -r siteEntering site/
Entering site/cssMit -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 logsRetrieving /home/user1/logsDie 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 docsdownload /home/user1/docs/: not a regular fileMit -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.txtls -l report-p.txt-rw-r--r-- ? user1 user1 15 Jan 1 2026 report-p.txtIn 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.txtlls -l readme.txt-rw-r--r--. 1 admin1 admin1 7 Jan 1 2026 readme.txtAuch 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.txtlocal v2ssh user1@server cat memo.txtremote v1put memo.txtssh user1@server cat memo.txtlocal v2Ohne 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.
| Befehl | Geeignet für |
|---|---|
| ssh | Per Shell mit einem Remote-Server verbinden oder Remote-Befehle ausführen |
| sftp | Bei bestehender Verbindung die Remote-Liste ansehen und Dateien hochladen und holen, mit einer Batch-Datei mehrere Befehle ausführen |
| scp | Dateien und Ordner mit einer Befehlszeile kopieren |
| rsync | Quelle 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.batchcd public_html
put report.txt
ls -lDiese 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=$?)"; fiupload OKSchlä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.batchcd public_html
cd nodir
put memo.txt
ls -lsftp -b fail.batch user1@server; echo "rc=$?"sftp> cd public_html
sftp> cd nodir
stat remote: No such file or directory
rc=1Nach 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=$?)"; fistat 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.batchcd public_html
-cd nodir
put memo.txt
ls -lsftp -b fail-dash.batch user1@serversftp> cd public_html
sftp> -cd nodir
stat remote: No such file or directory
sftp> put memo.txt
sftp> ls -lBei -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
EOFsftp> 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@localhostHost key verification failed.
Connection closedDeshalb 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
| Option | Kopieren | Beschreibung |
|---|---|---|
| -P | Gibt die Portnummer des SSH-Servers für die Verbindung an | |
| -i | Gibt die private Schlüsseldatei für die Public-Key-Authentifizierung an | |
| -b | Führt die Befehle der Batch-Datei nacheinander aus und hält beim fehlgeschlagenen Befehl an | |
| -b - | Liest Batch-Befehle von der Standardeingabe | |
| -v | Gibt den Verbindungsablauf als debug1-Zeilen aus | |
| put -r | Lädt einen lokalen Ordner samt Unterordnern hoch | |
| get -r | Lädt einen Remote-Ordner samt Unterordnern herunter | |
| put -p | Lädt mit erhaltener Änderungszeit und erhaltenen Rechten hoch | |
| get -p | Lädt mit erhaltener Änderungszeit und erhaltenen Rechten herunter | |
| ls -l | Gibt die Remote-Liste mit Rechten, Besitzer, Größe und Änderungszeit aus | |
| df -h | Gibt die Kapazität des Remote-Dateisystems in Einheiten wie GB aus | |
| !befehl | Führt einen Befehl in der lokalen Shell aus, nur ! allein wechselt in die lokale Shell |
| Option | Kopieren | Beschreibung |
|---|---|---|
| -4 | Verbindet nur über IPv4-Adressen | |
| -6 | Verbindet nur über IPv6-Adressen | |
| -a | Setzt eine abgebrochene Übertragung fort, ohne zu überschreiben | |
| -C | Schaltet mit -C von ssh die Kompression ein und überträgt | |
| -F | Gibt die Benutzerkonfigurationsdatei an, die ssh liest | |
| -J | Verbindet über einen Jump-Host mit dem Zielserver | |
| -l | Begrenzt die Bandbreite der Übertragung in Kbit/s | |
| -N | Schaltet den von -b aktivierten stillen Modus aus | |
| -o | Gibt ssh-Optionen im ssh_config-Format an | |
| -p | Überträgt mit erhaltener Änderungszeit, Zugriffszeit und erhaltenen Rechten der Datei | |
| -q | Gibt Fortschrittszeile sowie Warn- und Diagnosemeldungen von ssh nicht aus | |
| -r | Überträgt einen Ordner samt Unterordnern | |
| ls -a | Gibt auch Dateien aus, die mit einem Punkt (.) beginnen | |
| ls -t | Sortiert nach Änderungszeit | |
| reget | Setzt einen abgebrochenen Download fort (wie get -a) | |
| reput | Setzt einen abgebrochenen Upload fort (wie put -a) | |
| lmkdir | Legt einen lokalen Ordner an | |
| progress | Schaltet 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.
5️⃣ Praxisbeispiele für den sftp-Befehl
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.bakport=8080
log=/var/log/app.logUm 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_htmlEntering site/
Entering site/cssWird 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 wwwput -r site wwwEntering site/
Entering site/cssIst 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@serverssh: connect to host 127.0.0.1 port 2222: Connection refused
Connection closedDa 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_ed25519sftp -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 closedDer 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_ed25519sftp -b - user1@serversftp> pwd
Remote working directory: /home/user1
sftp> byeAuch 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@serverConnection closed by 127.0.0.1 port 22
Connection closedAuf 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@serverusr1@127.0.0.1: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).
Connection closedDie 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.txtdest open "/home/usr1/report.txt": No such file or directoryStand im lokalen Zielpfad von get ein nicht vorhandener Ordner, lautete der Fehler [open local].
get notes.txt nodir/notes.txtopen local "nodir/notes.txt": No such file or directoryAuch 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.txtcat notes.txtlocal editget notes.txtcat notes.txtremote notesDer 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 tmpdirchmod 700 tmpdirChanging mode on /home/user1/tmpdirDie 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 nodirstat remote: No such file or directoryput nolocal.txtstat nolocal.txt: No such file or directoryBeim 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.txtFile "/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
SSH-Zugang
SSH-Befehl: Optionen -l, -p und -i verwenden und Verbindungsfehler prüfen
Anleitung zum SSH-Befehl: Verbindung zu einem Remote-Server in der Form Konto@Server sowie Prüfung der Optionen -l, -p und -i und von Verbindungsfehlern mit ssh -v.
SSH-Einstellungen
SSH-Einstellungen – Funktionen und Einstellungen der Datei /etc/ssh/sshd_config
Artikel über die Einträge der SSH-Server-Konfigurationsdatei /etc/ssh/sshd_config und die Befehle für den SSH-Daemon.
Dateiübertragung
Linux: lrzsz-Tool installieren und Dateien hochladen (rz) und herunterladen (sz)
Installation und Verwendung von lrzsz, mit dem im Terminal Dateien per rz hochgeladen und per sz heruntergeladen werden.
ℹ️ 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.