Linux scp 命令:通过 SSH 上传、下载和复制目录

scp 用于在本地与远程系统之间复制文件,通常用 user@host:path 表示远程位置。命令中源在前、目标在后;执行前必须确认账号、路径和覆盖风险,并像 SSH 登录一样核对服务器主机指纹。

OpenSSH 从 9.0 起默认用 SFTP(SSH 文件传输协议)传送文件,底层仍通过 SSH 加密连接认证。旧版客户端或显式 -O 可使用旧 SCP 协议;两种模式的远程路径、通配符与引号处理存在差别,不能把旧教程的写法全部照搬。

基本语法与准备条件

scp [options] source target

source 是源,target 是目的地,options 表示可选参数。先用 ssh -V 核对配套 OpenSSH 版本,并阅读本机 man scp;不要把 ssh 的所有选项直接当成 scp 的同名选项。

开始前确认源可读、目标可写、空间充足,以及服务器支持所需传输协议。获准登录不保证目标目录可写;被限制为 SFTP 的账号也不一定能执行远程 shell 命令。示例账号 alice、user 和 server.example.com、server.example.test 都要换成真实获准值。

远程的冒号将主机与路径分开,本地文件名若含冒号,可用明确的相对路径如 ./report:2026.txt 避免被当成主机位置。路径有空格时需防止本地 shell 拆词;若选择旧 SCP 协议,还要考虑远程 shell 的再次解释,优先使用简单、明确的路径。

上传、下载与目录复制

把本地文件复制到服务器。

scp report.txt alice@server.example.com:/home/alice/

report.txt 从当前本地目录读取,目的地是远程已存在的 /home/alice/ 目录,预期得到 /home/alice/report.txt。先检查同名文件;scp 可能直接覆盖它,没有通用的自动备份或默认覆盖确认流程。

把远程文件取回本地。

scp alice@server.example.com:/home/alice/report.txt .

点号表示当前本地目录,预期生成本地 report.txt,已有同名文件也可能被覆盖。先确认本地所在目录,不要将“当前目录”误认为远程家目录。需要保留旧版文件时,先备份或指定新的目标文件名。

递归复制目录。

scp -r project/ alice@server.example.com:/home/alice/

-r 包含子目录和文件。对于这里预先存在的目标目录,通常得到 /home/alice/project/;若目标本身不存在或已有不同布局,结果应另行核对。不要套用其他工具“尾斜杠一定只复制内容”的规则。

scp 递归遍历时会跟随遇到的符号链接,因此实际复制范围与大小可能超出表面目录内容。上传前检查链接和敏感文件;它不是保持符号链接、所有权、扩展属性及全部元数据的完整备份方案,也不会自动删除目的地多余文件来保持镜像。

怎样确认方向、完成与内容

下面源仍是本地文件,远程冒号后的路径则明确指定目标文件名:

scp report.txt user@server.example.test:/tmp/report.txt

/tmp/report.txt 是说明性目标,不是建议在共用临时目录长期保存敏感资料。应改用合适的受控目录,核对目标是否已存在及其权限;不要让示例覆盖生产文件。

命令可能显示进度,也可能安静结束。成功退出状态是 0,出错时大于 0;在 shell 中用 echo $? 应紧接 scp 执行,否则读到的是后一个命令的状态。进度达到 100% 或目录里出现文件,都不能单独证明全部操作成功。

有远程命令权限时,可用 ssh user@server.example.test 'ls -lh /tmp/report.txt' 核对名称和大小;连接与指纹确认见 SSH 登录及主机身份检查。若使用了非默认端口,远程检查也要使用对应的 ssh -p。仅支持 SFTP 的账号可改用 SFTP 的列表操作检查。

名称和大小相同仍不代表内容相同。重要传输可在两端按相同算法计算摘要并比较完整值;还应确认使用方能正确打开文件。中断后可能留下部分目标,重新执行前先保护已有内容;scp 没有通用的断点续传开关,不应把部分文件当成已完成版本。

本地行为检查:2026-11-05 在 Windows Git 配套 OpenSSH 10.3p1 中,使用专用目录的自建文件,确认本地复制、同名覆盖及 -r 子目录复制的字节内容。该本地路径由 Git 的 cp 执行,不经过 SSH 或 SFTP;它没有验证 Linux 远程认证、传输中断、符号链接或远端元数据行为。

常用选项与协议差异

选项 作用与条件
-r 递归复制目录,遍历中会跟随符号链接。
-P port 指定 SSH 服务器端口;这里是大写 P。
-i keyfile 选择认证身份文件,仍受 SSH 身份配置与服务器策略影响。
-p 保留源修改时间、访问时间和文件模式位,受系统支持与权限限制。
-O 显式选用旧 SCP 协议,须核对兼容性和远程 shell 解释。

例如非默认端口应在命令中加 -P 2222,不能用 -p 2222 代替。-p 也不是保留一切属性:所有权、ACL、扩展属性等不能由这一选项概括,跨平台复制尤其要检查结果。

SFTP 默认模式解决了旧协议对远程 shell 展开的一些依赖;旧服务器不支持 SFTP、某些通配符或 ~user 路径不兼容时,应先明确原因。-O 是兼容选择,不是一般故障的自动修复;切换后必须重新审视引号与路径。不要关闭主机密钥校验来解决文件权限或协议问题。

传输前后检查顺序

  1. 确认源与目的地、账号、端口、协议和主机指纹,预先检查读写权限、目录布局、容量与已有同名文件。使用不同测试文件名先验证方向。
  2. 只选择必要文件或目录;递归前检查符号链接和敏感内容。需要频繁同步或续传时,另行选择支持相应机制的工具,并阅读其覆盖与一致性条件。
  3. 传输后立即记录退出状态,再核对路径、大小、必要摘要与应用读取结果。多个文件中途失败时,不把前几个成功文件当成整项完成。
  4. 保留需要的备份与诊断,仅清理自己创建的测试或部分文件。失败重试前重新检查目标,避免把后来更新的文件再覆盖。

若采用 SFTP 的续传功能,也必须确认已有部分内容与源一致;直接继续一个内容不同的文件可能产生损坏。续传、差异同步和备份是不同需求,不能只因都能传文件就互相等同。

常见问题

scp 的端口参数是 -p 吗?

不是。scp 用大写 -P 选择端口,小写 -p 用于保留时间和模式位。ssh 的端口参数才是小写 -p,复制和后续 SSH 检查时应分别确认。

官方文档

路径、递归与退出状态见 OpenSSH scp 手册,默认协议的版本变化见 OpenSSH 9.0 发布说明。身份与配置参见 ssh_config,续传条件见 SFTP 官方手册。