Paramiko能否复用已存在的SSH会话避免创建新连接

结论 #

分两种场景判断是否可直接复用：

• 现有SSH连接由Paramiko本身创建：完全可以直接复用，无需新建连接
• 现有SSH连接由其他SSH客户端（如系统自带的OpenSSH命令行工具）创建：无法直接复用，但可通过共享套接字的方式实现等价的多操作单连接效果

场景1：复用Paramiko自建的SSH连接 #

Paramiko的SSHClient实例建立连接后，会维持一个底层的TCP加密会话，你可以在同一个会话上开启多个独立的SSH通道实现不同操作，所有操作都不会触发新的连接建立和身份验证流程，完全符合避免多连接的需求。
常见复用场景示例代码：

import paramiko

# 仅首次需要执行连接逻辑，全程只建立1次SSH连接
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
ssh.connect(
    hostname="服务器地址",
    username="登录用户名",
    password="登录密码" # 也可替换为密钥验证参数
)

# 复用连接执行服务端脚本
_, stdout, stderr = ssh.exec_command("python3 /data/run_script.py")
print("脚本执行输出：", stdout.read().decode("utf-8"))

# 还是同一个连接，开启SFTP通道回传文件到客户端
sftp_session = ssh.open_sftp()
sftp_session.get("/data/output.log", "./local_output.log")
sftp_session.close()

# 所有操作完成后再关闭连接
ssh.close()

注意：Paramiko的SSHClient实例不是线程安全的，如果要在多线程场景下复用同一个连接，需要对操作加锁避免数据包乱序异常。

场景2：复用非Paramiko创建的SSH连接 #

不同进程的SSH连接上下文（加密密钥、会话状态、TCP句柄等）都是独立存储在进程内存中的，Paramiko没有权限直接读取其他进程的SSH会话状态，因此没办法直接接管第三方工具创建的SSH连接。
如果要实现等价的单连接效果，可以借助OpenSSH的ControlMaster功能：

1. 先在本地创建SSH共享套接字：ssh -o ControlMaster=yes -o ControlPath=~/.ssh/ssh_mux_%h_%p_%r 用户名@服务器地址
2. 后续无论是命令行ssh操作还是Paramiko连接，指定同一个ControlPath参数，就会走已经建立好的共享连接，不会新建连接

内容的提问来源于stack exchange，提问作者mangotango