Ubuntu Manpage: sftp — bezpieczny transfer plików przez OpenSSH

NAZWA

       sftp — bezpieczny transfer plików przez OpenSSH

SKŁADNIA

       sftp  [-46AaCfNpqrv]  [-B  rozmiar-bufora]  [-b  plik-wsadowy] [-c szyfr] [-D polecenie-serwera-sftp] [-F
       plik_konfig_ssh] [-i plik-tożsamości] [-J położenie-docelowe] [-l limit] [-o  opcje_ssh]  [-P  port]  [-R
       liczba-żądań] [-S program] [-s podsystem | serwer-sftp] [-X opcje_sftp] cel

OPIS

sftp jest programem do transferu plików, podobnym do ftp(1), który przeprowadza wszelkie operacje za
pośrednictwem szyfrowanego połączenia ssh(1). Może również korzystać z wielu funkcji ssh, takich jak
uwierzytelnienie kluczem publicznym lub kompresji.

Cel można podać jako [użytkownik@]stacja[:ścieżka] lub jako URI w postaci
sftp://[użytkownik@]stacja[:port][/ścieżka].

Jeśli cel zawiera ścieżkę i nie jest to katalog, sftp pobierze pliki automatycznie, jeśli użyto
nieinteraktywnej metody uwierzytelnienia; w innym przypadku zrobi to po pomyślnym, interaktywnym
uwierzytelnieniu.

Jeśli nie podano ścieżki lub jeśli ścieżka jest katalogiem, sftp zaloguje się do podanej stacji i wejdzie
w interaktywny tryb poleceń, przechodząc do katalogu zdalnego, jeśli go podano. Na końcu ścieżki można
opcjonalnie podać ukośnik, aby wymusić jej interpretację jako katalog.

Ponieważ formaty celu używają dwukropka do rozdzielenia nazw stacji od ścieżek lub numerów portów, adresy
IPv6 trzeba ująć w kwadratowe nawiasy, aby uniknąć niejednoznaczności.

Dostępne są następujące opcje:

-4 Wymusza na sftp używanie tylko adresów IPv4.

-6 Wymusza na sftp używanie tylko adresów IPv6.

-A Pozwala na przekierowanie ssh-agent(1) do komputera zdalnego. Domyślnie agent autoryzujący nie
jest przekierowywany.

-a Próbuje kontynuować przerwane transfery, zamiast nadpisywać istniejące częściowe lub kompletne
kopie plików. Jeśli częściowa zawartość różni się od tej pobieranej, wynikowy plik zwykle okaże
się uszkodzony.

-B rozmiar-bufora
Określa rozmiar bufora, który sftp używa przy transferowaniu plików. Większy bufor ogranicza
ilość dwustronnej komunikacji, kosztem większego użycia pamięci. Wartość domyślna to 32 768
bajtów.

-b plik-wsadowy
Tryb wsadowy odczytuje listę poleceń z wejściowego pliku-wsadowego zamiast ze standardowego
wejścia. Jako że nie ma możliwości interakcji z użytkownikiem, należy stosować nieinteraktywne
metody uwierzytelniania, aby ominąć potrzebę wpisywania hasła przy łączeniu (więcej szczegółów w
podręcznikach sshd(8) i ssh-keygen(1).

Plik-wsadowy o wartości „-” oznacza standardowe wejście. sftp przerwie działanie, jeśli
zawiedzie dowolne z poleceń: get, put, reget, reput, rename, ln, rm, mkdir, chdir, ls, lchdir,
copy, cp, chmod, chown, chgrp, lpwd, df, symlink lub lmkdir.

Przerwanie działania przy błędzie można wyłączyć dla danego polecenia, poprzedzając je znakiem
„-” (np. -rm /tmp/bla*). Wypisywanie wyjścia polecenia można wyłączyć poprzedzając je znakiem
„@”. Te dwa przedrostki można łączyć w dowolnej kolejności np. -@ls /bsd.

-C Włącza kompresję (opcją -C ssh).

-c szyfr
Wybiera szyfr, używany do szyfrowania transferowanych danych. Opcja ta jest bezpośrednio
przekazywana ssh(1).

-D polecenie-serwera-sftp
Łączy bezpośrednio z lokalnym serwerem sftp (zamiast za pomocą ssh(1)). Można podać polecenie
wraz z argumentami np. "/ścieżka/sftp-server -el debug3". Opcja ta może być przydatna przy
debugowaniu klienta i serwera.

-F plik_konfig_ssh
Określa alternatywny plik konfiguracyjny użytkownika programu ssh(1). Opcja ta jest bezpośrednio
przekazywana ssh(1).

-f Żąda, aby pliki były opróżniane na dysk bezpośrednio po transferze. Przy wysyłaniu plików,
funkcja ta jest włączona tylko, jeśli serwer implementuje rozszerzenie „fsync@openssh.com”.

-i plik-tożsamości
Wybiera plik, z którego odczytywana jest tożsamość (klucz prywatny) dla uwierzytelnienia za
pomocą klucza publicznego. Opcja ta jest przekazywana bezpośrednio do ssh(1).

-J położenie-docelowe
Łączy z komputerem docelowym tworząc najpierw połączenie sftp aby przejść do komputera
określonego argumentem cel, a następnie tworząc połączenie TCP do ostatecznego adresata. Można
podać kilka skoków rozdzielając je znakiem przecinka. Jest to skrót do dyrektywy konfiguracyjnej
ProxyJump. Opcja jest bezpośrednio przekazywana ssh(1).

-l limit
Określa maksymalną prędkość transferu danych podaną w Kbit/s.

-N Wyłącza tryb cichy tj. przesłania dorozumiany tryb cichy ustawiany opcją -b.

-o opcje_ssh
Może służyć do przekazania opcji do ssh w formacie opisanym w podręczniku ssh_config(5).
Przydatne do podawania opcji, które nie posiadają oddzielnej opcji wiersza poleceń sftp. Na
przykład można podać alternatywny port: sftp -oPort=24. Pełny opis poniższych opcji i ich
możliwych wartości znajduje się w podręczniku ssh_config(5).

AddKeysToAgent
AddressFamily
BatchMode
BindAddress
BindInterface
CASignatureAlgorithms
CanonicalDomains
CanonicalizeFallbackLocal
CanonicalizeHostname
CanonicalizeMaxDots
CanonicalizePermittedCNAMEs
CertificateFile
ChannelTimeout
CheckHostIP
Ciphers
ClearAllForwardings
Compression
ConnectTimeout
ConnectionAttempts
ControlMaster
ControlPath
ControlPersist
DynamicForward
EnableEscapeCommandline
EnableSSHKeysign
EscapeChar
ExitOnForwardFailure
FingerprintHash
ForkAfterAuthentication
ForwardAgent
ForwardX11
ForwardX11Timeout
ForwardX11Trusted
GSSAPIAuthentication
GSSAPIDelegateCredentials
GatewayPorts
GlobalKnownHostsFile
HashKnownHosts
Host
HostKeyAlgorithms
HostKeyAlias
HostbasedAcceptedAlgorithms
HostbasedAuthentication
Hostname
IPQoS
IdentitiesOnly
IdentityAgent
IdentityFile
IgnoreUnknown
Include
KbdInteractiveAuthentication
KbdInteractiveDevices
KexAlgorithms
KnownHostsCommand
LocalCommand
LocalForward
LogLevel
LogVerbose
MACs
NoHostAuthenticationForLocalhost
NumberOfPasswordPrompts
ObscureKeystrokeTiming
PKCS11Provider
PasswordAuthentication
PermitLocalCommand
PermitRemoteOpen
Port
PreferredAuthentications
ProxyCommand
ProxyJump
ProxyUseFdpass
PubkeyAcceptedAlgorithms
PubkeyAuthentication
RekeyLimit
RemoteCommand
RemoteForward
RequestTTY
RequiredRSASize
RevokedHostKeys
SecurityKeyProvider
SendEnv
ServerAliveCountMax
ServerAliveInterval
SessionType
SetEnv
StdinNull
StreamLocalBindMask
StreamLocalBindUnlink
StrictHostKeyChecking
SyslogFacility
TCPKeepAlive
Tag
Tunnel
TunnelDevice
UpdateHostKeys
User
UserKnownHostsFile
VerifyHostKeyDNS
VisualHostKey
XAuthLocation

-P port
Określa port na zdalnej stacji, z którym nastąpi połączenie.

-p Przy transferze zachowuje czas modyfikacji i dostępu oraz tryby pierwotnych plików.

-q Tryb cichy: wyłącza pasek postępu oraz ostrzeżenia i komunikaty diagnostyczne z programu ssh(1).

-R liczba-żądań
Określa jak wiele żądań może występować w tym samym momencie. Zwiększenie tej liczby może nieco
przyspieszyć prędkość transferu, ale użyje więcej pamięci. Wartość domyślna: 64 żądania
wychodzące.

-r Rekurencyjnie kopiuje całe katalogi przy wysyłaniu i pobieraniu. Proszę zauważyć, że sftp nie
podąża za dowiązaniami symbolicznymi przy przechodzeniu przez drzewo katalogów.

-S program
Nazwa programu służącego do szyfrowania połączenia. Program musi rozpoznawać opcje ssh(1).

-s podsystem | serwer-sftp
Określa podsystem SSH2 lub ścieżkę do serwera sftp na zdalnej stacji. Ścieżka jest przydatna, gdy
zdalny demon sshd(8) nie posiada skonfigurowanego podsystemu sftp.

-v Podnosi poziom szczegółowości komunikatów. Opcja ta jest także przekazywana do ssh.

-o opcje_sftp
Określa opcję kontrolującą aspekt zachowania protokołu SFTP. Dozwolone opcje to:

nrequests=wartość
Kontroluje jak wiele równoległych żądań odczytu lub zapisu SFTP może być w toku w
dowolnym momencie pobierania lub wysyłania. Domyślnie aktywne mogą być równolegle 64
żądania.

buffer=wartość
Kontroluje maksymalny rozmiar bufora dla pojedynczej operacji odczytu/zapisu SFTP przy
pobieraniu lub wysyłaniu. Domyślna wielkość bufora to 32KB.

POLECENIA INTERAKTYWNE

Po przejściu w tryb interaktywny, sftp rozpoznaje zestaw poleceń, podobnych do ftp(1). Wielkość znaków w
poleceniach nie ma znaczenia. Ścieżki zawierające spacje, trzeba ująć w cudzysłowy. Wszelkie znaki
specjalne w ścieżkach, które są rozpoznawane przez glob(3), trzeba ochronić za pomocą odwrotnych
ukośników „\”.

bye Zamyka sftp.

cd [ścieżka]
Zmienia katalog zdalny na ścieżkę. Jeśli nie poda się ścieżki, zmienia katalog na ten, w którym
została uruchomiona sesja.

chgrp [-h] grupa ścieżka
Zmienia grupę pliku ścieżka na grupę. Ścieżka może zawierać wieloznaczniki glob(7) i może
dopasować wiele plików. Grupa musi być numerycznym identyfikatorem grupy.

Jeśli poda się -h, to nie podąża się za dowiązaniami symbolicznymi. Proszę zauważyć, że jest to
obsługiwane tylko przez serwery implementujące rozszerzenie „lsetstat@openssh.com”.

chmod [-h] tryb ścieżka
Zmienia uprawnienia pliku ścieżka na tryb. Ścieżka może zawierać wieloznaczniki glob(7) i może
dopasować wiele plików.

Jeśli poda się -h, to nie podąża się za dowiązaniami symbolicznymi. Proszę zauważyć, że jest to
obsługiwane tylko przez serwery implementujące rozszerzenie „lsetstat@openssh.com”.

chown [-h] właściciel ścieżka
Zmienia właściciela pliku ścieżka na właściciela. Ścieżka może zawierać wieloznaczniki glob(7) i
może dopasować wiele plików. Właściciel musi być numerycznym identyfikatorem użytkownika.

Jeśli poda się -h, to nie podąża się za dowiązaniami symbolicznymi. Proszę zauważyć, że jest to
obsługiwane tylko przez serwery implementujące rozszerzenie „lsetstat@openssh.com”.

copy stara-ścieżka nowa-ścieżka
Kopiuje zdalny plik ze starej-ścieżki na nową-ścieżkę.

Proszę zauważyć, że jest to obsługiwane tylko przez serwery implementujące rozszerzenie „copy-
data”.

cp stara-ścieżka nowa-ścieżka
Alias polecenia copy.

df [-hi] [ścieżka]
Wyświetla informacje o zajętości systemu plików zawierającego bieżący katalog (lub ścieżkę, jeśli
ją podano). Jeśli podano -h, informacje o zajętości będą wyświetlane za pomocą jednostek
„czytelnych dla człowieka”. -i żąda dodatkowego wyświetlania informacji o i-węzłach. Polecenie
to jest obsługiwane tylko na serwerach implementujących rozszerzenie „statvfs@openssh.com”.

exit Zamyka sftp.

get [-afpR] zdalna-ścieżka [lokalna-ścieżka]
Pobiera element ze zdalnej-ścieżki na lokalny komputer. Jeśli nie poda się nazwy lokalnej
ścieżki, otrzymuje on taką samą nazwę jak na komputerze zdalnym. Zdalna-ścieżka może zawierać
wieloznaczniki glob(7) i może dopasować wiele plików. Jeśli tak będzie i poda się
lokalną-ścieżkę, to lokalna-ścieżka musi określać katalog.

Jeśli poda się -a, zostanie podjęta próba wznowienia transferu istniejących plików. Proszę
zauważyć, że następuje to przy założeniu, że fragmentaryczne kopie lokalnych plików odpowiadają
plikom zdalnym. Jeśli treść pliku zdalnego różni się od fragmentarycznej lokalnej kopii, to
wynikowy plik zwykle okaże się uszkodzony.

Jeśli poda się -f, to po ukończeniu transferu zostanie wywołane fsync(2), aby opróżnić plik na
dysk.

Jeśli poda się -p, to kopiowane są również pełne uprawnienia i czasy dostępu.

Jeśli poda się -R, to katalogi zostaną skopiowane rekurencyjnie. Proszę zauważyć, że sftp nie
podąża za dowiązaniami symbolicznymi.

help Wyświetla pomoc.

lcd [ścieżka]
Zmienia katalog lokalny na ścieżkę. Jeśli nie poda się ścieżki, to zmienia katalog na katalog
domowy użytkownika lokalnego.

lls [opcje-ls [ścieżka]]
Wyświetla zawartość lokalnego katalogu określonego ścieżką lub katalogu bieżącego, jeśli nie
podano ścieżki. Opcje-ls mogą zawierać dowolne opcje obsługiwane przez polecenie ls(1) lokalnego
systemu. Ścieżka może zawierać wieloznaczniki glob(7) i może dopasować wiele plików.

lmkdir ścieżka
Tworzy lokalny katalog określony ścieżką.

ln [-s] stara-ścieżka nowa ścieżka
Tworzy dowiązanie ze starej-ścieżki do nowej-ścieżki. Jeśli podano -s będzie to dowiązanie
symboliczne, w innym przypadku tworzone jest dowiązanie zwykłe (twarde).

lpwd Wypisuje lokalny katalog roboczy.

ls [-1afhlnrSt] [ścieżka]
Wyświetla zawartość katalogu zdalnego określonego ścieżką lub katalogu bieżącego, jeśli nie
podano ścieżki. Ścieżka może zawierać wieloznaczniki glob(7) i może dopasować wiele plików.

Rozpoznawane są następujące opcje, które odpowiednio modyfikują zachowanie ls:

-1 Tworzy wyjście w jednej kolumnie.

-a Wypisuje pliki zaczynające się od kropki „.”.

-f Nie sortuje zawartości. Domyślnie sortowanie następuje według porządku
leksykograficznego.

-h Przy korzystaniu z opcji długiego formatu, korzysta z przyrostków jednostek: bajt,
kilobajt, megabajt, gigabajt, terabajt, petabajt i eksabajt, aby zmniejszyć liczbę cyfr
do co najwyżej czterech, korzystając z potęgi dwójki (K=1024, M=1048576, itd.).

-l Wyświetla dodatkowe szczegóły, w tym uprawnienia i informacje o właścicielu.

-n Wypisuje w długim formacie, z informacjami o użytkowniku i grupie w postaci numerycznej.

-r Odwraca kolejność sortowania wypisania.

-S Sortuje wypisanie według rozmiar pliku

-t Sortuje wypisanie według czasu ostatniej modyfikacji.

lumask umask
Ustawia lokalną maskę umask na umask.

mkdir ścieżka
Tworzy katalog zdalny określony ścieżką.

progress
Przełącza wyświetlanie miernika postępu.

put [-afpR] lokalna-ścieżka [zdalna-ścieżka]
Wysyła element z lokalnej-ścieżki na zdalny komputer. Jeśli nie poda się nazwy zdalnej ścieżki,
otrzymuje on taką samą nazwę jak na komputerze lokalnym. Lokalna-ścieżka może zawierać
wieloznaczniki glob(7) i może dopasować wiele plików. Jeśli tak będzie i poda się zdalną-ścieżkę,
to zdalna-cieżka musi określać katalog.

Jeśli poda się -a, zostanie podjęta próba wznowienia transferu istniejących plików. Proszę
zauważyć, że następuje to przy założeniu, że fragmentaryczne kopie zdalnych plików odpowiadają
plikom lokalnym. Jeśli treść pliku lokalnego różni się od fragmentarycznej zdalnej kopii, to
wynikowy plik zwykle okaże się uszkodzony.

Jeśli poda się -f, to do serwera zostanie przesłane żądanie wywołania fsync(2) po zakończonym
transferze pliku. Proszę zauważyć, że jest to obsługiwane tylko przez serwery implementujące
rozszerzenie „fsync@openssh.com”.

Jeśli poda się -p, to kopiowane są również pełne uprawnienia i czasy dostępu.

Jeśli poda się -R, to katalogi zostaną skopiowane rekurencyjnie. Proszę zauważyć, że sftp nie
podąża za dowiązaniami symbolicznymi.

pwd Wyświetla zdalny katalog roboczy.

quit Zamyka sftp.

reget [-fpR] zdalna-ścieżka [lokalna-ścieżka]
Wznawia pobieranie elementu określonego lokalną-ściezką. Równoważne get z opcją -a.

reput [-fpR] lokalna-ściezka [zdalna-ścieżka]
Wznawia wysyłanie elementu określonego lokalną-ściezką. Równoważne put z opcją -a.

rename stara-ścieżka nowa-ścieżka
Zmienia nazwę zdalnego pliku ze starej-ścieżki na nową-ściezkę.

rm ścieżka
Usuwa zdalny plik określony ścieżką.

rmdir ścieżka
Usuwa zdalny katalog określony ścieżką.

symlink stara-ścieżka nowa-ścieżka
Tworzy dowiązanie symboliczne ze starej-ścieżki do nowej-ścieżki.

version
Wyświetla wersję protokołu .

!polecenie
Wykonuje polecenie w lokalnej powłoce.

! Ucieczka do lokalnej powłoki.

? Synonim help.

ZOBACZ TAKŻE

       ftp(1), ls(1), scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5), glob(7), sftp-server(8), sshd(8)
       T. Ylonen and S. Lehtinen, SSH File Transfer Protocol,  draft-ietf-secsh-filexfer-00.txt,  styczeń  2001,
       materiał w opracowaniu.

TŁUMACZENIE

       Tłumaczenie niniejszej strony podręcznika: Michał Kułach <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją.  Bliższe informacje o warunkach licencji można uzyskać
       zapoznając się z GNU General Public License w  wersji  3:  https://www.gnu.org/licenses/gpl-3.0.html  lub
       nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

       Błędy    w    tłumaczeniu    strony   podręcznika   prosimy   zgłaszać   na   adres   listy   dyskusyjnej
       manpages-pl-list@lists.sourceforge.net .

Debian                                          December 6, 2024                                         SFTP(1)