ControlMaster通过复用单次SSH握手实现秒级连接加速，核心配置为三行：ControlMaster auto、ControlPath ~/.ssh/sockets/%r@%h:%p、ControlPersist 600，需配合目录创建与套接字验证确保生效。
SSH连接多路复用能显著减少重复建连开销，尤其在频繁执行ssh、scp、rsync等操作时效果明显——它不是“可选优化”，而是批量脚本和CI/CD中值得默认启用的配置。
怎么在~/.ssh/config里启用ControlMaster
核心是三行配置，必须放在对应Host段内（或Host *全局生效）：
-
ControlMaster auto：首次连接时自动创建主通道，后续同目标连接复用它 -
ControlPath ~/.ssh/sockets/%r@%h:%p：指定套接字路径，%r是远程用户名，%h是主机名，%p是端口——避免不同端口或用户冲突 -
ControlPersist 600：主连接断开后，后台保持套接字10分钟（单位秒），方便短时间内的新连接快速复用
注意：ControlPath路径中的目录（如~/.ssh/sockets）需提前创建并确保可写：mkdir -p ~/.ssh/sockets；权限不严会导致复用失败，但无需chmod 600（套接字文件本身由OpenSSH自动设权）。
为什么ControlPersist设成yes会出问题
ControlPersist yes看似简单，但实际会让主进程无限期驻留，即使终端关闭、shell退出也不释放资源，容易积累僵尸套接字，最终导致ssh: connect to host xxx port 22: Connection refused（套接字路径被占或权限错）。
更稳妥的做法是：
- 用具体秒数（如
600）或带单位的值（如10m），明确超时边界 - 避免在
Host *段滥用ControlPersist，尤其是连接跳板机或临时测试机时，长期驻留可能干扰网络调试 - 若需彻底关闭后台驻留，直接删掉
ControlPersist行，仅保留ControlMaster auto和ControlPath——此时主连接随最后一个客户端退出而关闭
如何验证复用是否生效
不要只看命令是否成功，要看底层连接行为：
- 首次连接后，检查套接字是否存在：
ls -l ~/.ssh/sockets/，应看到类似user@host:22的文件 - 第二次
ssh user@host时，用ps aux | grep ssh观察：只新增一个客户端进程，不会有新的ssh: master进程 - 手动触发检查：
ssh -O check user@host，返回Master running (pid=XXXX)即表示复用正常 - 如果报错
Control socket connect timeout，大概率是ControlPath路径错误、目录不存在，或上一次连接异常中断未清理套接字
哪些场景下要禁用或多路复用失效
多路复用不是万能的，遇到以下情况应主动关闭或隔离配置：
- 使用
-o StrictHostKeyChecking=no等绕过校验的临时连接——复用通道会继承首次连接的主机密钥策略，后续连接可能因密钥变更被拒绝 - 通过跳转主机（
ProxyJump或ProxyCommand）时，ControlMaster需单独为跳转机和目标机分别配置，混用会导致套接字路径冲突或认证失败 - 连接同一台主机但用不同用户（如
user1@host和user2@host），必须确保ControlPath含%r，否则复用会因权限错失败 - 某些老旧OpenSSH版本（ControlPersist，升级客户端可解决
最易被忽略的是ControlPath模板里的变量拼写——比如误写成%R（大写）或%H，会导致路径生成错误却无明确报错，只能靠ls排查。复用逻辑本身很稳定，问题几乎全出在路径和权限上。
