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 sftp.

!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 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