科技 · 实用指南
OpenSSH ControlMaster 卡住？删除套接字前先证明它已失效
解析实际 ControlPath，询问主连接是否存活，区分陈旧路径、远端传输卡死与路径故障，只修复已证实的边界。
ControlMaster 故障并不是单一问题：路径可能解析到意外位置、超过 Unix 域套接字限制、位于无法正确承载套接字的文件系统、指向已退出的主进程，或仍连接着本地主进程但远端传输已经卡死。先删路径会破坏证据，还可能与存活进程竞争。
应按证据顺序处理：用 ssh -G 固定有效配置，验证私有 ControlPath 及长度，用 ssh -O check 询问该精确套接字，再根据观测结果选择 exit、unlink、迁移路径或保活修复；最后证明第二个客户端确实复用了新主连接。
1. 固定别名与有效配置
使用发生故障时相同的别名和命令环境。运行 ssh -G alias，记录 hostname、user、port、proxyjump、controlmaster、controlpath 和 controlpersist。OpenSSH 通常按命令行、用户配置、系统配置的顺序取首个值，只看最后一个匹配段可能会找错套接字。
不要手工展开另一个别名。%h、%p、%r、%C 等令牌来自有效连接；看似等价的名称仍可能映射到不同主连接。保存完整输出作为事故证据。
2. 在存活检查前验证路径
确认解析后的 ControlPath 位于 SSH 用户所有且他人不可写的目录。用 %h-%p-%r 保持唯一，长度紧张时使用 %C。检查父目录可搜索权限和最终目录写权限；缺失或不可写父目录属于路径故障，不是陈旧套接字。
测量编码后的路径名。Linux 的路径套接字 sun_path 为 108 字节，其他实现可能更短，因此必须留余量。短的私有运行时目录可以避开过深的主目录、容器或 CI 工作区，而不削弱所有权。
3. 询问精确主连接
使用已固定配置运行 ssh -O check alias。若必须直接检查捕获的路径，使用 ssh -S "$socket" -O check host，并保持相同的有效主机、用户和端口。成功响应会识别正在运行的主连接，通常给出 PID；更改前先保存输出。
不要依赖所有 OpenSSH 版本都相同的一条错误文本。没有路径时回查展开或创建过程；拒绝连接只是陈旧候选，还需核对所有者、文件类型、别名及仍打开套接字的进程。检查成功则转查传输健康，而不是删除。
4. 区分陈旧路径与传输卡死
若主连接响应且计划停止它，执行 ssh -O exit alias，并确认进程和路径消失。不要删除响应中的主连接路径，否则旧客户端可能继续运行而新客户端又创建竞争主连接。只有无人响应、路径属于预期用户且没有匹配进程或开放套接字时，才保存证据并只移除该已证实的陈旧路径。
控制套接字响应只证明本地控制通道，不证明主连接仍能与服务器交换数据。需要限定断线时间时同时设置 ServerAliveInterval 与 ServerAliveCountMax；它们通过加密协议消息检测远端停止响应，含义不同于 TCPKeepAlive。
5. 修复路径与文件系统位置
若套接字在 overlay 或容器工作区创建失败，在本地文件系统的短私有运行时目录复现一次。有 CI 案例在将 ControlPath 移出 overlayfs 后恢复，但这只证明该位置边界，不能推广到所有 overlay。继续保留 %C 或其他按目标唯一的令牌。
优先使用用户所有的 0700 目录，例如合适的 $XDG_RUNTIME_DIR 子目录。若仅为受控测试使用 /dev/shm，必须创建私有子目录并核实所有权和权限；绝不能在共享可写目录直接放可预测套接字。记录 ControlPersist 和作业异常退出后的清理行为。
6. 证明修复并声明边界
启动一条详细日志连接，保存复用初始化行；再由第二个进程通过相同别名连接并确认复用，然后再次运行 ssh -O check。比较修复前后的 ssh -G，确保通过的是预期路径和连接元组，而非退回普通非复用连接。
只有私有路径可创建、精确主连接响应、第二客户端复用、退出或持久化符合设计且远端命令成功时才验收。本流程覆盖基于路径的 ControlMaster 套接字和抽样客户端；抽象套接字、平台启动器、安全模块、代理和供应商补丁需要额外证据。
