Python使用Paramiko自动下载SFTP文件完整示例

不晚

发布时间：2026-10-14| 3人浏览过

原创

本文介绍如何利用Python的Paramiko库实现SFTP文件的自动下载功能。通过配置主机、端口及认证信息，程序可递归遍历远程指定目录，将包含子目录的所有文件同步至本地指定路径。文中提供了完整的Python代码示例及环境配置说明，适用于CentOS7及Python3环境。

Python自动下载SFTP文件概述

本文分享了一段使用Python实现SFTP文件自动下载的具体代码，供读者参考学习。

主要功能是通过Python脚本自动连接SFTP服务器，并下载指定目录下的所有子目录及文件。

系统环境为CentOS7。
Python版本要求为Python3。
依赖模块为paramiko，若未安装，可通过命令pip install paramiko进行安装。

环境配置与依赖安装

需求场景示例：SFTP服务器中的文件结构如下

SFTP递归下载代码实现

目标是将SFTP根目录下的所有文件递归下载到本地/data/test目录中。

具体实现代码如下：


#!/usr/bin/python
# coding=utf-8

import paramiko
import os

def sftp_download(sftp,localDir,remoteDir):
    if remoteDir.find(".") == -1:#判断远程目录参数是否是目录，前提是远程的文件名中都包含扩展名，否则此方法不可用
        for file in sftp.listdir(remoteDir):
            remoteDirTmp=os.path.join(remoteDir,file)
            localDirTmp=os.path.join(localDir,file)
            sftp_download(sftp,localDirTmp,remoteDirTmp)
    else:
        localPath=localDir.rpartition("/")[0]
        if not os.path.exists(localPath):
            os.makedirs(localPath)
        print("download file:",remoteDir)
        try:
            sftp.get(remoteDir,localDir)
        except Exception as e:
            print('download exception:',e)
    
    
if __name__ == '__main__':
    host = '192.168.149.128'#sftp主机 
    port = 22 #端口
    username = 'sftp' #sftp用户名
    password = '123456'  
    localDir = '/data/test'#本地文件或目录
    remoteDir = '/'#远程文件或目录
    sf = paramiko.Transport((host,port))
    sf.connect(username = username,password = password)
    sftp = paramiko.SFTPClient.from_transport(sf)
    sftp_download(sftp,localDir,remoteDir)
    sf.close()

以上即为本文的全部内容，希望对读者的学习有所帮助，欢迎继续支持本站。