服务器之间搬数据,是运维里最日常也最容易翻车的活:临时传个配置文件,很多人随手就 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 几乎一样,区别只是源或目标里可以带 用户@主机: 前缀,表示那是远端路径。
上传与下载
# 上传单个文件到远端家目录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
# 整个目录递归上传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。
# ssh 是小写 pssh -p 2222 user@192.168.1.20
# scp 是大写 Pscp -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 的交互模式最顺手:
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 会先比较源和目标两边的文件列表,默认用「文件大小 + 修改时间」快速判断哪些文件变了;对内容有变化的文件,它用滚动校验算法把文件切块比对,只把真正不同的数据块发过网络。
这带来两个直接结果:
- 第一次是全量,之后每次只传增量。 一个 50 GB 的站点目录,每天只有几百 MB 变化,第二次同步就只传这几百 MB。
- 中断了可以接着来。 配合
--partial,传了一半的大文件下次从断点继续,而不是从零开始。
rsync 有两种工作模式:
| 模式 | 写法 | 说明 |
|---|---|---|
| 本地模式 | rsync -a SRC DEST | 两边都是本机路径,本质是带增量判断的智能 cp |
| 经 SSH 模式 | rsync -a SRC user@host:DEST | 最常用,复用 SSH 的认证与加密,不用额外部署服务 |
| rsync 守护进程模式 | rsync -a rsync://host/模块 | 需要在服务端单独跑 rsyncd,常用于公共镜像源;自建小规模同步没必要 |
经 SSH 模式下,指定非标准端口用 -e 把 SSH 命令整个传进去:
# 经 SSH 同步,目标机 SSH 端口是 2222rsync -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 选项几百个,日常真正离不开的就十来个。先看最经典的组合:
rsync -avz --progress --partial SRC DEST| 选项 | 全称 | 作用与要点 |
|---|---|---|
-a | archive | 归档模式,一个字母打包了递归、保留符号链接、权限、属主属组、时间戳等一串选项。同步目录默认就带它,几乎是必选项 |
-v | verbose | 显示正在传的文件清单。想安静就去掉,脚本里常配 --info=progress2 看总进度 |
-z | compress | 传输中压缩。只对可压缩内容(代码、文本、日志)有意义;传视频、镜像、压缩包时开启反而白耗 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=秒 | — | 网络无数据超时断开,避免弱网下无限挂起 |
-H | preserve hard links | 保留硬链接关系,备份系统目录时需要,普通同步不用 |
--numeric-ids | — | 不按用户名映射 UID/GID,直接按数字 ID 对齐,跨机器同步时按需使用 |
再强调一下 -z 的适用边界:对已经压缩过的文件(.gz、.zip、.jpg、视频、Docker 镜像层)再开 -z,纯属浪费 CPU,速度只会更慢。判断标准很简单:这批文件用 gzip 还能不能明显变小,能就开,不能就关。
--exclude 的模式匹配有几个细节值得记住:
# 排除所有 .log 文件、缓存目录和 .gitrsync -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 的输出要逐行看完。把这一步做成肌肉记忆,能挡掉绝大多数同步事故。
# 第一步:演练,看清楚会传什么、删什么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 对源路径末尾的斜杠极其敏感,带不带斜杠,语义完全不同:
# 不带斜杠:把 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,要求停机时间尽量短。
第一步:不停机先做全量预同步
业务还在跑,先把大头数据搬过去。这一步慢没关系,不影响线上:
# 在新服务器上执行,从旧服务器拉取(推荐拉模式,方便在目标端控制节奏)rsync -avzP --bwlimit=20000 \ -e "ssh -p 2222" \ root@old.example.com:/var/www/site/ /var/www/site/说明:
- 目标目录末尾的形态要和源保持一致层级,这里源带斜杠、目标也以目录形式承接内容。
-P同时开启断点续传和进度显示,几十 GB 传几个小时,中途断了重跑同一条命令即可,已完成的文件会自动跳过。--bwlimit按实际带宽留有余量,避免预同步把业务带宽吃光。
第二步:停服务,做增量收尾
选业务低峰期,停掉旧服务器上的 Web 服务和写入型任务(保证数据不再变化),再跑一遍同一条命令。这次只有第一步之后变化的增量文件要传,通常几分钟就结束:
# 旧服务器上先停服务(以 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/第三步:校验,别凭感觉宣布迁移完成
同步命令没报错,不等于数据完整。用两种方式交叉验证:
# 方式一:带 --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 断了没得商量,从头再来。
速度莫名其妙地慢
按这个顺序排查:
- 是不是对压缩过的文件开了
-z:镜像、视频、压缩包占大头时关掉-z再试,这是最常见的原因。 - SSH 加密的 CPU 瓶颈:低配机器上加密吞吐可能跑不满带宽,
top看 rsync 和 ssh 进程是不是吃满一个核。 - 小文件太多:几十万个小文件时,瓶颈在文件枚举和逐个建连的开销,不在带宽。可以先打包成 tar 传过去再解包,或者接受这个速度。
- 磁盘本身慢:两端任一端磁盘 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 通不通、磁盘满不满、选项用对没——顺序排下来,大多数故障都能当场定位。