Mac SSH 连接失败怎么排查？先区分这几类错误

连接超时：先查访问路径

核对地址和端口，然后确认是否需要 VPN、私有网络或来源地址白名单。超时本身不能说明是哪台网络设备丢弃了流量，应让管理员检查路由和对应访问规则。

不要通过大范围放开防火墙或把私有 SSH 服务暴露到公网来“解决”问题，应恢复原本设计的访问路径。

连接被拒绝：查端口和服务

连接被拒绝通常表示目标或中间网络设备主动拒绝了请求。检查是否使用正确主机和 SSH 端口，并让管理员确认服务确实在该端口监听。

浏览器能打开同域名的网站，不代表 SSH 端口也开放。网站和 SSH 可以使用不同的访问路径与策略。

Permission denied：查账号与认证

确认远程用户名、密码或密钥认证方式，以及账号是否获准登录。使用密钥时，核对所选私钥是否正确、对应公钥是否已经在服务器获得授权。

不要靠不断尝试密码来排查。账号可能要求先经过堡垒机、附加认证或使用不同登录身份。切勿把私钥和密码发到公开支持讨论中。

主机身份发生变化：先停下来核验

不要关闭主机校验来消除警告。通过可信渠道联系管理员，对比新的主机指纹。服务器重装可能合法地改变密钥，但连接到错误主机或异常访问路径也可能导致不一致。

只有独立确认变更后，才更新对应的信任记录。一次性删除所有已知主机记录会丢失无关主机的信任信息，不适合作为第一步。

用终端做一组受控对照

在终端和图形客户端中使用相同地址、端口和账号。OpenSSH 的 -v 参数可以输出更多连接诊断信息，详见：https://man.openbsd.org/ssh。需要密钥时再补充正确的密钥参数。

ssh -v -p 2222 user@server.example.com

如何理解对照结果？

如果两边以相同方式失败，先排查网络或服务器配置。如果终端成功而 Docklark 失败，检查保存的地址、端口、账号和认证方式；终端也可能使用了其他客户端没有相同采用的配置或认证代理。

反馈 Docklark 问题时，可以提供应用版本、Mac 芯片、macOS 版本、错误类别、直连或 JumpServer 路径，以及最少复现步骤。分享诊断信息前，删除私人域名、IP、用户名、路径和所有凭据。

能进入 Shell，但不能传文件

SFTP 应单独验证。Shell 登录和 SFTP 可用不是同一个问题；能列出目录也不代表有写入权限。请管理员检查 SFTP 策略、路径限制和属主，而不是直接放开所有文件权限。

同时参考 Docklark 功能页的传输验证说明。代码已实现与在自己服务器上通过实际验证，是不同层次的证据。

常见问题