Python利用ftplib库实现ftp文件传输自动化全攻略

 更新时间:2026年04月23日 09:42:03   作者:科雷learning  
本文介绍了Python标准库ftplib的使用方法,详细描述了连接与登录、目录操作、文件上传下载、文件管理、目录列表查看等核心函数,并提供了两个实战案例,帮助实现FTP自动化操作,需要的朋友可以参考下

大家好!在日常工作中都会使用到ftp功能,用于上传和下载文件等,本章主要介绍Python的标准库ftplib来实现FTP文件传输,帮助我们实现ftp自动化。

01 ftplib库核心函数速查表

1️⃣ 连接与登录​​​​

#非加密传输
from ftplib import FTP
# 创建FTP对象
ftp = FTP()
# 连接服务器,ftp默认端口为21
ftp.connect(host='168.0.0.1', port=21)
# 登录认证,输入正确的用户名和密码
ftp.login(user='your_username', passwd='your_password')
# 操作完成后,安全退出连接
ftp.quit()
#使用FTPS加密连接,加密传输,防止数据泄露。
from ftplib import FTP_TLS
ftps = FTP_TLS('secure.example.com')
ftps.login(user='admin', passwd='secret')
ftps.prot_p() # 启用加密数据通道

说明:通过FTP()创建对象,connect方法指定服务器地址和端口建立连接,login方法输入用户名和密码完成认证,操作结束后用quit方法关闭连接,避免资源浪费。

2️⃣ 目录操作

# 获取当前所在目录
current_dir = ftp.pwd()
print(f"当前目录: {current_dir}")
# 切换到目标目录
ftp.cwd('/remote/files')
# 在服务器上创建新目录
ftp.mkd('new_folder')
# 删除空目录,注意目录必须为空才能删除成功
ftp.rmd('old_folder')

3️⃣ 文件上传下载

1)上传文件

# 以二进制模式上传文件,适用于图片、压缩包等非文本文件
with open('local_file.zip', 'rb') as f:
  ftp.storbinary('STOR remote_file.zip', f)
# 以ASCII模式上传文本文件,如txt,log,html,xml等,保证文本格式正确
with open('readme.txt', 'r') as f:
  ftp.storlines('STOR readme.txt', f)

说明:'STOR remote_file.zip'中的STOR是标准化写法,后面跟的是要上传的文件。

2)下载文件​​​​​​​

# 以二进制模式下载文件,将服务器文件保存到本地,第二个参事室回调函数
with open('local.zip', 'wb') as f:
  ftp.retrbinary('RETR remote.zip', f.write)
#传输大文件时,合理设置缓冲区大小能提升传输效率:
# 设置缓冲区大小为1MB,可根据实际情况调整
BUFFER_SIZE = 1024 * 1024
# 使用设置好的缓冲区大小下载大文件
with open('large_file.iso', 'wb') as f:
  ftp.retrbinary('RETR large_file.iso', f.write, blocksize=BUFFER_SIZE)
# 以文本模式下载文件,将服务器文件保存到本地
with open('local.txt', 'wb') as f:
  ftp.retrlines('RETR remote.txt', f.write)

说明:'STOR remote_file.zip'中的STOR是标准化写法,后面跟的是要上传的文件。

在实际使用中,下载文本文件时,可能会遇到转换换行符失败的情况,多行的文件下载后变为了一行。

此时可以自己重写回调函数,在每一行末尾加上换行符,如下:​​​​​​​

def write(line):
  f.write(line + '\n')
# 以文本模式下载文件,将服务器文件保存到本地 回调函数为自己定义的write函数
with open('local.txt', 'wb') as f:
  ftp.retrlines('RETR remote.txt', write)

4️⃣ 文件管理

对服务器上的文件进行管理,这些函数能满足你的常见需求:​​​​​​​

# 删除远程服务器上的指定文件
ftp.delete('obsolete_file.txt')
# 重命名文件,方便文件整理
ftp.rename('old_name.txt', 'new_name.txt')
# 获取文件大小,了解文件占用空间
size = ftp.size('large_file.iso')
print(f"文件大小: {size} 字节")

5️⃣ 目录列表

查看服务器目录内容,这几种方式能让你快速获取文件信息:​​​​​​​

# 获取简洁的文件列表
files = ftp.nlst()
print("目录内容:", files)
# 获取详细文件列表,直接打印到控制台
ftp.dir()
# 解析详细列表,获取文件名和类型
ftp.mlsd()

6️⃣ 其他操作​​​​​​​

# 设置编码
ftp.encoding = 'utf-8'
# 设置传输模式
ftp.set_pasv(True)  # 被动模式(推荐)
# 发送自定义命令
response = ftp.sendcmd('HELP')  # 获取服务器支持的命令
print("服务器支持命令:", response)
# 获取文件修改时间
mod_time = ftp.sendcmd('MDTM config.ini')
print(f"最后修改时间: {mod_time[4:]}")
# 设置超时时间
ftp = FTP(timeout=30)
# 异常处理示例,出现登录失败等问题时可添加重试逻辑
try:
  ftp.login(user, passwd)
except ftplib.error_temp as e:
  print(f"登录失败: {e}")

02实战案例

案例 1:自动备份数据到FTP​​​​​​​

import os
from datetime import datetime
from ftplib import FTP
def backup_site(local_dir, ftp_dir):
    # 创建带时间戳的备份目录,方便区分不同时间的备份
    timestamp = datetime.now().strftime("%Y%m%d_%H%M")
    backup_dir = f"{ftp_dir}/backup_{timestamp}"
    ftp = FTP('host地址')
    ftp.login('user', 'password')
    # 在服务器上创建备份目录
    ftp.mkd(backup_dir)
    ftp.cwd(backup_dir)
    # 遍历本地目录,上传所有文件
    for file in os.listdir(local_dir):
        local_path = os.path.join(local_dir, file)
        if os.path.isfile(local_path):
            with open(local_path, 'rb') as f:
                ftp.storbinary(f'STOR {file}', f)
    print(f"备份完成至: {backup_dir}")
    ftp.quit()
backup_site('dir1', '/dir2')

案例 2:定时下载日志文件

自动获取服务器日志,便于后续分析和排查问题:​​​​​​​

import schedule
import time
from ftplib import FTP
def download_logs():
    ftp = FTP('host地址')
    ftp.login('user', 'password')
    ftp.cwd('/logs')
    # 只下载今日日志,精准获取所需数据
    today = time.strftime("%Y%m%d")
    for file in ftp.nlst():
        if today in file:
            with open(file, 'wb') as f:
                ftp.retrbinary(f'RETR {file}', f.write)
    ftp.quit()
# 设置每天凌晨00:05执行下载任务
schedule.every().day.at("00:05").do(download_logs)
while True:
    schedule.run_pending()
    time.sleep(60)

以上就是Python利用ftplib库实现ftp文件传输自动化全攻略的详细内容,更多关于Python ftplib库ftp文件传输自动化的资料请关注脚本之家其它相关文章!

相关文章

  • 使用PyCharm创建Django项目及基本配置详解

    使用PyCharm创建Django项目及基本配置详解

    pycharm是个很不错的python开发工具,大大缩短了python项目的创建时间以及调试时间。这篇文章主要介绍了使用PyCharm创建Django项目及基本配置详解,pycharm是个很不错的python开发工具,大大缩短了python项目的创建时间以及调试时间
    2018-10-10
  • Python通用唯一标识符uuid模块使用案例

    Python通用唯一标识符uuid模块使用案例

    这篇文章主要介绍了Python通用唯一标识符uuid模块使用案例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-09-09
  • 浅析Python中的for 循环

    浅析Python中的for 循环

    这篇文章主要介绍了浅析Python中的for 循环的相关资料,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2016-06-06
  • django-rest-swagger对API接口注释的方法

    django-rest-swagger对API接口注释的方法

    今天小编就为大家分享一篇django-rest-swagger对API接口注释的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-08-08
  • Python的Tkinter点击按钮触发事件的例子

    Python的Tkinter点击按钮触发事件的例子

    今天小编就为大家分享一篇Python的Tkinter点击按钮触发事件的例子,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-07-07
  • 基于pycharm的beautifulsoup4库使用方法教程

    基于pycharm的beautifulsoup4库使用方法教程

    这篇文章主要介绍了基于pycharm的beautifulsoup4库使用方法教程,对正在学习或者工作的你有一点的参考价值,需要的朋友可以参加一下
    2022-01-01
  • 基于Python编写一个语音合成系统

    基于Python编写一个语音合成系统

    这篇文章主要介绍了如何利用Python制作一个语音合成系统,文中的示例代码讲解详细,对我们学习Python有一定的帮助,感兴趣的小伙伴可以了解一下
    2022-03-03
  • Python利用Spire.OCR for Python实现从图片中提取文本和坐标

    Python利用Spire.OCR for Python实现从图片中提取文本和坐标

    在数据处理、文档数字化及图像内容分析等开发场景中,光学字符识别(OCR)技术常被用于将图像中的文字转化为可编辑、可搜索的文本格式,Spire.OCR for Python 作为 Python 生态中的一款 OCR 类库,可实现图片文本提取及文字位置定位,下面小编为大家详细说说
    2025-10-10
  • Pycharm在指定目录下生成文件和删除文件的实现

    Pycharm在指定目录下生成文件和删除文件的实现

    这篇文章主要介绍了Pycharm在指定目录下生成文件和删除文件的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • 用python实现百度翻译的示例代码

    用python实现百度翻译的示例代码

    这篇文章主要介绍了用python实现百度翻译的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-03-03

最新评论