5211 字
26 分钟
文件传输与同步:scp 与 rsync
2026-11-15

服务器之间搬数据,是运维里最日常也最容易翻车的活:临时传个配置文件,很多人随手就 scp 了;到了整站迁移、几十 GB 数据跨机房搬运,还用老办法全量硬传,传一半断线只能从头再来;更有人 rsync 命令方向写反,把生产数据覆盖成了空目录。这一篇把三件工具一次讲透:scp 负责简单直传,sftp 负责交互式挑文件,rsync 负责增量同步和大规模迁移。主线是先分清工具定位,再把 scp 的日常用法过一遍,然后重点拆 rsync 的核心概念、关键选项、两个经典大坑,最后用一次完整的整站迁移把所有知识点串起来。

先给一句结论定调:小文件、一次性传输用 scp;需要反复同步、断点续传、大数据量迁移,一律用 rsync。选错工具,轻则浪费时间流量,重则数据出事。

一、工具定位:先分清三件工具各管什么#

scp、sftp、rsync 都走 SSH 通道,加密和认证方式一致,区别在工作模式:

工具工作模式适合场景不适合
scp整文件直传,不比较差异临时传一两个文件、脚本里简单调用大目录、反复同步、断线重传
sftp交互式会话,像 FTP 一样浏览远端目录不确定远端有什么、要挑着传、手动管理远端文件自动化脚本、大批量同步
rsync增量同步,只传有差异的部分目录镜像、定时备份、整站迁移、断点续传只传单个小文件(杀鸡用牛刀,但也没坏处)

补充两点容易混淆的事实:

  • 新版 OpenSSH(9.0 起)的 scp 默认已经改用 SFTP 协议实现,命令用法不变,老脚本不用改;但它依然是「整文件传输」的语义,不会做增量比较。
  • sftp 除了交互模式,也支持 sftp user@host:/path/file /local/dir 这种一把梭的非交互用法,还能用 -b 读批处理文件执行一串命令,适合半自动场景。

还有个常见疑问:为什么不用 FTP 或 HTTP 传?FTP 明文传输、还要额外开服务和端口,在服务器之间搬数据毫无优势;HTTP 适合分发不适合同步。这三件工具都复用现成的 SSH 服务,装好系统就有,不用再多开任何端口。

二、scp 全套:日常直传够用了#

scp 的语法和 cp 几乎一样,区别只是源或目标里可以带 用户@主机: 前缀,表示那是远端路径。

上传与下载#

Terminal window
# 上传单个文件到远端家目录
scp /etc/nginx/nginx.conf root@192.168.1.20:~
# 上传到远端指定目录
scp ./app.tar.gz deploy@192.168.1.20:/opt/packages/
# 从远端下载文件到当前目录
scp root@192.168.1.20:/var/log/app.log ./
# 从远端下载并改名保存
scp root@192.168.1.20:/root/backup.sql ./backup-2026-11-15.sql

传目录:加 -r#

Terminal window
# 整个目录递归上传
scp -r ./dist deploy@192.168.1.20:/var/www/html/
# 整个目录下载回来
scp -r root@192.168.1.20:/etc/nginx ./nginx-backup

指定端口:大写 P,别写错#

这是 scp 最著名的坑:ssh 指定端口用小写 -p,scp 指定端口用大写 -P。

Terminal window
# ssh 是小写 p
ssh -p 2222 user@192.168.1.20
# scp 是大写 P
scp -P 2222 ./file.tar.gz user@192.168.1.20:/tmp/

写错会直接报错或连错端口,排查时先看这里。顺带一提,sftp 指定端口同样用大写 -P,而 ssh 本身的登录、转发全是小写 -p。记住一条就够:scp 和 sftp 的端口参数是大写 -P,只有 ssh 本身是小写 -p。记混了就现场 man scp 确认,别凭记忆硬敲生产命令。

其他常用选项#

选项作用说明
-l 速率限速,单位 Kbit/s-l 8000 约等于 1 MB/s,怕跑满带宽影响业务时用
-C传输时压缩传文本、日志类文件有效;传已压缩文件无意义
-i 密钥文件指定私钥多密钥环境必备
-p保留原文件的修改时间与权限注意这里小写 p 是 preserve,不是端口
-q安静模式,不显示进度脚本里常用
-3两台远端之间互传时经本机中转源和目标都是远端主机时才需要

scp 的进度条会实时显示百分比、速度和预计剩余时间,这点比老版本友好。但要清醒:scp 传到 99% 断线,这个文件就是废的,只能重传。这正是它不适合大文件和弱网络环境的原因。

三、sftp 交互模式:先看看远端有什么#

不知道远端目录结构、只想挑几个文件时,sftp 的交互模式最顺手:

Terminal window
sftp -P 2222 deploy@192.168.1.20

进入后是独立的命令环境,本地和远端各有一套命令(远端命令前不加 l,本地命令加 l 前缀):

sftp> ls /var/log # 看远端目录
sftp> lls # 看本地目录
sftp> cd /var/log # 切换远端目录
sftp> lcd ~/downloads # 切换本地目录
sftp> get app.log # 下载
sftp> get -r logs-2026 # 下载整个目录
sftp> put deploy.sh # 上传
sftp> put -r ./static # 上传整个目录
sftp> exit

日常用得不多,但救急时很好用:比如登不进对方的 Shell(只给了 SFTP 账号),照样能传文件、建目录(mkdir)、删文件(rm)。

四、rsync 核心概念:它凭什么只传差异#

rsync 之所以是同步工具的事实标准,靠的是它的增量传输算法。同步一个目录时,rsync 会先比较源和目标两边的文件列表,默认用「文件大小 + 修改时间」快速判断哪些文件变了;对内容有变化的文件,它用滚动校验算法把文件切块比对,只把真正不同的数据块发过网络。

这带来两个直接结果:

  1. 第一次是全量,之后每次只传增量。 一个 50 GB 的站点目录,每天只有几百 MB 变化,第二次同步就只传这几百 MB。
  2. 中断了可以接着来。 配合 --partial,传了一半的大文件下次从断点继续,而不是从零开始。

rsync 有两种工作模式:

模式写法说明
本地模式rsync -a SRC DEST两边都是本机路径,本质是带增量判断的智能 cp
经 SSH 模式rsync -a SRC user@host:DEST最常用,复用 SSH 的认证与加密,不用额外部署服务
rsync 守护进程模式rsync -a rsync://host/模块需要在服务端单独跑 rsyncd,常用于公共镜像源;自建小规模同步没必要

经 SSH 模式下,指定非标准端口用 -e 把 SSH 命令整个传进去:

Terminal window
# 经 SSH 同步,目标机 SSH 端口是 2222
rsync -av -e "ssh -p 2222" ./data/ deploy@192.168.1.20:/srv/data/
# 用指定密钥
rsync -av -e "ssh -i ~/.ssh/id_ed25519 -p 2222" ./data/ deploy@192.168.1.20:/srv/data/

注意路径里只要出现 主机:,rsync 就知道走远端;本地路径写错成带冒号的样子会被误判,路径里有冒号时要用 ./ 前缀或绝对路径避开。

五、关键选项逐个讲#

rsync 选项几百个,日常真正离不开的就十来个。先看最经典的组合:

Terminal window
rsync -avz --progress --partial SRC DEST
选项全称作用与要点
-aarchive归档模式,一个字母打包了递归、保留符号链接、权限、属主属组、时间戳等一串选项。同步目录默认就带它,几乎是必选项
-vverbose显示正在传的文件清单。想安静就去掉,脚本里常配 --info=progress2 看总进度
-zcompress传输中压缩。只对可压缩内容(代码、文本、日志)有意义;传视频、镜像、压缩包时开启反而白耗 CPU 拖慢速度
--progress—显示每个文件的传输进度
--partial—保留未传完的文件,下次续传。大文件、跨公网同步必备;也可用组合写法 -P,它等于 --partial --progress
--bwlimit=速率—限速,单位 KB/s。--bwlimit=5000 约 5 MB/s,业务时段同步大目录时防止打满带宽
--exclude—排除文件或目录,可多次使用,如 --exclude='*.log' --exclude='.git/'
--dry-run—空跑演练,只打印会做什么,不实际改动任何文件。危险操作前的标准动作,也常写作 -n
--checksum—用文件内容校验和判断差异,而不是大小+时间。更可靠但更慢,迁移收尾校验时用
--delete—删除目标端多出来的文件,让目标成为源的镜像。危险,专节讲
--timeout=秒—网络无数据超时断开,避免弱网下无限挂起
-Hpreserve hard links保留硬链接关系,备份系统目录时需要,普通同步不用
--numeric-ids—不按用户名映射 UID/GID,直接按数字 ID 对齐,跨机器同步时按需使用

再强调一下 -z 的适用边界:对已经压缩过的文件(.gz、.zip、.jpg、视频、Docker 镜像层)再开 -z,纯属浪费 CPU,速度只会更慢。判断标准很简单:这批文件用 gzip 还能不能明显变小,能就开,不能就关。

--exclude 的模式匹配有几个细节值得记住:

Terminal window
# 排除所有 .log 文件、缓存目录和 .git
rsync -av \
--exclude='*.log' \
--exclude='cache/' \
--exclude='.git/' \
./app/ deploy@192.168.1.20:/srv/app/
  • 模式以 / 开头表示从源根目录锚定匹配,如 --exclude='/tmp' 只排除源根下的 tmp,不排除子目录里的 tmp。
  • 模式以 / 结尾表示只匹配目录。
  • 排除规则多了可以写进文件,用 --exclude-from='exclude.txt' 引入,一行一条,迁移和备份脚本里更易维护。

六、—delete 红线专节:方向写反就是事故#

--delete 的语义是:让目标端和源端一模一样,源端没有的文件,目标端也删掉。它是做镜像备份的核心选项,也是 rsync 全部选项里最危险的一个。

危险不在选项本身,而在方向。rsync 命令的顺序是「源在前、目标在后」,手一抖写反,配合 --delete,就等于拿空目录去「同步」有数据的那一端:

WARNING

带 —delete 的命令,执行前必须先加 —dry-run 演练一遍,确认输出里要删除的文件全是预期之内的,再去掉 —dry-run 正式跑。尤其是第一次对一对目录使用 —delete 时,dry-run 的输出要逐行看完。把这一步做成肌肉记忆,能挡掉绝大多数同步事故。

Terminal window
# 第一步:演练,看清楚会传什么、删什么
rsync -av --delete --dry-run ./site/ deploy@192.168.1.20:/srv/site/
# 第二步:确认无误后去掉 --dry-run 正式执行
rsync -av --delete ./site/ deploy@192.168.1.20:/srv/site/

另外两个和 --delete 相关的保护措施,知道即可:

  • --max-delete=N:单次最多删 N 个文件,超过就中止。给定时同步任务加上,能在源端异常(比如挂载没跟上、源目录变空)时兜底。
  • --delete 的位置也有讲究:默认删除发生在传输过程中,还有 --delete-before(先删后传)和 --delete-after(先传后删)。磁盘空间紧张时用 before,一般场景默认即可,不必纠结。

还有一个真实场景要提醒:如果源目录是挂载点,挂载失败时源目录看起来是个空目录,此时带 --delete 的定时任务跑起来,会把备份端清空。防御办法除了 --max-delete,还可以在脚本里先检查源目录的标志文件存在再执行同步。这类防御在备份篇里也有呼应:本站的《Linux 备份策略》专门讲了备份任务的安全设计,建议对照着看。

七、路径末尾斜杠:rsync 最经典的坑#

rsync 对源路径末尾的斜杠极其敏感,带不带斜杠,语义完全不同:

/backup/data/...
# 不带斜杠:把 data 这个目录本身传过去
rsync -av /srv/data /backup/
# 带斜杠:把 data 目录里面的内容传过去
rsync -av /srv/data/ /backup/
# 结果:/backup/...(文件直接铺在 backup 下)

对照表看得更清楚:

写法同步对象目标结果
rsync -av /srv/data /backup/data 目录本身/backup/data/文件…
rsync -av /srv/data/ /backup/data 目录的内容/backup/文件…

注意:这个区别只作用于源路径,目标路径末尾的斜杠带不带都一样。另外 scp 没有这个讲究,scp 的 -r 永远是把目录本身拷过去。很多人就是从 scp 的习惯平移过来,在 rsync 上栽了跟头:同步完发现目标端多套了一层目录,或者反过来,文件铺错了层级。

怎么记?带斜杠=倒出目录里的东西,不带斜杠=连盒子一起搬。迁移和镜像场景里,绝大多数时候你想要的是「内容对内容」,也就是源路径带斜杠。敲命令前停一秒,确认这一对路径的层级关系,能省掉大量返工。

八、整站迁移实战:两步走完一次跨机房搬家#

把前面的知识点组装起来,完成一次真实的整站迁移。场景:把旧服务器上的网站目录 /var/www/site(含上传文件、静态资源)和一份数据库导出文件,迁移到新服务器,SSH 端口 2222,要求停机时间尽量短。

第一步:不停机先做全量预同步#

业务还在跑,先把大头数据搬过去。这一步慢没关系,不影响线上:

Terminal window
# 在新服务器上执行,从旧服务器拉取(推荐拉模式,方便在目标端控制节奏)
rsync -avzP --bwlimit=20000 \
-e "ssh -p 2222" \
root@old.example.com:/var/www/site/ /var/www/site/

说明:

  • 目标目录末尾的形态要和源保持一致层级,这里源带斜杠、目标也以目录形式承接内容。
  • -P 同时开启断点续传和进度显示,几十 GB 传几个小时,中途断了重跑同一条命令即可,已完成的文件会自动跳过。
  • --bwlimit 按实际带宽留有余量,避免预同步把业务带宽吃光。

第二步:停服务,做增量收尾#

选业务低峰期,停掉旧服务器上的 Web 服务和写入型任务(保证数据不再变化),再跑一遍同一条命令。这次只有第一步之后变化的增量文件要传,通常几分钟就结束:

Terminal window
# 旧服务器上先停服务(以 Nginx + PHP-FPM 为例)
systemctl stop nginx php8.2-fpm
# 新服务器上再跑一遍增量同步
rsync -avzP \
-e "ssh -p 2222" \
root@old.example.com:/var/www/site/ /var/www/site/

第三步:校验,别凭感觉宣布迁移完成#

同步命令没报错,不等于数据完整。用两种方式交叉验证:

Terminal window
# 方式一:带 --checksum 做一次校验型 dry-run
# 输出为空(没有待传文件)说明两边内容一致
rsync -avc --dry-run \
-e "ssh -p 2222" \
root@old.example.com:/var/www/site/ /var/www/site/
# 方式二:对比两边文件总数和总大小
find /var/www/site -type f | wc -l # 新机执行
ssh -p 2222 root@old.example.com "find /var/www/site -type f | wc -l"
du -sh /var/www/site # 两边各执行一次对比

--checksum 会逐个文件算校验和,慢,但这是收尾校验该有的严谨;日常增量同步靠大小+时间判断就够了,不要每次都开。两边文件数、总大小、校验 dry-run 三项都对得上,再启动新服务器的服务、切 DNS,这次迁移才算落地。切换后旧服务器先别急着下线,保留几天做回滚兜底,这是迁移的基本纪律。更完整的异地备份与保留策略,可以看《Linux 备份策略》那篇。

数据库文件不在 rsync 的职责内:用数据库自己的导出导入或主从复制迁移,rsync 只负责搬导出的文件本身,千万不要在数据库运行中直接 rsync 它的原始数据目录,拷出来的文件大概率是不一致的损坏状态。

九、权限与属主:-a 保留了什么,又保留不了什么#

-a 会保留权限位、时间戳、符号链接,以及——在以 root 身份运行时——文件属主和属组。这里有个跨机器的固有问题:rsync 默认按用户名映射属主,两台机器上同名用户的 UID 可能不一样;没有同名用户时,属主就会落到某个数字 UID 上,看起来「乱了」。

场景表现处理
两边都用 root 同步,用户体系一致属主属组原样保留无需处理
两边同名用户 UID 不同文件属主按名字对齐,UID 随目标机一般可接受;介意就加 --numeric-ids 按数字对齐
用普通用户同步无法 chown 到别人,属主变成该普通用户自己属主敏感的数据(网站文件、服务数据)用 root 同步
同步到 Windows/NTFS 或 FAT 文件系统权限位、属主无处安放,会告警或丢失这类目标只适合存压缩包,不适合直接同步目录树

一条经验:凡是服务要按特定属主运行的数据(比如 Web 目录属于 www-data、数据库目录属于 mysql),迁移后启动服务前,先在新机上核对一遍属主和权限,ls -ln 看数字 ID 最直观。属主不对,服务轻则报错重则起不来,这是迁移后第一类要排查的问题。

十、排障小节#

传一半断了#

先看是不是网络抖动或目标磁盘满(df -h 先查)。重新执行同一条 rsync 命令即可:已传完的文件靠大小+时间判断自动跳过,传了一半的大文件有 --partial 保留的残件会接着传。如果当时没加 --partial,那个大文件只能重传——所以跨公网、大文件场景,-P 应该成为默认写法。scp 断了没得商量,从头再来。

速度莫名其妙地慢#

按这个顺序排查:

  1. 是不是对压缩过的文件开了 -z:镜像、视频、压缩包占大头时关掉 -z 再试,这是最常见的原因。
  2. SSH 加密的 CPU 瓶颈:低配机器上加密吞吐可能跑不满带宽,top 看 rsync 和 ssh 进程是不是吃满一个核。
  3. 小文件太多:几十万个小文件时,瓶颈在文件枚举和逐个建连的开销,不在带宽。可以先打包成 tar 传过去再解包,或者接受这个速度。
  4. 磁盘本身慢:两端任一端磁盘 IO 不行都会拖住全局,用 iostat -x 1(sysstat 包)看利用率。

权限拒绝(Permission denied)#

分两类看:

  • SSH 层面的拒绝:密钥不对、端口写错(回看第二节大写 P 的坑)、目标机 sshd 配置限制。先单独 ssh 登录验证通了,再跑 rsync。
  • 文件层面的拒绝:目标目录属主不对,同步账号没写权限;或者源端有些文件普通用户读不了。用 root 同步能绕开大部分,但要想清楚这批数据到底该归谁,别图省事把权限体系搞乱。

同步完发现多了一层目录或文件铺错层#

不用问,第七节的斜杠坑。删掉错误层级(删之前先确认哪份是对的),修正命令重跑。这也是为什么正式同步前先 --dry-run 看一眼文件路径列表——路径层级对不对,dry-run 输出里一目了然。

两边明明一样,每次却全量重传#

多半是时间戳对不齐:源端文件时间比目标端新(比如源端刚被 touch 过),或者两边时钟差太多,导致快速判断总认为文件变了。加 --checksum 跑一次校验确认内容确实一致,之后检查两台机器的时间同步状态(NTP 是否正常),并确认用了 -a 保留时间戳。

小结#

  • 选工具先看场景:scp 管一次性直传,sftp 管交互挑选,rsync 管一切增量同步与迁移。
  • scp 的端口是大写 -P,和 ssh 的小写 -p 不是一回事,写错先查这里。
  • rsync 的日常组合是 -av 打底,大文件跨公网加 -P 断点续传,可压缩内容才开 -z。
  • --delete 是镜像同步的灵魂,也是事故之源:执行前必须先 --dry-run,并确认源、目标方向没写反。
  • 源路径末尾的斜杠决定传「目录本身」还是「目录内容」,敲命令前停一秒确认层级。
  • 整站迁移的标准姿势是两步走:不停机全量预同步,停服务后增量收尾,最后用 --checksum 的 dry-run 加文件数对比做校验。
  • 跨机器同步注意属主映射:同名用户 UID 不一致时按名字对齐,属主敏感的数据用 root 同步并在事后核对。
  • 出了问题先分层:SSH 通不通、磁盘满不满、选项用对没——顺序排下来,大多数故障都能当场定位。
文件传输与同步:scp 与 rsync
https://www.anexns.cloudns.org/posts/linux-file-transfer-rsync/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0