.\" -*- coding: UTF-8 -*- .\" $OpenBSD: sftp.1,v 1.143 2022/12/16 03:40:03 djm Exp $ .\" .\" Copyright (c) 2001 Damien Miller. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .Dd $Mdocdate: 16 грудня 2022 року $ .Dt SFTP 1 .Os .Sh НАЗВА .Nm sftp .Nd Захищене передавання файлів OpenSSH .Sh КОРОТКИЙ ОПИС .Nm sftp .Op Fl 46AaCfNpqrv .Op Fl B Ar розмір_буфера .Op Fl b Ar пакетний_файл .Op Fl c Ar шифрування .Op Fl D Ar команда_сервера_sftp .Op Fl F Ar налаштування_ssh .Op Fl i Ar файл_профілю .Op Fl J Ar призначення .Op Fl l Ar обмеження .Op Fl o Ar параметр_ssh .Op Fl P Ar порт .Op Fl R Ar кількість_запитів .Op Fl S Ar програма .Op Fl s Ar підсистема | сервер_sftp .Op Fl X Ar параметр_sftp .Ar призначення .Sh ОПИС .Nm є програмою для передавання файлів, подібною до .Xr ftp 1 . Ця програма виконує всі дії з використанням зашифрованого каналу передавання даних .Xr ssh 1 . Вона також може використовувати багато можливостей ssh, зокрема розпізнавання за відкритим ключем та стискання даних. .Pp Значення аргументу .Ar призначення можна вказати у форматі .Sm off .Oo користувач @ Oc вузол Op : шлях .Sm on або, як адресу, у формі .Sm off .No sftp:// Oo користувач @ Oc вузол Oo : порт Oc Op / шлях . .Sm on .Pp Якщо до .Ar призначення включено .Ar шлях , і воно не є каталогом, .Nm отримає файли автоматично, якщо використано неінтерактивний спосіб розпізнавання; якщо ж потрібне інтерактивне розпізнавання, отримання відбудеться після його успішного завершення. .Pp Якщо .Ar шлях не вказано або якщо .Ar шлях є каталогом, .Nm увійде до вказаного .Ar вузла і перейде у режим інтерактивних команд, перейшовши до віддаленого каталогу, якщо такий було вказано. Можна вказати кінцеву похилу риску, щоб вказати програмі, що .Ar шлях слід обробляти як каталог. .Pp Оскільки у форматах призначення використовують символи двокрапки для відокремлення назв вузлів від шляхів або номерів портів, для уникнення неоднозначності у адресах IPv6 слід брати ці адреси у квадратні дужки. .Pp Параметри є такими: .Bl -tag -width Ds .It Fl 4 Примусити .Nm використовувати лише адреси IPv4. .It Fl 6 Примусити .Nm використовувати лише адреси IPv6. .It Fl A Уможливлює переспрямування .Xr ssh-agent 1 на віддалену систему. Типовою поведінкою є робота без переспрямовування агента розпізнавання. .It Fl a Спробувати продовжити перервані сеанси передавання даних, але перезаписувати наявні часткові або повні версії файлів. Якщо частково отримані дані відрізняються від тих, які передає вузол джерела, дані у файлі-результаті, ймовірно пошкоджено. .It Fl B Ar розмір_буфера Вказати розмір буфера, який .Nm використовує для передавання файлів. Збільшення буфера зменшує кількість циклів отримання даних, але збільшує споживання пам'яті. Типовим значенням є 32768 байтів. .It Fl b Ar пакетний_файл У пакетному режимі програма читає послідовність команд з вхідного .Ar пакетного_файла , замість .Em stdin . Оскільки тут не буде взаємодії із користувачем, режим слід використовувати у поєднанні із неінтерактивним розпізнаванням, щоб уникнути потреби у введені пароля під час встановлення з'єднання (докладніше про це на сторінках підручника для .Xr sshd 8 і .Xr ssh-keygen 1 ) . .Pp Замість .Ar пакетного_файла можна вказати .Sq \- , щоб дані було отримано зі стандартного джерела вхідних даних. .Nm перерве роботу, якщо станеться помилка у будь-якій з таких команд: .Ic get , put , reget , reput , rename , ln , .Ic rm , mkdir , chdir , ls , .Ic lchdir , copy , cp , chmod , chown , .Ic chgrp , lpwd , df , symlink і .Ic lmkdir . .Pp Переривання у відповідь на помилку можна скасувати на рівні окремих команд, додавши до команди префікс — символ .Sq \- (наприклад, .Ic -rm /tmp/ляля* ) . Виведення команди до консолі можна придушити додаванням префікса .Sq @ . Ці два префікси можна поєднувати у довільному порядку. Приклад: .Ic -@ls /bsd . .It Fl C Вмикає стискання (з використанням прапорця ssh .Fl C ) . .It Fl c Ar шифрування Вибирає шифрування, яким слід скористатися при шифруванні передавання даних. Цей параметр буде безпосередньо передано .Xr ssh 1 . .It Fl D Ar команда_сервера_sftp Встановлювати з'єднання безпосередньо із локальним сервером SFTP (а не з використанням .Xr ssh 1 ) . Можна вказати команду і аргументи, наприклад .Qq /шлях/sftp-server -el debug3 . Цей параметр може бути корисним при діагностиці роботи клієнта і сервера. .It Fl F Ar налаштування_ssh Вказує альтернативний файл налаштувань користувача для .Xr ssh 1 . Цей параметр буде безпосередньо передано .Xr ssh 1 . .It Fl f Вимагає від програми записувати файли на диск негайно після передавання даних. При вивантаженні файлів цю можливість буде увімкнено, лише якщо на сервері реалізовано розширення «fsync@openssh.com». .It Fl i Ar файл_профілю Вибирає файл, з якого буде прочитано профіль (закритий ключ) для розпізнавання за відкритим ключем. Цей параметр буде безпосередньо передано .Xr ssh 1 . .It Fl J Ar призначення Встановлювати з'єднання із вузлом призначення, спочатку встановивши .Nm у з'єднання із проміжним вузлом, який описано аргументом .Ar призначення , а потім встановивши переспрямовування TCP до остаточного призначення з проміжного вузла. Можна вказати декілька проміжних вузлів, відокремивши їхні записи комами. Це скорочення для визначення інструкції налаштовування .Cm ProxyJump . Цей параметр буде безпосередньо передано .Xr ssh 1 . .It Fl l Ar обмеження Обмежує використання каналу зв'язку, визначається у кбіт/с. .It Fl N Вимикає режим без повідомлень, наприклад, щоб перевизначити неявний режим без повідомлень, який встановлюється прапорцем .Fl b . .It Fl o Ar параметр_ssh Можна скористатися для передавання параметрів .Nm ssh у форматі, який використовує .Xr ssh_config 5 . Корисно для задання параметрів, для яких немає окремих прапорців командного рядка .Nm sftp . Наприклад, щоб вказати альтернативний порт, скористайтеся такою командою: .Ic sftp -oPort=24 . Щоб дізнатися більше про параметри з наведеного нижче списку та їхні можливі значення, ознайомтеся зі сторінкою підручника .Xr ssh_config 5 . .Pp .Bl -tag -width Ds -offset indent -compact .It AddressFamily .It BatchMode .It BindAddress .It BindInterface .It CanonicalDomains .It CanonicalizeFallbackLocal .It CanonicalizeHostname .It CanonicalizeMaxDots .It CanonicalizePermittedCNAMEs .It CASignatureAlgorithms .It CertificateFile .It CheckHostIP .It Ciphers .It Стискання .It ConnectionAttempts .It ConnectTimeout .It ControlMaster .It ControlPath .It ControlPersist .It GlobalKnownHostsFile .It GSSAPIAuthentication .It GSSAPIDelegateCredentials .It HashKnownHosts .It Host .It HostbasedAcceptedAlgorithms .It HostbasedAuthentication .It HostKeyAlgorithms .It HostKeyAlias .It Hostname .It IdentitiesOnly .It IdentityAgent .It IdentityFile .It IPQoS .It KbdInteractiveAuthentication .It KbdInteractiveDevices .It KexAlgorithms .It KnownHostsCommand .It LogLevel .It MACs .It NoHostAuthenticationForLocalhost .It NumberOfPasswordPrompts .It PasswordAuthentication .It PKCS11Provider .It Port .It PreferredAuthentications .It ProxyCommand .It ProxyJump .It PubkeyAcceptedAlgorithms .It PubkeyAuthentication .It RekeyLimit .It RequiredRSASize .It SendEnv .It ServerAliveInterval .It ServerAliveCountMax .It SetEnv .It StrictHostKeyChecking .It TCPKeepAlive .It UpdateHostKeys .It User .It UserKnownHostsFile .It VerifyHostKeyDNS .El .It Fl P Ar порт Визначає номер порту, на якому слід встановити з'єднання із віддаленим вузлом. .It Fl p Зберігає час внесення змін, час доступу і режим з початкових файлів, дані яких передають. .It Fl q Режим без повідомлень: вимикає смужку поступу, а також попередження та діагностичні повідомлення від .Xr ssh 1 . .It Fl R Ar кількість_запитів Вказати, скільки запитів можна видати одночасно. Збільшення кількості запитів дещо підвищує швидкість передавання даних, але також збільшує споживання пам'яті. Типовим є значення у 64 вихідних запитів. .It Fl r Рекурсивно копіювати цілі каталоги при вивантаженні та отриманні. Зауважте, що .Nm не переходитиме за символічними посиланнями, які буде виявлено під час обходу ієрархії каталогів. .It Fl S Ar програма Назва .Ar програми , якою слід скористатися для шифрованого з'єднання. Програма має обробляти параметри .Xr ssh 1 . .It Fl s Ar підсистема | сервер_sftp Вказує підсистему SSH2 або шлях для сервера sftp на віддаленому вузлі. Шлях є корисним, якщо на віддаленому .Xr sshd 8 не налаштовано підсистему sftp. .It Fl v Підвищити рівень журналювання. Цей параметр також буде передано ssh. .It Fl X Ar параметр_sftp Вказати параметр, який керує аспектами поведінки протоколу SFTP. Коректними варіантами є такі: .Bl -tag -width Ds .It Cm ктьзапитів Ns = Ns Ar значення Керує кількістю паралельних запитів щодо читання або запису SFTP, які одночасно може бути використано під час отримання або вивантаження даних. Типово, паралельних активних запитів може бути не більше 64. .It Cm буфер Ns = Ns Ar значення Керує максимальним розміром буфера для однієї використаної дії з читання-запису SFTP під час отримання або вивантаження даних. Типово, буде використано буфер у 32 кБ. .El .El .Sh ІНТЕРАКТИВНІ КОМАНДИ Після переходу до інтерактивного режиму .Nm обробляє набір команд, який є подібним до команд .Xr ftp 1 . Регістр символів у командах не має значення. Шляхи, у яких містяться пробіли, слід брати у лапки. Усі спеціальні символи, які містяться у шляхах і розпізнаються .Xr glob 3 , слід екранувати символами зворотної похилої риски, .Pq Sq \e . .Bl -tag -width Ds .It Ic bye Вийти з .Nm sftp . .It Ic cd Op Ar шлях Змінити віддалений каталог на .Ar шлях . Якщо .Ar шлях не вказано, змінити каталог на той, з якого запущено сеанс. .It Xo Ic chgrp .Op Fl h .Ar група .Ar шлях .Xc Змінити групу файла .Ar шлях на .Ar групу . У .Ar шляху можуть міститися символи .Xr glob 7 , і він може відповідати декількома файлам. Аргументом .Ar група має бути числовий GID. .Pp Якщо вказано прапорець .Fl h , програма не переходитиме за символічними посиланнями. Зауважте, що підтримку передбачено лише для серверів, у яких реалізовано розширення «lsetstat@openssh.com». .It Xo Ic chmod .Op Fl h .Ar режим .Ar шлях .Xc Змінити права доступу до файла .Ar шлях на .Ar режим . У .Ar шляху можуть міститися символи .Xr glob 7 , і він може відповідати декількома файлам. .Pp Якщо вказано прапорець .Fl h , програма не переходитиме за символічними посиланнями. Зауважте, що підтримку передбачено лише для серверів, у яких реалізовано розширення «lsetstat@openssh.com». .It Xo Ic chown .Op Fl h .Ar власник .Ar шлях .Xc Змінити власника файла .Ar шлях на .Ar групу . У .Ar шляху можуть міститися символи .Xr glob 7 , і він може відповідати декількома файлам. Аргументом .Ar власник має бути числовий UID. .Pp Якщо вказано прапорець .Fl h , програма не переходитиме за символічними посиланнями. Зауважте, що підтримку передбачено лише для серверів, у яких реалізовано розширення «lsetstat@openssh.com». .It Ic copy Ar старий_шлях Ar новий_шлях Скопіювати віддалений файл зі .Ar старого_шляху до .Ar нового_шляху . .Pp Зауважте, що підтримку передбачено лише для серверів, у яких реалізовано розширення «copy-data». .It Ic cp Ar старий_шлях Ar новий_шлях Альтернатива команди .Ic copy . .It Xo Ic df .Op Fl hi .Op Ar шлях .Xc Вивести дані щодо користування для файлової системи, у якій міститься поточний каталог (або .Ar шлях , якщо вказано). Якщо вказано прапорець .Fl h , відомості щодо місткості буде виведено з використанням «зручних для читання» суфіксів. Прапорець .Fl i вимагатиме виведення даних щодо inode, додатково до даних щодо місткості. Підтримку цієї команди передбачено лише для серверів, де реалізовано розширення .Dq statvfs@openssh.com . .It Ic exit Вийти з .Nm sftp . .It Xo Ic get .Op Fl afpR .Ar віддалений-шлях .Op Ar локальний-шлях .Xc Отримати дані .Ar віддалений-шлях і зберегти зберегти їх на локальній машині. Якщо локальний шлях не задано, буде використано ту саму назву файла, яку він мав на віддаленій машині. Аргумент .Ar віддалений-шлях може містити символи-замінники .Xr glob 7 і відповідати декільком файлам. Якщо це так, і задано .Ar локальний-шлях , .Ar локальний-шлях має вказувати на каталог. .Pp Якщо вказано прапорець .Fl a , спробувати відновити передавання для частково переданих наявних файлів. Зауважте, що під час відновлення програма припускатиме, що усі часткові копії локальних файлів відповідають віддаленим копіям. Якщо вміст віддаленого файла відрізняється від часткової локальної копії, дані файла-результату, ймовірно, виявляться пошкодженими. .Pp Якщо вказано прапорець .Fl f , буде викликано .Xr fsync 2 після перенесення даних файла, щоб скинути дані файла на диск. .Pp .\" undocumented redundant alias .\" or .\" .Fl P Якщо вказано прапорець .Fl p , буде скопійовано усі права доступу та усі дані щодо часу доступу. .Pp .\" undocumented redundant alias .\" or .\" .Fl r Якщо вказано прапорець .Fl R , каталоги буде скопійовано рекурсивно. Зауважте, що .Nm не переходитиме за символічними посиланнями при виконанні рекурсивного передавання даних. .It Ic help Вивести текст довідки. .It Ic lcd Op Ar шлях Змінити локальний каталог на .Ar шлях . Якщо .Ar шлях не вказано, змінити каталог на домашній каталог локального користувача. .It Ic lls Op Ar параметри-ls Op Ar шлях Вивести список локальних каталогів або .Ar шляху або поточного каталогу, якщо .Ar шлях не вказано. В аргументі .Ar параметри-ls можуть міститися будь-які параметри, підтримку яких було передбачено у команді .Xr ls 1 локальної системи. Аргумент .Ar шлях може містити символи-замінники .Xr glob 7 і може відповідати декільком файлам. .It Ic lmkdir Ar шлях Створити локальний каталог, який вказано аргументом .Ar шлях . .It Xo Ic ln .Op Fl s .Ar старий_шлях .Ar новий_шлях .Xc Створити посилання з .Ar старий_шлях на .Ar новий_шлях . Якщо вказано прапорець .Fl s , створене посилання буде символічним; якщо прапорець не вказано, буде створено жорстке посилання. .It Ic lpwd Вивести поточний робочий каталог. .It Xo Ic ls .Op Fl 1afhlnrSt .Op Ar шлях .Xc Вивести список вмісту віддаленого каталогу або .Ar шляху або поточного каталогу, якщо .Ar шлях не вказано. Аргумент .Ar шлях може містити символи-замінники .Xr glob 7 і може відповідати декільком файлам. .Pp Передбачено розпізнавання вказаних нижче прапорців для відповідної зміни поведінки .Ic ls : .Bl -tag -width Ds .It Fl 1 Виводити дані у один стовпчик. .It Fl a Вивести список файлів, назви яких починаються з крапки .Pq Sq \&. . .It Fl f Не упорядковувати список. Типовим є лексикографічний порядок. .It Fl h При використанні параметра у довгому форматі використовують суфікси одиниць: байт, кілобайт, мегабайт, гігабайт, терабайт, петабайт та ексабайт, щоб зменшити кількість цифр до чотирьох або меншої кількості. Для обчислення одиниць використовують степені двійки (K=1024, M=1048576 тощо). .It Fl l Вивести додаткові подробиці, зокрема дані щодо прав доступу та власника файлів. .It Fl n Вивести довгий список із даними щодо користувачів і груп у числовій формі. .It Fl r Обернути порядок у списку. .It Fl S Упорядкувати список за розміром файлів. .It Fl t Упорядкувати список за часом внесення останніх змін. .El .It Ic lumask Ar маска Встановити для локальної umask значення .Ar маска . .It Ic mkdir Ar шлях Створити віддалений каталог, який вказано аргументом .Ar шлях . .It Ic progress Увімкнути або вимкнути показ смужки поступу. .It Xo Ic put .Op Fl afpR .Ar локальний-шлях .Op Ar віддалений-шлях .Xc Вивантажити дані .Ar локальний-шлях і зберегти зберегти їх на віддаленій машині. Якщо віддалений шлях не задано, буде використано ту саму назву файла, яку він мав на локальній машині. Аргумент .Ar локальний-шлях може містити символи-замінники .Xr glob 7 і відповідати декільком файлам. Якщо це так, і задано .Ar віддалений-шлях , .Ar віддалений-шлях має вказувати на каталог. .Pp Якщо вказано прапорець .Fl a , спробувати відновити передавання для частково переданих наявних файлів. Зауважте, що під час відновлення програма припускатиме, що усі часткові копії віддалених файлів відповідають локальним копіям. Якщо вміст локального файла відрізняється від часткової віддаленої копії, дані файла-результату, ймовірно, виявляться пошкодженими. .Pp Якщо вказано прапорець .Fl f , на сервер буде надіслано запит щодо виклику .Xr fsync 2 після завершення передавання файла. Зауважте, що підтримку цієї дії передбачено лише для серверів, на яких реалізовано розширення «fsync@openssh.com». .Pp .\" undocumented redundant alias .\" or .\" .Fl P Якщо вказано прапорець .Fl p , буде скопійовано усі права доступу та усі дані щодо часу доступу. .Pp .\" undocumented redundant alias .\" or .\" .Fl r Якщо вказано прапорець .Fl R , каталоги буде скопійовано рекурсивно. Зауважте, що .Nm не переходитиме за символічними посиланнями при виконанні рекурсивного передавання даних. .It Ic pwd Вивести віддалений робочий каталог. .It Ic quit Вийти з .Nm sftp . .It Xo Ic reget .Op Fl fpR .Ar віддалений-шлях .Op Ar локальний-шлях .Xc Відновити отримання даних .Ar віддаленого-шляху . Еквівалент .Ic get зі встановленим прапорцем .Fl a . .It Xo Ic reput .Op Fl fpR .Ar локальний-шлях .Op Ar віддалений-шлях .Xc Відновити вивантаження даних .Ar локального-шляху . Еквівалент .Ic put зі встановленим прапорцем .Fl a . .It Ic rename Ar старий_шлях новий_шлях Перейменувати віддалений файл зі .Ar старий_шлях на .Ar новий_шлях . .It Ic rm Ar шлях Вилучити віддалений файл, який задано аргументом .Ar шлях . .It Ic rmdir Ar шлях Вилучити віддалений каталог, який вказано аргументом .Ar шлях . .It Ic symlink Ar старий_шлях новий_шлях Створити символічне посилання зі .Ar старого_шляху на .Ar новий_шлях . .It Ic version Вивести версію протоколу .Nm . .It Ic \&! Ns Ar команда Виконати .Ar команду у локальній командній оболонці. .It Ic \&! Повернутися до локальної командної оболонки. .It Ic \&? Синонім help. .El .Sh ДИВ. ТАКОЖ .Xr ftp 1 , .Xr ls 1 , .Xr scp 1 , .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , .Xr ssh_config 5 , .Xr glob 7 , .Xr sftp-server 8 , .Xr sshd 8 .Rs .%A T. Ylonen .%A S. Lehtinen .%T "SSH File Transfer Protocol" .%N draft-ietf-secsh-filexfer-00.txt .%D January 2001 .%O роботу над текстом не завершено .Re .Pp .Sh ПЕРЕКЛАД Український переклад цієї сторінки посібника виконано Yuri Chornoivan . .Pp Цей переклад є безкоштовною документацією; будь ласка, ознайомтеся з умовами .Lk https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 . НЕ НАДАЄТЬСЯ ЖОДНИХ ГАРАНТІЙ. .Pp Якщо ви знайшли помилки у перекладі цієї сторінки підручника, будь ласка, надішліть електронний лист до списку листування перекладачів: .Mt trans-uk@lists.fedoraproject.org .Me .