FXXT技术栈标志FXXT技术栈Linux、Docker、Nginx 与后端运维全部 Runbook

RUNBOOK / Git / SSH

SSH handshake timeout：路由、端口与 known_hosts

ssh 或 Git SSH 远端在握手前超时。

主阶段
network
影响程度
高
错误特征
handshake timeout
最后验证
2026-08-10

故障现象与判断依据

最可能原因

握手超时多在 TCP 路径、跳板或端口策略，而不是密钥内容；不要删除 known_hosts 来掩盖问题。

典型输出 · 公开案例或官方资料LOG
fatal: unable to access 'https://example.invalid/repo.git/':
  SSL certificate problem: unable to get local issuer certificate
ssh: connect to host example.invalid port 22: Connection timed out

安全诊断

以下命令用于读取状态、验证解析或复现请求；先确认目标主机、权限与影响范围。命令中的占位符必须替换为当前环境的实际值。

ShellREAD / VERIFY
GIT_CURL_VERBOSE=1 git ls-remote <url>
ssh -vvv -o ConnectTimeout=10 user@host
git config --show-origin --get-regexp 'http.*proxy|http.*ssl'

推荐修复步骤

  1. 1执行 ssh -vvv -o ConnectTimeout=10 user@host 观察停在连接还是认证。
  2. 2使用 nc -vz host 22 验证目标端口，并检查跳板配置。
  3. 3确认主机指纹后再更新 known_hosts，保留严格校验。

验证、限制与回滚

修复后的验证

ssh -o BatchMode=yes 可无交互连接，Git SSH fetch 成功。

风险提示与回滚

不要以关闭证书校验、删除全部缓存、无限重试、关闭防火墙或放宽到 chmod 777 来替代根因定位。任何配置变更前先保留原文件和校验结果；若验证失败，恢复该备份并重新采集日志。

可信来源与适用边界

参考来源ssh(1) - OpenBSD manual pages ↗

verbose SSH connection diagnostics 此页将环境级案例与本 Runbook 的检查步骤分开呈现，不能把示例日志当作当前服务器的真实事件。

网络环境检测

当 DNS、代理链路、海外依赖源或下载超时已通过本页命令确认是网络层问题时，可继续核对独立网络服务；这不替代本地根因修复。

访问边界云官方网站 →具体套餐、价格、可用线路、服务内容及相关规则以官网当前页面为准；不会携带你在工作台输入的命令、日志、Token、IP 或邮箱。