必须显式设timeout和auth_timeout并用ThreadPoolExecutor并发；执行命令后须调用recv_exit_status()获取退出状态，再读stdout和stderr；上传文件应使用SFTP而非exec_command('scp')。
Paramiko连接多台主机时如何避免阻塞等待
Paramiko默认的connect()和exec_command()都是同步阻塞的，逐台执行会拖慢整体部署速度，尤其当某台主机响应慢或不可达时，整个脚本可能卡住几十秒。必须显式设置超时并启用并发控制。
- 所有
connect()调用必须传入timeout=5和auth_timeout=5参数，否则SSH握手失败可能挂住30秒以上 - 不要用
time.sleep()模拟重试，改用try/except paramiko.ssh_exception.NoValidConnectionsError捕获连接失败 - 并发数建议控制在5–10之间（
concurrent.futures.ThreadPoolExecutor(max_workers=8)），超过容易触发目标主机的SSH连接限制（如MaxStartups）
执行远程命令后如何可靠获取退出状态和完整输出
很多人直接读stdout.read()就认为命令成功了，但exec_command()不等命令结束就返回通道，且exit_status需主动调用recv_exit_status()获取——漏掉这步会导致误判成功。
- 必须按顺序操作：
stdin, stdout, stderr = client.exec_command(cmd)→stdout.read()→stderr.read()→stdout.channel.recv_exit_status() - 不要忽略
stderr，某些部署命令（如pip install）错误信息全在stderr里，stdout反而为空 - 对长输出使用
stdout.readlines()而非read()，避免内存暴涨；敏感命令（如含密码的curl）建议先set_combine_stderr(True)
上传文件时为什么scp-like行为不稳定？用SFTP还是paramiko.Transport？
Paramiko没有内置scp命令封装，很多人误用exec_command('scp ...')，这依赖远端scp二进制且权限复杂；正确方式是走SFTP子系统，但要注意SFTP客户端生命周期管理。
- 必须用
client.open_sftp()创建独立SFTP通道，不能复用SSH连接对象，否则并发上传时会抛IOError: Socket is closed - 上传大文件前先检查磁盘空间：
sftp.stat('/tmp').st_size不够就跳过，避免传到一半因No space left on device失败 - 路径中含空格或中文时，
sftp.put()会静默失败，务必用os.path.abspath()标准化本地路径，并确认远端目录已存在（sftp.mkdir()需手动处理IOError: Failure）
批量部署中密钥登录失败的三个隐藏原因
即使ssh -i key user@host能通，Paramiko仍可能报AuthenticationException: Authentication failed，问题通常不在密钥本身。
立即学习“Python免费学习笔记（深入）”；
- 私钥格式必须是OpenSSH格式（
-----BEGIN RSA PRIVATE KEY-----），不是PuTTY的.ppk；可用ssh-keygen -p -f key -m pem转换 - 远端
~/.ssh/authorized_keys权限不能是644，必须是600，且~/.ssh目录不能是755以上，Paramiko比OpenSSH校验更严 - 如果用
paramiko.RSAKey.from_private_key_file()加载密钥，而密钥有密码，必须传入password='xxx'参数，空字符串''不等于“无密码”，会直接抛异常
client.close()，导致文件描述符耗尽；还有人把所有主机的SSHClient()实例塞进一个列表长期持有，结果Python进程越跑越慢。这些细节不处理，脚本在20台机器上大概率中途崩掉。 
