Руководства по командной строке

Man » scp Manual online — подробная онлайн-документация для страницы руководства scp

🌍
scp — безопасное копирование файлов OpenSSH

СИНТАКСИС

scp [-346ABCOpqRrsTv] [-c cipher] [-D sftp_server_path] [-F ssh_config] [-i identity_file]
[-J destination] [-l limit] [-o ssh_option] [-P port] [-S program] [-X sftp_option] source
... target

ОПИСАНИЕ

scp копирует файлы между хостами в сети.

scp использует протокол SFTP по соединению ssh(1) для передачи данных и обеспечивает ту же аутентификацию и безопасность, что и при входе в систему.

scp запросит пароли или парольные фразы, если они потребуются для аутентификации.

Исходный и целевой файлы могут быть указаны как локальный путь, удаленный хост с необязательным путем в форме [user@]host:[path] или URI в форме scp://[user@]host[:port][/path]. Локальные имена файлов могут быть указаны явно, используя абсолютные или относительные пути, чтобы scp не воспринимал имена файлов, содержащие символ «:», как спецификаторы хоста.

При копировании между двумя удаленными хостами, если используется формат URI, порт не может быть указан в целевом файле, если используется опция -R.

Опции следующие:

-3      При копировании между двумя удаленными хостами передача осуществляется через локальный хост. Это режим по умолчанию, но также см. опцию -R для копирования данных непосредственно между двумя удаленными хостами.

Обратите внимание, что при использовании устаревшего протокола SCP (через флаг -O), эта опция выбирает пакетный режим для второго хоста, поскольку scp не может запрашивать пароли или парольные фразы для обоих хостов.

-4      Принудительно использует только IPv4-адреса.

-6      Принудительно использует только IPv6-адреса.

-A      Разрешает пересылку ssh-agent(1) на удаленную систему. По умолчанию пересылка агента аутентификации не разрешена.

-B      Включает пакетный режим (предотвращает запрос паролей или парольных фраз).

-C      Включает сжатие. Передает флаг -C в [ssh]({filename}../../ssh)(1) для включения сжатия.

-c cipher

Выбирает шифр для шифрования передачи данных. Эта опция непосредственно передается в ssh(1).

-D sftp_server_path

Подключается непосредственно к локальной программе SFTP-сервера, а не к удаленному через ssh(1). Эта опция может быть полезна для отладки клиента и сервера.

-F ssh_config

Указывает альтернативный файл конфигурации для каждого пользователя для ssh. Эта опция непосредственно передается в ssh(1).

-i identity_file

Указывает файл, из которого считывается идентификатор (приватный ключ) для аутентификации с использованием открытого ключа. Эта опция непосредственно передается в ssh(1).

-J destination

Подключается к целевому хосту, сначала устанавливая соединение scp с промежуточным хостом, указанным в destination, а затем устанавливая TCP-туннель к конечному пункту назначения. Можно указать несколько промежуточных узлов, разделенных запятыми. Это упрощенный способ указать директиву ProxyJump. Эта опция непосредственно передается в ssh(1).

-l limit

Ограничивает используемую пропускную способность, указанную в Кбит/с.

-O      Использует устаревший протокол SCP для передачи файлов вместо протокола SFTP. Принудительное использование протокола SCP может потребоваться для серверов, которые не реализуют SFTP, для обеспечения обратной совместимости с определенными шаблонами подстановочных знаков в именах файлов и для расширения путей с префиксом «~» для старых серверов SFTP.

-o ssh_option

Может использоваться для передачи опций в ssh в формате, используемом в ssh_config(5). Это полезно для указания опций, для которых нет отдельного флага командной строки scp. Для получения подробной информации об опциях, перечисленных ниже, и их возможных значениях см. 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

Указывает порт, к которому необходимо подключиться на удаленном хосте. Обратите внимание, что эта опция написана с заглавной буквой «P», потому что -p уже зарезервирована для сохранения времени изменения и режима файла.

-p      Сохраняет время изменения, время доступа и биты режима файла из исходного файла.

-q      Тихий режим: отключает индикатор выполнения, а также предупреждающие и диагностические сообщения из [ssh]({filename}../../ssh)(1).

-R      При копировании между двумя удаленными хостами по умолчанию передача осуществляется через локальный хост. Эта опция вместо этого копирует данные между двумя удаленными хостами, подключаясь к исходному хосту, а затем устанавливая соединение scp с целевым хостом.

-r      Рекурсивно копирует каталоги.

-v      Подробный вывод, отображает отладочные сообщения.

-w      Включает сжатие данных при передаче.

-X      Запрашивает включение пересылки X11.

-Y      Запрашивает включение доверенной пересылки X11.

-z      Включает сжатие при передаче.

-1      Заставляет scp использовать протокол версии 1 вместо протокола версии 2.

-2      Заставляет scp использовать протокол версии 2.

СТАТУС ВЫХОДА

Утилита scp завершается с кодом 0 в случае успеха и >0 в случае ошибки.

СМ. ТАКЖЕ

sftp(1), ssh(1), ssh-add(1), ssh-agent(1), ssh-keygen(1), ssh_config(5), sftp-server(8), sshd(8)

ИСТОРИЯ

`scp` основана на программе `rcp` из исходного кода BSD, принадлежащего регентам Калифорнийского университета.

Начиная с OpenSSH 9.0, scp по умолчанию использует протокол SFTP для передачи данных.

АВТОРЫ

Тимо Ринне <_> Тату Илонен <_>

ПРЕДОСТЕРЕЖЕНИЯ

Старый протокол SCP (выбирается флагом -O) требует выполнения оболочки удаленного пользователя для выполнения сопоставления шаблонов glob(3). Это требует осторожного заключения в кавычки любых символов, которые имеют специальное значение для удаленной оболочки, таких как символы кавычек.