### 使用 Paramiko 或 ftplib 实现 Python 远程拉取文件夹 #### 方法一：基于 Paramiko 的实现 Paramiko 是一个用于 SSH 协议的 Python 库，可以用来执行命令以及传输文件。通过 `SFTP` 功能模块，能够轻松完成远程文件夹下载的任务。 以下是使用 Paramiko 下载远程文件夹到本地的具体代码： ```python import os import stat import paramiko class SFTPDownloader: def __init__(self, host, port, user, pkey_path): self.host = host self.port = port self.user = user self.pkey = paramiko.RSAKey.from_private_key_file(pkey_path) def connect(self): transport = paramiko.Transport((self.host, self.port)) transport.connect(username=self.user, pkey=self.pkey) self.sftp = paramiko.SFTPClient.from_transport(transport) def download_dir(self, remote_path, local_path): try: os.makedirs(local_path, exist_ok=True) for attr in self.sftp.listdir_attr(remote_path): rpath = f"{remote_path}/{attr.filename}" lpath = os.path.join(local_path, attr.filename) if stat.S_ISDIR(attr.st_mode): self.download_dir(rpath, lpath) else: self.sftp.get(rpath, lpath) except Exception as e: print(f"Error downloading {remote_path}: {e}") def close(self): self.sftp.close() if __name__ == "__main__": downloader = SFTPDownloader(host="example.com", port=22, user="username", pkey_path="/path/to/private/key") downloader.connect() downloader.download_dir("/remote/path", "/local/destination") # 替换为实际路径 downloader.close() ``` 此脚本会递归遍历指定的远程目录并将其复制到本地磁盘[^1]。 --- #### 方法二：基于 FTPlib 的实现 对于不支持 SSH/SFTP 的服务器，可以选择使用标准库中的 `ftplib` 来完成类似的文件夹同步操作。 下面是利用 `ftplib` 拉取整个远程文件夹的例子： ```python from ftplib import FTP import os def ftp_download_directory(ftp_conn, remote_dir, local_dir): original_remote_dir = ftp_conn.pwd() ftp_conn.cwd(remote_dir) if not os.path.exists(local_dir): os.makedirs(local_dir) file_list = [] ftp_conn.retrlines('LIST', lambda x: file_list.append(x.split())) for info in file_list: name = info[-1] full_local_path = os.path.join(local_dir, name) if info[0].startswith("d"): # 如果是目录，则递归处理子目录 ftp_download_directory(ftp_conn, name, full_local_path) elif info[0].startswith("-"): # 如果是文件，则直接下载 with open(full_local_path, 'wb') as fp: ftp_conn.retrbinary(f'RETR {name}', fp.write) ftp_conn.cwd(original_remote_dir) if __name__ == "__main__": ftp = FTP("example.com") ftp.login(user="username", passwd="password") remote_folder = "/remote/folder" local_destination = "/local/destination" ftp_download_directory(ftp, remote_folder, local_destination) ftp.quit() ``` 该函数同样采用递归方式来获取远程文件夹的内容，并保存至目标位置[^1]。 --- #### 总结 两种方案各有优劣： - **Paramiko** 更适合于需要安全连接（SSH 密钥认证）或者已经配置好 SSH 访问权限的情况。 - **Ftplib** 则适用于简单的 FTP 场景，在不需要加密的情况下更加轻量级。 无论哪种方法都需要注意异常捕获机制以增强程序健壮性；同时也要考虑网络状况可能带来的超时等问题。