先确定失败发生在哪一层
| 错误示例 | 检查方向 |
|---|---|
| Could not resolve hostname | 主机名及当前解析环境 |
| Connection timed out | 目标地址、端口、访问路径和防火墙 |
| Connection refused | 端口对应服务或主动拒绝策略 |
| Permission denied (publickey) | 用户名、所选密钥和服务器授权 |
| REMOTE HOST IDENTIFICATION HAS CHANGED | 先核实服务器身份及变更原因 |
适用于 macOS、Linux 及已安装 OpenSSH 客户端的 Windows 终端。只测试自己有权访问的服务器。先向管理员确认主机名、实际端口、登录用户名及是否必须经过跳板;不要假定每台主机都允许 root 或密码登录。
打印有效配置,再做一次可解释的连接
下面将 USER、HOST 替换为真实用户名和主机名,2222 替换为管理员确认的端口。无需本机管理员权限。第一条打印客户端有效配置,不建立目标 SSH 登录会话;其中可能含本地路径、跳板信息,分享前脱敏。
ssh -G -p 2222 USER@HOST核对 hostname、user、port、identityfile、proxyjump 等选项。命令行参数、别名和配置文件可能共同影响实际目标;先找出差异,不删除整份配置来试错。
ssh -v -o ConnectTimeout=10 -p 2222 USER@HOST第二条会向目标发起真实连接并可能提示密码或主机指纹。首次连接先通过独立可信渠道核对指纹,再确认;出现身份变化提示时停止。10 秒仅是本次连接超时设置,不是所有网络的推荐固定值。
密钥拒绝时,先核对身份
- 在调试输出中查看实际用户名以及尝试提供哪把公钥。不要将私钥文件内容复制到聊天或日志。
- 管理员确认使用某把密钥时,可在连接命令添加 -i "PATH_TO_PRIVATE_KEY";把占位值换成真实文件路径。若代理加载了很多密钥,可结合 -o IdentitiesOnly=yes 限制为配置指定的身份。
- 仍被拒绝时,请管理员核对目标用户的公钥授权与服务器日志。不要自行放开全部文件权限、启用 root 密码登录或删除服务器上的其他公钥。
指纹变化或需要跳板时
服务器重建、地址复用与异常中间人都可能让已知指纹不匹配。通过云控制台或管理员的可信渠道确认新指纹和变更记录后,再按组织流程更新对应的一条记录。不要使用 StrictHostKeyChecking=no 绕过检查,也不要清空整个 known_hosts。
使用跳板的环境要按原规定访问。OpenSSH 支持 -J,但必须知道真实跳板与目标;直连失败不能证明跳板路径失败,普通 HTTP 代理设置也不能自动证明 SSH 已经过代理。
登录验收与问题交接
- 在原规定路径下重新登录,确认当前用户名和主机身份正确,执行经允许的只读查看后用 exit 正常退出。
- 恢复测试中临时改动的本地配置;如果保留某一修改,记录它对应哪个 Host,避免影响所有连接。
- 仍失败时提供错误阶段、时间、端口及脱敏调试片段。连接建立和身份通过分别报告,不把端口开放等同于登录成功。