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

一、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()

高级操作

# 设置编码
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}")

二、实战案例

案例 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)