适用范围与准备
适用于 OpenSSH 已启用连接复用,重新运行 ssh 后仍沿用既有认证或会话路径的情况。先确认当前有无长任务、转发和共享会话,保留原连接;本篇不要求中断它们,也不修改远端 SSH 服务。
先区分原因
ControlMaster 允许多个会话共享同一条 SSH 网络连接,ControlPath 指定本机控制套接字,ControlPersist 可让主连接在首个会话退出后继续存在。再次运行客户端并不必然重新握手,所以配置文本变化与新连接实际使用状态应分开检查。
按顺序操作
- 记录 ssh -V、原连接命令和准确 Host 别名。用 ssh -G 查看生效的 controlmaster、controlpath、controlpersist、hostname、user 和 port;已有 Match exec 规则可能执行本地命令,先了解自己的配置来源。
- 使用同一别名运行 ssh -O check SERVER_ALIAS,检查是否存在可响应的主连接。失败只能说明该控制路径未查到可用主连接,不能用来证明服务器宕机;别名或端口改变也可能选到了另一个套接字。
- 在另一个终端用 ssh -S none -v SERVER_ALIAS 做单次新连接对照,保留主机指纹与认证检查。-S none 禁用这次的连接共享,不会关闭原主连接;日志应显示新连接与认证过程,而非只附着已有复用通道。
- 如果新连接正常、复用连接异常,记录差异,再安排维护窗口处理原主连接。不要直接删除套接字文件,也不要在共享任务运行时执行 ssh -O exit;这些操作可能影响其他会话或转发。
- 检查自定义 ControlPath 是否足以区分主机、端口和用户。官方建议包含 %h、%p、%r 或使用 %C,并放在其他用户不可写的目录。改路径前保存原配置,不能把多个目标硬编码成同一个套接字。
ssh -G SERVER_ALIAS
ssh -O check SERVER_ALIAS
ssh -S none -v SERVER_ALIAS怎样确认有效
以日志中的目标、用户、端口和真实业务操作核对新连接。ssh -G 只展示配置求值,-O check 只检查主连接,均不能替代访问远端资源。若只有新连接失败,可能是旧会话掩盖了当前认证或网络故障,需要保留旧会话并查新错误。
无效时恢复与下一步
本次 -S none 是单次参数,无需持久恢复。改过 ControlPath 才恢复备份。结束原主连接前,应确认所有使用它的会话和转发均可中断;未核实依赖时继续保留,不批量杀死 ssh 进程。脱敏后再分享含用户名、主机和本地路径的日志。