必须用ssh-copy-id -p 端口 -i 公钥路径 user@host显式指定非标端口和公钥,否则因连接默认22端口失败而静默创建空authorized_keys;验证需用相同端口ssh -p 端口 user@host测试。

用 ssh-copy-id 初始化免密登录时,若目标服务器改用了非标准 SSH 端口(如 22222、60920),又或本地私钥不在默认路径(比如用了 id_ed25519 或自定义命名),就必须显式指定端口和公钥路径,否则会静默失败——最常见表现是远程 ~/.ssh/authorized_keys 为空,或仍提示输密码。
必须用 -p 指定非标端口
ssh-copy-id 默认只连 22 端口。哪怕远程已配置好 Port 22222 并重启了 sshd,不加 -p 就等于往一个没开的门上敲钥匙。
- 正确写法:
ssh-copy-id -p 22222 -i ~/.ssh/id_ed25519.pub user@192.168.1.100 -
-p必须紧跟在ssh-copy-id后,不能写成--port,也不能放在-i后面 - 验证是否生效:用同样端口测试连接
ssh -p 22222 user@192.168.1.100,首次仍需输一次密码
明确指定公钥路径避免密钥错配
默认情况下 ssh-copy-id 会尝试读 ~/.ssh/id_rsa.pub,但如果你生成的是 ed25519 密钥、或为不同环境准备了多组密钥(如 id_prod.pub / id_dev.pub),不加 -i 就容易发错公钥,导致后续登录失败。
- 始终用绝对路径或补全波浪号:
-i ~/.ssh/id_ed25519.pub,别依赖 shell 展开异常 - 确认公钥文件存在且可读:
ls -l ~/.ssh/id_ed25519.pub - 若私钥有密码,
ssh-copy-id仍能工作;但建议提前用ssh-add ~/.ssh/id_ed25519加载,避免重复输入
绕过脚本部署冲突的关键检查点
自动化脚本批量执行 ssh-copy-id 时,常因权限、路径或服务状态不一致而中断。以下几项必须在运行前确认:
- 远程
/etc/ssh/sshd_config已启用:PubkeyAuthentication yes,且PasswordAuthentication no(可选,但上线后建议关闭密码登录) - 远程端口监听正常:
ss -tlnp | grep :22222或netstat -tuln | grep :22222 - 远程用户家目录归属正确:
chown -R user:user ~user,尤其避免 root 手动操作后遗留权限错乱 - 远程
~/.ssh不是软链接——OpenSSH 明确拒绝符号链接目录
失败时快速定位的方法
不要反复重试。加 -v 参数看实际执行命令,它本质是组合了一条远程 shell 命令:
- 类似:
ssh -p 22222 user@host "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys" - 手动执行该命令片段,可立刻发现是连不上、目录不可写,还是权限被 SELinux/NFS 拦截
- 常见静默失败原因:远程
~/.ssh权限不是 700、authorized_keys不是 600、家目录挂载在 NFS 上且 no_root_squash 未设











