paramiko.sshclient()用于执行远程命令，而sftp文件操作需通过其open_sftp()方法获取sftpclient实例；后者依赖底层transport连接，须先调用connect()建立会话。
paramiko.SSHClient() 和 transport.open_sftp() 有什么区别？
直接用 paramiko.SSHClient() 只能执行命令，不能读写文件；真正做文件操作得靠 SFTP 子协议，必须通过 transport.open_sftp() 获取 SFTPClient 实例。常见错误是调用 ssh.open_sftp() 失败却误以为是认证问题——其实根本原因是没先建立底层 transport 连接（ssh.connect() 内部会创建 transport，但某些自定义配置下需显式管理）。
实操建议：
- 优先用
paramiko.SSHClient()+connect()，再调open_sftp()——这是最简且兼容性最好的路径 - 若需精细控制加密算法或超时，才手动构造
paramiko.Transport，否则徒增出错概率 -
SFTPClient不是线程安全的，多线程场景下每个线程应独占一个实例
上传文件时出现 “IOError: Failure” 或权限拒绝怎么办？
这不是 paramiko 报的错，而是远端 SFTP 服务返回的通用失败码，背后原因五花八门。最常踩的坑是路径不存在、用户无写入权限、磁盘满，或目标路径是符号链接但服务端禁用了 follow_symlinks。
实操建议：
- 上传前先用
sftp.stat()检查父目录是否存在，用sftp.listdir_attr()确认当前用户对该目录有w权限 - 避免硬编码绝对路径，用
sftp.normalize('path')获取服务端解析后的实际路径，再比对权限 - 上传大文件时加
callback参数监控进度，防止因网络抖动导致连接超时被服务端中断 - 别用
sftp.put()直传本地路径含中文或空格的文件——先用os.path.abspath()规范化，再确保远端 locale 支持 UTF-8
下载文件卡住或报 “SSHException: Channel closed.” 怎么定位？
典型表现是 sftp.get() 调用后长时间无响应，或中途抛出 channel 关闭异常。根本原因通常是远端 SFTP 服务主动断连（如闲置超时）、客户端未正确处理大文件流、或传输中遇到不可读文件（如设备文件、管道）。
实操建议：
- 设置 transport 层心跳：
transport.set_keepalive(30)，防止中间设备切断空闲连接 - 下载前用
sftp.stat()检查文件大小，超 100MB 建议改用分块读取（sftp.file().read()配合循环），避免一次性加载进内存 - 若目标是日志类追加文件，注意远端可能正在写入——
sftp.stat()返回 size 变动时，应暂停下载或加重试逻辑 - 别忽略
get()的preserve_mtime参数：设为False可规避部分服务端因时区/权限导致的 mtime 设置失败
如何安全地处理私钥认证和密码交互？
用密码登录看似简单，但 connect(..., password='xxx') 会明文暴露凭据；用私钥又常因格式（PEM vs OpenSSH）、密码保护、路径权限等问题失败。paramiko 对密钥加载非常严格，错误信息却很模糊。
实操建议：
- 私钥必须是 PEM 格式（以
-----BEGIN RSA PRIVATE KEY-----开头），OpenSSH 新格式（-----BEGIN OPENSSH PRIVATE KEY-----）需用paramiko.RSAKey.from_private_key_file()显式加载 - 带密码的私钥，务必传入
password=xxx到from_private_key_file()，而非connect()的 password 参数 - 生产环境禁用
AutoAddPolicy()，改用RejectPolicy()+ 预置 known_hosts 文件，避免中间人攻击 - 敏感凭据别硬编码——从环境变量读取（
os.getenv('SSH_PASS')），或用getpass.getpass()交互式输入
symlink，有的限制单次传输大小，有的对 root 用户额外加锁。与其反复试错，不如先用命令行 sftp -v user@host 跑一次，看详细日志里服务端到底拒绝了什么操作。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
