一、基础知识
SSH 免密登录用的是公钥认证。每个用户有一对密钥:私钥留在客户端,公钥放到服务器的 ~/.ssh/authorized_keys 文件里。登录时的流程是:客户端告诉服务器"我有某把公钥",服务器在这份文件里找到它,生成一段随机数发给客户端;客户端用私钥对随机数签名后发回;服务器用公钥验证签名,通过即放行。私钥从不出本机,所以安全。
理解流程后,失败原因就能归类了:
- 公钥没放对位置或内容错了:文件不在目标用户的家目录下,或一行公钥被截断、混入多余字符。
- 权限过松:OpenSSH 出于安全考虑,默认开启"严格模式",如果发现家目录或
.ssh目录能被同组或其他人写入,就拒绝使用这份授权文件。 - 主机密钥变更:服务器重装后身份变了,客户端
known_hosts里记录的旧指纹对不上,会直接拦截连接。 - 服务端配置禁用公钥认证:
sshd_config里相关开关没打开。
其中权限检查是很多人的盲区。OpenSSH 在严格模式下会核对几件事:用户家目录的属主必须是该用户本人,且不能被组或其他用户写入;.ssh 目录权限应为 700;authorized_keys 应为 600 且属主正确。任何一条不满足,服务器都会拒绝使用这把钥匙,哪怕公钥内容完全正确。所以遇到"公钥明明放进去了还是登不上"时,第一反应应该是查权限,而不是反复重新生成密钥——那是白费力气。
把握一个原则:免密失败时,只要密码还能登录,说明网络和账户本身没问题,问题基本集中在上面这几类。
二、实操步骤
下面以文档地址 192.0.2.10、用户 demo 为例,从零配置并验证。
第 1 步:客户端生成密钥对。
ssh-keygen -t ed25519 -C "demo@example.com"
一路回车即可,生成的 ~/.ssh/id_ed25519 是私钥,id_ed25519.pub 是公钥。
第 2 步:把公钥拷到服务器(需要一次密码)。
ssh-copy-id demo@192.0.2.10
第 3 步:在服务器上核对并设置权限。
# 登录服务器后执行
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chmod 755 ~
ls -ld ~ ~/.ssh ~/.ssh/authorized_keys
家目录不能被组或其他用户写,755 是常见的安全取值。
第 4 步:服务端检查关键配置。
sudo grep -E 'PubkeyAuthentication|AuthorizedKeysFile|StrictModes' /etc/ssh/sshd_config
确认 PubkeyAuthentication 为 yes(被注释时多为默认值,以官方文档为准),AuthorizedKeysFile 指向 .ssh/authorized_keys。改动后重载服务:
sudo systemctl reload sshd
第 5 步:客户端验证。
ssh -v demo@192.0.2.10
日志里依次出现 Offering public key、Server accepts key、Authentication succeeded,就说明免密生效了。
三、关键细节
- 失败会回退到密码认证。 所以你看到"还要输密码"不代表公钥没被接受,要用
-v看是否有Server accepts key字样,判断到底走到哪一步。 - 权限过松是头号杀手。
.ssh应为 700、authorized_keys应为 600,且家目录不能被组写。严格模式下任意一项不达标都会静默拒绝。 - 私钥太开放会被客户端拒绝。 若提示
UNPROTECTED PRIVATE KEY FILE,说明私钥权限过松,客户端出于安全直接不使用它。 - known_hosts 冲突是独立问题。 报
REMOTE HOST IDENTIFICATION HAS CHANGED时,是主机身份变化,和你的密钥对无关,不要混为一谈。 - authorized_keys 一行一个公钥。 粘贴时别换行截断,也别带多余说明文字,否则那一行会被当成无效公钥忽略。
- 可用 -i 指定密钥。 当本机有多把钥匙时,客户端可能默认试错了那一把,用
-i明确指定能排除干扰。 - 目标账户要放对。 你想登录哪个账户,公钥就必须放在那个账户的家目录下;放到 root 或其他用户目录里,对该账户自然不生效。
- 日志比猜测可靠。 服务端认证日志会明确写出"公钥认证失败"还是"找不到授权文件",配合客户端的
-vvv看,比凭经验反复试快得多。
四、常见错误
| 现象 | 原因 | 修正 |
|---|---|---|
Permission denied (publickey),但密码能登录 |
authorized_keys 权限、属主错误或内容有误 | 按第 3 步设 700/600,核对公钥内容是否完整一行 |
提示 UNPROTECTED PRIVATE KEY FILE |
本地私钥权限过松 | chmod 600 ~/.ssh/id_ed25519 后重试 |
报 REMOTE HOST IDENTIFICATION HAS CHANGED |
服务器重装导致主机密钥变化 | 先核验服务器身份真实性,再用 ssh-keygen -R 192.0.2.10 清除旧记录后重连 |
| ssh-copy-id 成功但仍要输密码 | 服务端 PubkeyAuthentication 被设为 no |
改为 yes 后 sudo systemctl reload sshd |
| 旧电脑能免密,新电脑不行 | 新电脑私钥没拷过来,或没在 authorized_keys 中 | 把对应公钥追加到服务器 authorized_keys,注意一行一条 |
| 连接直接超时,无认证提示 | 22 端口不通或主机不可达 | nc -vz 192.0.2.10 22 检查连通性与端口 |
五、排查方法
按这个顺序做,快速锁定卡点:
# 1. 客户端详细日志,看卡在握手、认证还是known_hosts
ssh -vvv demo@192.0.2.10
# 2. 检查本地密钥文件是否存在、权限是否正确
ls -l ~/.ssh/
# 3. 明确指定私钥,排除默认密钥干扰
ssh -i ~/.ssh/id_ed25519 demo@192.0.2.10
# 4. 服务端看认证日志(不同发行版路径不同)
sudo tail -f /var/log/auth.log
# RHEL/CentOS 系通常是:sudo tail -f /var/log/secure
# 5. 核对服务端关键配置
sudo grep -E 'PubkeyAuthentication|AuthorizedKeysFile|StrictModes' /etc/ssh/sshd_config
# 6. 主机密钥冲突时清除旧记录(确认身份后执行)
ssh-keygen -R 192.0.2.10
先用 -vvv 定位阶段,再查权限,最后看服务端日志,绝大多数问题在前三步就能水落石出。客户端日志重点看三段:能否连上服务器、提供了哪把公钥、服务器是否接受;服务端日志重点看是否出现 Failed publickey 以及具体原因。两边对照,基本不会误判。
六、注意事项
- 不建议图省事把
StrictModes关掉,那会掩盖真正的问题并降低安全性,优先把权限修正到位。 - 修改 sshd 配置前,务必保留一个已经登录的会话窗口,避免配置出错把自己锁在服务器外面。
- 密钥类型(如 ed25519 与 rsa)的选择涉及兼容性,具体支持情况以所用系统和 OpenSSH 官方文档为准。
- 清除
known_hosts记录前,一定要通过可信渠道确认服务器身份,否则可能掩盖中间人攻击。 - 文中
192.0.2.10与example.com均为文档保留地址,仅用于演示,请勿替换为任意真实第三方站点。
免责声明:本文为个人学习与实操经验总结,仅代表个人观点,不构成任何技术或商业决策建议。不同系统环境与版本可能存在差异,实际操作请以官方文档为准并自行验证。

评论
还没有评论,来说两句吧。