连接失败
SSH 连接失败的排查指南。
排查步骤
步骤 1:检查基本信息
确认以下信息正确:
- 服务器地址(IP 或域名)
- SSH 端口(默认 22)
- 用户名
- 认证方式
步骤 2:检查网络连通性
使用 ping 或 telnet 测试:
bash
# 测试网络连通
ping server.example.com
# 测试端口连通
telnet server.example.com 22如果 ping/telnet 失败:
- 网络不通
- 服务器防火墙限制
- SSH 服务未运行
步骤 3:检查认证信息
密码认证:
- 确认密码正确
- 确认用户存在
- 确认账户未锁定
密钥认证:
- 确认密钥文件路径正确
- 确认密钥格式正确
- 确认公钥已添加到服务器 authorized_keys
- 确认密钥文件权限(600)
步骤 4:检查服务器端
在服务器上检查:
bash
# 检查 SSH 服务状态
systemctl status sshd
# 查看 SSH 日志
tail -f /var/log/auth.log常见错误
Connection timed out
原因:网络不通或端口错误
解决:
- 确认网络可达
- 确认端口正确
- 检查防火墙规则
Connection refused
原因:SSH 服务未运行或端口错误
解决:
- 启动 SSH 服务
- 确认端口配置
Host key verification failed
原因:服务器指纹变更
解决:
- 确认服务器变更是否正常
- 删除本地旧指纹记录
- 重新接受指纹
Permission denied
原因:认证失败
解决:
- 确认用户名密码
- 确认密钥配置
- 查看服务器日志
Too many authentication failures
原因:尝试次数过多
解决:
- 等待一段时间
- 确认认证信息正确
- 检查服务器 MaxAuthTries 配置
获取帮助
如问题仍未解决:
- 查看 日志调试
- 提交 GitHub Issue
- 联系客服支持