Python脚本如何操作FTP服务器

wen 实用脚本 2026-07-12 1

Python脚本如何高效操作FTP服务器：从入门到自动化实战

目录导读

FTP协议基础与Python适配场景
环境准备：ftplib核心库安装与配置
三步实现FTP连接与文件传输
进阶技巧：目录遍历、异常处理与被动模式
企业级实战：批量上传脚本与定时同步
常见问题Q&A
安全建议与性能优化要点

FTP协议基础与Python适配场景

FTP（文件传输协议）作为经典的网络文件交换方式，在内部系统数据同步、日志备份、静态资源托管等场景中仍被广泛使用，Python通过内置的ftplib库提供了完整的FTP客户端实现，无需额外依赖即可完成文件的上传、下载、重命名和删除操作。

Python脚本如何操作FTP服务器

典型应用场景：

每日将服务器日志文件自动上传至备份FTP服务器
从第三方供应商FTP站点定期拉取数据文件
运维脚本批量分发配置文件到多台服务器
跨操作系统环境下的文件传输（Windows→Linux→macOS）

环境准备：ftplib核心库安装与配置

Python 3.x版本默认已集成ftplib，无需额外安装,导入方式：

from ftplib import FTP

连接所需参数：

服务器地址（IP或域名）
端口号（默认21）
用户名与密码
超时时间（建议设置30-60秒）
传输模式（主动/被动）

注意：多数现代FTP服务器要求使用被动模式（PASV），防火墙环境下尤其重要,具体配置方法见后续章节。

三步实现FTP连接与文件传输

基础连接示例

from ftplib import FTP
def connect_ftp():
    try:
        ftp = FTP('ftp.example.com', timeout=30)  # 修改为实际域名或IP
        ftp.login(user='username', passwd='password')
        ftp.set_pasv(True)  # 启用被动模式
        print(f"连接成功，当前目录: {ftp.pwd()}")
        return ftp
    except Exception as e:
        print(f"连接失败: {e}")
        return None
ftp = connect_ftp()

文件下载与上传

# 下载文件到本地
with open('local_file.txt', 'wb') as f:
    ftp.retrbinary('RETR remote_file.txt', f.write)
# 上传本地文件到服务器
with open('local_file.txt', 'rb') as f:
    ftp.storbinary('STOR remote_file.txt', f)

目录操作

ftp.cwd('/remote/path')           # 切换目录
ftp.mkd('new_folder')             # 创建目录
ftp.nlst()                        # 列出当前目录文件列表
ftp.delete('old_file.txt')        # 删除文件
ftp.rmd('empty_folder')           # 删除空目录

进阶技巧：目录遍历、异常处理与被动模式

递归遍历所有文件

def list_all_files(ftp, path='/'):
    files = []
    try:
        for item in ftp.nlst(path):
            if item in ['.', '..']:
                continue
            try:
                ftp.cwd(item)
                files.extend(list_all_files(ftp, item))
                ftp.cwd('..')
            except:
                files.append(f"{path}/{item}")
    except Exception as e:
        print(f"遍历异常: {e}")
    return files
all_files = list_all_files(ftp)
print(f"共有 {len(all_files)} 个文件")

异常处理最佳实践

from ftplib import all_errors
def safe_retrbinary(ftp, remote_path, local_path):
    try:
        with open(local_path, 'wb') as f:
            ftp.retrbinary(f'RETR {remote_path}', f.write, 1024*1024)  # 1MB缓冲区
        return True
    except all_errors as e:
        print(f"传输失败: {e}")
        return False

被动模式与主动模式选择

# 主动模式（PORT）：服务器主动连接客户端，易被防火墙拦截
# 被动模式（PASV）：客户端主动连接服务器数据端口，推荐用于NAT环境
ftp.set_pasv(True)  # 大多数场景使用此模式

企业级实战：批量上传脚本与定时同步

完整批量上传脚本（带重试机制）

import os
import time
from ftplib import FTP, error_perm
def upload_with_retry(local_dir, remote_dir, max_retry=3):
    ftp = connect_ftp()
    if not ftp:
        return
    ftp.cwd(remote_dir)
    for root, dirs, files in os.walk(local_dir):
        for file in files:
            local_path = os.path.join(root, file)
            remote_path = file
            for attempt in range(max_retry):
                try:
                    with open(local_path, 'rb') as f:
                        ftp.storbinary(f'STOR {remote_path}', f)
                    print(f"上传成功: {file}")
                    break
                except error_perm as e:
                    print(f"权限错误: {e}")
                    break
                except Exception as e:
                    print(f"上传失败(尝试{attempt+1}): {e}")
                    time.sleep(5)
            else:
                print(f"文件 {file} 上传失败，已达最大重试次数")
    ftp.quit()
# 使用示例
upload_with_retry('/local/data', '/remote/backup')

定时同步脚本（配合cron或Windows任务计划）

import schedule
import time
def sync_job():
    print(f"[{time.ctime()}] 开始同步...")
    upload_with_retry('/data', '/backup')
    print("同步完成")
schedule.every().day.at("03:00").do(sync_job)
while True:
    schedule.run_pending()
    time.sleep(60)