如何编写FTP批量传输文件脚本

wen 实用脚本 2026-06-25 34

如何编写FTP批量传输文件脚本：从基础到高级的完整指南

目录导读

FTP批量传输的核心概念
准备工作：环境与必要工具
基础脚本编写：Windows批处理实现
进阶脚本：Linux Shell脚本实战
Python脚本实现跨平台FTP批量传输
安全与错误处理最佳实践
常见问题与问答(QA)
总结与资源推荐

FTP批量传输的核心概念

FTP（File Transfer Protocol）是互联网上最经典的文件传输协议之一，在日常运维、数据备份或网站管理中，我们经常需要将大量文件从本地传输到服务器，或从多个源下载文件，手动操作不仅低效，还容易出错,编写FTP批量传输脚本能显著提升效率。

如何编写FTP批量传输文件脚本

关键术语：

被动模式(PASV)：客户端主动连接服务器端口，穿透防火墙更友好
主动模式(PORT)：服务器主动连接客户端，可能被防火墙阻止
ASCII模式：适合文本文件
二进制模式：适合图片、压缩包等非文本文件

适用场景：

每日日志文件备份
网站静态资源同步
跨服务器文件迁移
定时数据采集

准备工作：环境与必要工具

在开始编写脚本前,请确认以下条件：

1 FTP服务器信息

服务器地址（IP或域名）
用户名和密码
目标目录路径
端口（默认21）

2 操作系统与工具

平台	推荐工具	特点
Windows	批处理 + ftp命令	系统内置，无需安装
Linux	Bash + ftp/lftp	lftp支持断点续传
跨平台	Python ftplib	灵活度高，功能强大

3 测试环境搭建

建议先在小范围内测试脚本，避免误操作导致数据丢失，可以使用本地搭建的FTP服务器（如FileZilla Server或vsftpd）进行验证。

基础脚本编写：Windows批处理实现

Windows系统自带的ftp命令可以通过简单脚本实现批量传输,以下是一个完整的示例：

@echo off
REM 文件名：ftp_batch_upload.bat
REM 功能：批量上传当前目录下所有.txt文件
set FTP_SERVER=example.com
set FTP_USER=username
set FTP_PASS=password
set REMOTE_DIR=/upload/files
set LOCAL_DIR=C:\data
echo open %FTP_SERVER%> ftpcmd.txt
echo %FTP_USER%>> ftpcmd.txt
echo %FTP_PASS%>> ftpcmd.txt
echo binary>> ftpcmd.txt
echo cd %REMOTE_DIR%>> ftpcmd.txt
REM 遍历本地文件
for %%f in (%LOCAL_DIR%\*.txt) do (
    echo put "%%f">> ftpcmd.txt
)
echo bye>> ftpcmd.txt
ftp -s:ftpcmd.txt
del ftpcmd.txt
echo 上传完成！

关键点：

使用echo >动态生成FTP命令文件
binary确保二进制传输模式
put命令逐个上传文件

缺点：

不支持通配符直接上传多个文件
错误处理能力弱

进阶脚本：Linux Shell脚本实战

在Linux环境下，推荐使用lftp工具，它支持多线程、断点续传和通配符：

1 安装lftp

# CentOS/RHEL
sudo yum install lftp -y
# Ubuntu/Debian
sudo apt-get install lftp -y

2 批量下载脚本

#!/bin/bash
# 文件名：ftp_download.sh
# 功能：从FTP服务器批量下载所有.log文件
SERVER="example.com"
USER="username"
PASS="password"
REMOTE_DIR="/logs"
LOCAL_DIR="/backup/logs"
# 创建本地目录
mkdir -p "$LOCAL_DIR"
# 使用lftp连接并下载
lftp -u "$USER","$PASS" "$SERVER" <<EOF
set ftp:passive-mode on
cd $REMOTE_DIR
lcd $LOCAL_DIR
mget -c *.log
bye
EOF
echo "下载完成，文件保存在 $LOCAL_DIR"

优势：

mget支持通配符批量下载
-c参数开启断点续传
支持mirror命令同步整个目录

3 镜像同步（推荐）

lftp -u "$USER","$PASS" "$SERVER" -e "mirror --reverse --delete --verbose $LOCAL_DIR $REMOTE_DIR; bye"

--reverse：从本地同步到远程
--delete：删除远程多余文件
--verbose：显示详细进度

Python脚本实现跨平台FTP批量传输

Python的ftplib库功能强大,适合复杂业务逻辑：

1 批量上传脚本

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# 文件名：ftp_uploader.py
import ftplib
import os
from pathlib import Path
def upload_files(host, user, passwd, remote_dir, local_dir, file_pattern):
    """
    批量上传匹配模式的文件
    """
    try:
        # 连接FTP服务器
        ftp = ftplib.FTP(host)
        ftp.login(user, passwd)
        ftp.set_pasv(True)  # 启用被动模式
        # 切换到远程目录
        ftp.cwd(remote_dir)
        # 遍历本地文件
        local_path = Path(local_dir)
        for file in local_path.glob(file_pattern):
            if file.is_file():
                with open(file, 'rb') as f:
                    ftp.storbinary(f'STOR {file.name}', f)
                print(f"已上传: {file.name}")
        ftp.quit()
        return True
    except Exception as e:
        print(f"上传失败: {e}")
        return False
if __name__ == "__main__":
    # 配置参数
    HOST = "example.com"
    USER = "username"
    PASSWD = "password"
    REMOTE_DIR = "/upload"
    LOCAL_DIR = "./data"
    PATTERN = "*.csv"  # 支持通配符
    upload_files(HOST, USER, PASSWD, REMOTE_DIR, LOCAL_DIR, PATTERN)

2 错误处理与日志

import logging
logging.basicConfig(
    filename='ftp_transfer.log',
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s'
)
# 在try块中添加日志
logging.info(f"开始上传文件: {file.name}")
logging.error(f"文件上传失败: {e}")

Python脚本优势：

跨平台兼容
支持正则匹配文件名
可集成到更大的自动化流程
错误处理灵活

安全与错误处理最佳实践

1 避免明文密码

使用环境变量：$FTP_PASS
配置文件加权限：chmod 600 config.ini
考虑SFTP/SCP替代（加密传输）

2 脚本健壮性检查

# 检查FTP服务器连通性
if ! ping -c 1 $SERVER &> /dev/null; then
    echo "无法连接服务器"
    exit 1
fi
# 检查本地文件是否存在
if [ ! -d "$LOCAL_DIR" ]; then
    echo "本地目录不存在"
    exit 1
fi

3 重试机制示例（Python）

import time
max_retries = 3
retry_delay = 5
for attempt in range(max_retries):
    try:
        # FTP操作
        break
    except ftplib.all_errors as e:
        if attempt < max_retries - 1:
            time.sleep(retry_delay)
        else:
            raise

常见问题与问答(Q&A)

Q1: 脚本提示“无法建立连接”怎么办？

A: 检查三点：

服务器地址和端口是否正确（默认21）
防火墙是否允许FTP流量
尝试被动模式（在脚本中添加passive设置）

Q2: 如何传输包含子目录的文件夹？

A: 推荐使用lftp的mirror命令或Python的递归遍历：

for root, dirs, files in os.walk(local_dir):
    for file in files:
        # 构建远程路径
        relative_path = os.path.relpath(os.path.join(root, file), local_dir)
        remote_path = os.path.join(remote_dir, relative_path)
        # 确保远程目录存在
        ftp.mkd(os.path.dirname(remote_path))  # 需先创建目录

Q3: 传输大文件时中途失败怎么办？

A: 开启断点续传功能：

lftp添加-c参数
Python使用ftplib的REST命令恢复传输

Q4: Windows批处理如何传输中文文件名？

A: 在FTP命令前添加literal quote site cp932（针对Shift-JIS编码）或使用Python的ftplib直接处理Unicode。

Q5: 脚本如何定时执行？

A: 利用系统任务计划：

Windows：schtasks或任务计划程序

Linux：crontab -e添加定时任务

# 每天凌晨2点执行
0 2 * * * /path/to/ftp_script.sh

总结与资源推荐

编写FTP批量传输脚本的核心在于：

明确需求：确定文件类型、方向（上传/下载）、频率
选择工具：简易任务用系统命令，复杂需求用Python/lftp
安全优先：避免硬编码密码，使用加密通信
充分测试：在隔离环境验证脚本逻辑

推荐工具：

lftp：Linux下最强FTP客户端
Python：灵活性最高，适合自动化流水线
WinSCP：Windows图形化+脚本支持

进一步学习：

官方文档：man lftp、Python ftplib
结合rsync实现增量同步
实验SFTP（SSH协议）获得更高安全性

通过掌握这些技巧，你可以将FTP文件传输完全自动化，节省大量手动操作时间，一个好的脚本应该具备错误恢复、日志记录和可配置性,这样才能在生产环境中稳定运行。