SSH 与 rsync 文件传输 - 码剑客

SSH 密钥登录、ssh config 主机别名、本地与远程端口转发,以及 scp、rsync 增量同步与断点续传的常用写法,附带传输前的预演与权限修复方法。

OpenSSH 8.x+ / rsync 3.2+更新于 2026-10-30共 19 条

密钥与免密登录

生成 ed25519 密钥对,比 RSA 更短更快,默认写入 ~/.ssh

ssh-keygen -t ed25519 -C "you@example.com"

把公钥追加到远端 authorized_keys,完成免密登录

ssh-copy-id -i ~/.ssh/id_ed25519.pub deploy@10.0.0.12

启动代理并加载私钥,避免每次输入口令;-l 查看已加载的密钥

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
ssh-add -l

写入 ~/.ssh/config 后可直接 ssh prod;心跳参数可减少长时间空闲断连

Host prod
  HostName 10.0.0.12
  User deploy
  Port 2222
  IdentityFile ~/.ssh/id_ed25519
  ServerAliveInterval 30

配置文件权限需为 600,否则新版本 OpenSSH 会忽略私钥

连接与端口转发

指定非默认端口登录;scp 对应的参数是大写 -P

ssh -p 2222 deploy@10.0.0.12

经跳板机连接内网主机,无需在跳板机上单独登录

ssh -J jump@bastion.example.com deploy@10.0.0.12

本地转发:把本机 3307 映射到远端 MySQL,-N 不执行命令、-f 后台运行

ssh -N -f -L 3307:127.0.0.1:3306 deploy@10.0.0.12

远程转发:让远端 9000 端口访问本机 3000 服务,适合临时演示回调

ssh -N -R 9000:127.0.0.1:3000 deploy@10.0.0.12

动态转发建立 SOCKS5 代理,浏览器可指向 127.0.0.1:1080

ssh -N -D 1080 deploy@10.0.0.12

scp 与 rsync 传输

通过 SSH 递归复制目录;每次全量传输,适合小体积产物

scp -P 2222 -r ./dist deploy@10.0.0.12:/opt/app

增量同步目录,只传差异部分;路径末尾的斜杠表示同步目录内容

rsync -avz --progress ./dist/ deploy@10.0.0.12:/opt/app/

先预演,确认将删除哪些远端多余文件再正式执行

rsync -avz --dry-run --delete ./dist/ deploy@10.0.0.12:/opt/app/
高危

同步并删除远端多余文件,使两端完全一致;路径写错会删掉目标目录内容

rsync -avz --delete ./dist/ deploy@10.0.0.12:/opt/app/

排除依赖目录与日志,减少传输体积

rsync -avz --exclude "node_modules" --exclude "*.log" ./app/ deploy@10.0.0.12:/opt/app/

非默认 SSH 端口时通过 -e 指定远程 shell 参数

rsync -avz -e "ssh -p 2222" ./dist/ deploy@10.0.0.12:/opt/app/

权限与排查

输出握手细节,定位密钥未加载、算法协商失败等问题

ssh -v deploy@10.0.0.12

只做认证不分配终端,用于验证部署公钥是否生效

ssh -T git@github.com

修改 sshd_config 后先校验语法,再重启服务避免锁死登录

sudo sshd -t

修复权限过宽导致的免密失效,这是 Permission denied 最常见原因

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys ~/.ssh/config
chmod 644 ~/.ssh/*.pub

本网站使用 Cookie 以确保您在我们的网站上获得最佳体验。 隐私政策.