You need to enable JavaScript to run this app. 使用pysftp库建立SFTP连接传输文件时出现未找到主机密钥错误
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 22:36:00