云博浩克

外观

scp

约 1654 字大约 6 分钟

2025-01-18

Linux scp 命令用于 Linux 之间复制文件和目录。scp 是加密的，rcp 是不加密的，scp 是 rcp 的加强版。

scp 是 secure copy 的缩写, scp 是 linux 系统下基于 ssh 登陆进行安全的远程文件拷贝命令。

在 Linux 系统中，scp 命令是一个非常实用的工具，它基于 SSH（Secure Shell）协议，确保数据传输的安全性。

语法

scp [-1246BCpqrv] [-c cipher] [-F ssh_config] [-i identity_file]
[-l limit] [-o ssh_option] [-P port] [-S program]
[[user@]host1:]file1 [...] [[user@]host2:]file2

一般使用如下简约的格式

scp [选项] [源文件] [目标路径]
  • [选项]：用于指定 scp 命令的行为，例如递归复制、保留文件属性等。
  • [源文件]：要复制的文件或目录的路径。
  • [目标路径]：文件或目录要复制到的目标路径。

常用选项:

以下是一些常用的 scp 命令选项：

  • -r：递归复制整个目录。
  • -P：指定远程主机的 SSH 端口号（默认是 22）。
  • -p：保留文件的修改时间、访问时间和权限。
  • -v：显示详细的调试信息，有助于排查问题。
  • -C：启用压缩，可以加快传输速度。

完整选项说明：

  • -1： 强制scp命令使用协议ssh1
  • -2： 强制scp命令使用协议ssh2
  • -4： 强制scp命令只使用IPv4寻址
  • -6： 强制scp命令只使用IPv6寻址
  • -B： 使用批处理模式（传输过程中不询问传输口令或短语）
  • -C： 允许压缩。（将-C标志传递给ssh，从而打开压缩功能）
  • -p：保留原文件的修改时间，访问时间和访问权限。
  • -q： 不显示传输进度条。
  • -r： 递归复制整个目录。
  • -v：详细方式显示输出。scp和ssh(1)会显示出整个过程的调试信息。这些信息用于调试连接，验证和配置问题。
  • -c cipher： 以cipher将数据传输进行加密，这个选项将直接传递给ssh。
  • -F ssh_config： 指定一个替代的ssh配置文件，此参数直接传递给ssh。
  • -i identity_file： 从指定文件中读取传输时使用的密钥文件，此参数直接传递给ssh。
  • -l limit： 限定用户所能使用的带宽，以Kbit/s为单位。
  • -o ssh_option： 如果习惯于使用ssh_config(5)中的参数传递方式，
  • -P port：注意是大写的P, port是指定数据传输用到的端口号
  • -S program： 指定加密传输时所使用的程序。此程序必须能够理解ssh(1)的选项。

使用

从本地复制文件到远程主机

假设需要把当前文件夹中的一个文件 example.txt，复制到远程主机的 /home/user/ 目录下，可以使用以下命令：

$ scp ./example.txt user@remote_host:/home/user/
  • example.txt 是本地文件。
  • user@remote_host_ip 是远程主机的用户名和地址。
  • /home/user/ 是远程主机上的目标路径。

注意 scp命令是基于 SSH（Secure Shell）协议的，如果使用$ scp ./example.txt remote_host:/home/user/命令执行后需要输入用户名和密码，如果使用``$ scp ./example.txt user@remote_host:/home/user/`命令执行后需要输入密码。

提示 这里使用用户名和主机地址来指定远程主机，需要输入密码。也配置免密登录，使用Host别名访问。具体可参考SSH 免密登录

例如我们使用如下的免密登录配置：

Host test
HostName remote_host_ip
User root
Port 22
IdentityFile ~/.ssh/id_rsa

注意 HostName 可以配置为域名或IP。

直接使用别名test来访问远程主机：

$ scp ./example.txt test:/home/user/

从远程主机复制文件到本地

如果需要将远程主机上的/home/user/example.txt文件复制到本地的当前目录，可以使用以下命令：

$ scp user@remote_host:/home/user/example.txt .
  • user@remote_host:/home/user/example.txt 是远程主机上的文件路径。
  • . 表示当前目录。

递归复制目录

如果你想复制整个目录及其内容，可以使用 -r 选项递归复制目录。例如，将本地的 my_directory 目录复制到远程主机的 /home/user/ 目录下：

$ scp -r my_directory user@remote_host:/home/user/

指定端口号

如果远程主机的 SSH 服务运行在非默认端口（例如 2222，默认端口为22），你可以使用 -P 选项指定端口号：

$ scp -P 2222 example.txt user@remote_host:/home/user/

提示 如果使用SSH 免密登录则需要在配置的时候指定端口。

保留文件属性

如果你想在复制文件时保留文件的修改时间、访问时间和权限，可以使用 -p 选项：

$ scp -p example.txt user@remote_host:/home/user/

启用压缩

对于大文件或网络较慢的情况，可以使用 -C 选项启用压缩，以加快传输速度：

$ scp -C large_file.zip user@remote_host:/home/user/

问题

No such file or directory

使用下面的命令传输文件夹时失败

$ scp -r ./dist fofpro:/data/apps/web-modules/copilot/
...
scp: write remote "...": Failure
scp: stat remote: No such file or directory

现象就是，目录下的文件能传输成功，二级目录及下面的文件传输失败，提示如上。

OpenSSH v9.x 起，默认 scp 使用 SFTP 协议

从 OpenSSH 9.0 开始（大概在 2022 年底发布，各大 Linux 发行版陆续采用），scp 的实现已经更改为 默认使用 SFTP 协议，不再使用传统的 rcp 协议。

这带来了两个关键影响：

  1. 目录结构行为变了
  • 以前 scp 使用 rcp 协议，在目标端会自动递归创建嵌套子目录结构。
  • 现在使用 sftp 协议后，如果某一层目标目录不存在，写入就直接失败。
  1. 权限校验更严格

某些文件系统（尤其是远程服务器上挂载了特殊存储设备时），sftp 可能没有写权限或写入失败的兼容性问题，而老的 rcp 协议没那么严格。

查询OpenSSH的版本：

$ ssh -V
OpenSSH_9.8p1, LibreSSL 3.3.6

方法一：强制使用旧版协议（如系统支持）

加上 -O 参数让 scp 使用老协议（rcp）：

$ scp -O -r ./dist fofpro:/data/apps/web-modules/copilot/
  • 选项 -O 意思是 --legacy，让它用回旧的行为。

方法二：改用 rsync（更稳妥）

$ rsync -avz ./dist/ fofpro:/data/apps/web-modules/copilot/dist/

它会自动创建目标路径，且传输断点续传、增量更新都支持，比 scp 更适合大项目部署。

方法三：使用 tar 打包再上传

tar czf dist.tar.gz ./dist
scp dist.tar.gz fofpro:/data/apps/web-modules/copilot/
# 登录远程服务器手动解压或运行远程命令解压

参考

SSH 免密登录

scp 命令

版权归属：唐道勇

本文链接：/linux/ct62svdy.html

许可证：Copyright © 2022-present tangdaoyong