使用pysftp库建立SFTP连接传输文件时出现未找到主机密钥错误
报错原因说明
该报错是pysftp的默认安全校验逻辑触发:库本身要求SFTP连接前需要校验服务端的可信主机密钥,当本地没有留存目标IP对应的主机密钥记录时,就会直接抛出No hostkey for host 100.100.100.1 found的错误,阻止连接建立。
对应解决方法
根据使用场景选择对应方案即可:
- 内网临时测试场景
⚠️ 该方案会跳过所有主机密钥校验,存在中间人攻击风险,严禁在生产环境、公网连接场景使用。
调整代码逻辑,在连接初始化时传入自定义配置对象,关闭主机密钥校验,核心代码修改如下:import pysftp from pysftp import CnOpts host = "100.100.100.1" #the host ip passw = "myPass" #password user = "myUser" #username path = "/destination/" localpath = "D:/myFolder/test.txt" # 关闭主机密钥校验 cnopts = CnOpts() cnopts.hostkeys = None sftp = pysftp.Connection( host, username=user, password=passw, cnopts=cnopts ) sftp.put(localpath, path) sftp.close() - 生产/正式使用场景
无需修改业务代码,先通过本地SSH命令行工具主动连接一次目标SFTP服务,首次连接时按照提示确认信任该主机,系统会自动将服务端的主机密钥写入本地known_hosts信任列表文件。pysftp默认会读取该文件完成密钥校验,后续即可正常建立连接。
原代码的潜在问题提醒
除了主机密钥的报错外,示例代码还存在两个容易触发后续报错的细节问题:
sftp.put()方法仅支持上传单个具体文件,原代码中localpath填写的是文件夹路径,需要替换为指向具体文件的完整地址,否则会抛出“路径不是有效文件”的错误。- 目标服务器路径
/destination/需要确保当前登录的SFTP用户拥有对应目录的写入权限,且该目录在服务端真实存在。
内容的提问来源于stack exchange,提问作者Ezecamele
相关产品推荐
相关产品推荐

