一、起源

1.1 设计目的

FTP(File Transfer Protocol,文件传输协议)在 1971 年提出(RFC 114),早于 TCP/IP 协议族,最终被纳入 TCP/IP 标准(RFC 959,1985)。

设计之初的核心问题:如何在两台独立主机之间实现可靠的、可交互的文件双向传输。与 HTTP 等单通道协议不同,FTP 从诞生起就采用双连接模型——一条连接传输控制指令,另一条连接传输实际文件数据——使得控制与传输互不阻塞。

1.2 设计目标

  • 主机间文件共享,无需知晓远程文件系统细节
  • 支持上传(STOR)、下载(RETR)、目录列表(LIST)、改名(RNFR/RNTO)、删除(DELE)、创建目录(MKD)等操作
  • 支持多种数据表示(ASCII / BINARY / EBCDIC)
  • 支持认证(用户名 + 密码)

二、原理

2.1 双连接模型

FTP 在运行时维护两条独立的 TCP 连接:

连接 端口(默认) 方向 生命周期 传输内容
控制连接(Control Connection) 21(服务器端) 客户端 → 服务器 会话全程(登录到 QUIT) FTP 命令与响应(ASCII 文本,每行以 CRLF 结束)
数据连接(Data Connection) 20(主动模式,服务器端)/ 随机(被动模式) 依据模式不同 每次数据传输临时建立,传完即关 文件内容、目录列表等原始数据

流程概述:
1. 客户端与服务器 21 端口建立控制连接,完成握手
2. 客户端发送 USER / PASS 完成认证
3. 需传输数据时,客户端或服务器(依模式)建立数据连接
4. 数据传输完成后,关闭数据连接;控制连接保持
5. 客户端发送 QUIT,关闭控制连接,会话结束

2.2 主动模式(PORT / Active)

  1. 客户端开一个随机端口 N(>1024),向服务器 21 发起控制连接
  2. 客户端在控制连接上发送 PORT N+1,告知服务器用本机 N+1 端口准备接收数据
  3. 服务器主动从 20 端口向客户端 N+1 端口发起 TCP 连接,建立数据通道
  4. 数据传输完成后,数据连接关闭

问题:客户端若在 NAT 后,其私网地址和端口对服务器不可达,连接失败。

2.3 被动模式(PASV / Passive)

  1. 客户端控制连接到服务器 21 端口
  2. 客户端发送 PASV,请求服务器告知可连接的端口
  3. 服务器回复 227 Entering Passive Mode (h1,h2,h3,h4,p1,p2),其中 IP = h1.h2.h3.h4,端口 = p1*256 + p2
  4. 客户端主动向服务器返回的 IP + 端口发起连接,建立数据通道
  5. 数据传输完成后关闭

现代客户端默认使用被动模式,可兼容客户端位于 NAT / 防火墙后的场景。

2.4 响应码体系

FTP 响应以 3 位数字开头,后跟说明文本。首位表示类别:

首位 含义
1xx 积极初步答复,操作已开始,等待后续确认
2xx 积极完成答复,操作成功
3xx 积极中间答复,需发送更多命令(如认证)
4xx 暂态消极完成,临时错误,稍后重试可成功
5xx 永久消极完成,操作不可恢复地失败

常用响应码:

码 含义
220 服务就绪(欢迎信息)
227 进入被动模式,附带 IP 和端口
230 登录成功
331 用户名正确,需密码
530 用户名或密码错误,未登录
150 数据连接已打开,开始传输
226 传输完成,关闭数据连接
550 文件不可用(无权限或不存在)

2.5 传输模式

  • TYPE A:ASCII 模式,传输文本时做换行符转换(LF ↔ CRLF),用于文本文件
  • TYPE I:Binary / Image 模式,字节流原样传输,用于二进制文件(图片、压缩包、可执行文件)

错误选择会导致文件损坏:用 ASCII 传二进制会将所有值为 0x1A(Ctrl+Z)的字节当作 EOF,用 Binary 传文本在跨平台时换行符不转换。现代客户端通常对非 .txt 后缀自动选 Binary。

2.6 安全问题与演进

  • 明文传输:控制连接的 USER / PASS 以及所有数据均为明文,易被嗅探
  • 数据通道使用随机端口,对防火墙放行策略不友好
  • 演化出的安全替代:
  • FTPS:FTP over TLS/SSL(RFC 4217),控制连接和数据连接可分别加 TLS
  • SFTP:SSH File Transfer Protocol,基于 SSH 会话的单通道协议(并非 FTP 的扩展,易混淆)
  • HTTPS WebDAV:基于 HTTP 的文件操作

三、实现与使用

3.1 常用客户端命令行工具

ftp(系统内置,FTP 协议)

Windows 自带;Linux 需 apt install ftp 或 yum install ftp。

# 连接到服务器(默认 21 端口)
ftp 192.168.1.10

# 指定端口
ftp 192.168.1.10 2121

# 进入交互后的常用命令
user <username>         # 重新登录
passive                 # 切换被动/主动模式(输入一次切换一次)
binary                  # 切换二进制模式
ascii                   # 切换 ASCII 模式

ls                      # 列出远程当前目录
cd <dir>                # 进入远程目录
pwd                     # 显示远程当前路径
lcd <dir>               # 切换本地当前目录
mkdir <dir>             # 新建远程目录
rmdir <dir>             # 删除远程空目录

get remote.txt          # 下载单个文件
get -p remote.txt       # 下载并保留原文件名(等价于 get)
mget *.txt              # 批量下载(支持通配符,逐个询问)
prompt                  # 切换批量时的交互提示

put local.txt           # 上传单个文件
mput *.log              # 批量上传

rename old new          # 改名
delete file.txt         # 删除单个文件
mdelete *.tmp           # 批量删除

size remote.txt         # 查看文件大小
hash                    # 每传输 1024 字节打印一个 # 进度条
verbose                 # 切换详细输出
bye                     # 退出

lftp(脚本友好,FTP/FTPS/SFTP)

apt install lftp

# 连接
lftp -u username,password 192.168.1.10

# 非交互批量下载(适合脚本)
lftp -u username,password 192.168.1.10 -e "mirror /remote/path /local/path; quit"

# 非交互批量上传
lftp -u username,password 192.168.1.10 -e "mirror -R /local/path /remote/path; quit"

# 断点续传(-c)
lftp -u username,password 192.168.1.10 -e "get -c bigfile.iso; quit"

curl(单命令下载/上传)

# 下载(被动模式默认)
curl -u username:password ftp://192.168.1.10/path/file.txt -o local.txt

# 主动模式
curl -P - -u user:pass ftp://192.168.1.10/file.txt -o local.txt

# 列出目录
curl -u user:pass ftp://192.168.1.10/path/

# 上传
curl -u user:pass -T local.txt ftp://192.168.1.10/remote/path/

# FTPS 显式 TLS
curl -u user:pass --ftp-ssl ftp://192.168.1.10/

3.2 服务端部署

vsftpd(Linux)

apt install vsftpd            # Debian / Ubuntu
yum install vsftpd            # CentOS / RHEL
systemctl enable vsftpd
systemctl start vsftpd

/etc/vsftpd.conf 关键配置:

# ========== 基础 ==========
listen=YES                    # IPv4 独立监听
listen_port=21                # 控制端口
anonymous_enable=NO           # 关闭匿名登录
local_enable=YES              # 允许本地系统用户登录
write_enable=YES              # 允许写操作(上传/删除/改名)
local_umask=022               # 新建文件权限掩码(755/644)

# ========== 被动模式 ==========
pasv_enable=YES               # 启用被动模式
pasv_min_port=40000           # 被动端口范围下限
pasv_max_port=40100           # 被动端口范围上限(防火墙需放行 40000-40100)
pasv_address=1.2.3.4          # 被动模式对外公告的 IP(公网服务器必设)
pasv_promiscuous=NO

# ========== 安全 ==========
chroot_local_user=YES         # 限制用户在自己家目录,不可访问上级
allow_writeable_chroot=YES    # 允许 chroot 目录可写(vsftpd 3.x 要求)
userlist_enable=YES           # 启用用户白名单
userlist_file=/etc/vsftpd.user_list
userlist_deny=NO              # YES=黑名单,NO=白名单
ssl_enable=NO                 # 如需 FTPS 改为 YES 并配置证书

# ========== 日志 ==========
xferlog_enable=YES
xferlog_std_format=YES
vsftpd_log_file=/var/log/vsftpd.log

添加 FTP 用户:

useradd -m -s /sbin/nologin ftpuser
passwd ftpuser
echo "ftpuser" >> /etc/vsftpd.user_list
systemctl restart vsftpd

防火墙放行:

ufw allow 21/tcp
ufw allow 40000:40100/tcp
ufw reload

vsftpd(Docker)

docker run -d \
  -p 21:21 -p 40000-40100:40000-40100 \
  -e FTP_USER=ftpuser \
  -e FTP_PASS=MyPass123 \
  -e PASV_ADDRESS=1.2.3.4 \
  -e PASV_MIN_PORT=40000 \
  -e PASV_MAX_PORT=40100 \
  -v /host/ftpdata:/home/vsftpd \
  --name vsftpd fauria/vsftpd

Windows Server IIS FTP

  1. 服务器管理器 → 添加角色和功能 → Web 服务器(IIS)→ FTP 服务器
  2. IIS 管理器 → 网站 → 添加 FTP 站点 → 选择物理路径、绑定 21
  3. 身份验证:启用基本(明文,建议搭配 SSL)或匿名
  4. 授权规则:配置允许的用户/角色、读写权限
  5. FTP 防火墙支持 → 配置被动端口范围(如 40000-40100)和外部 IPv4 地址

3.3 Nginx 作为 FTP 代理(流转发)

Nginx 原生 ngx_stream_core_module 做 TCP 层透传,FTP 控制与被动端口需各自监听。

load_module modules/ngx_stream_module.so;

stream {
    # 控制连接 21
    server {
        listen 21;
        proxy_pass 192.168.1.10:21;
        proxy_timeout 10m;
        proxy_connect_timeout 5s;
    }

    # 被动端口范围(需与后端 FTP 服务器配置对齐)
    server {
        listen 40000-40100;
        proxy_pass 192.168.1.10:$server_port;
    }
}

注意:被动模式下 FTP 控制连接会明文传递 IP 和端口,若 nginx 位于公网而 FTP 服务器在内网,需保证 pasv_address 配置为 nginx 的公网 IP,否则客户端会错误地去连接后端内网 IP。

3.4 测试与验证流程

# 1. 端口连通性
telnet 192.168.1.10 21
nc -zv 192.168.1.10 21

# 2. 登录验证(预期看到 230 Login successful)
ftp -v 192.168.1.10
# 输入用户名 → 331 Please specify the password.
# 输入密码 → 230 Login successful.

# 3. 被动模式目录列表(验证数据通道打通)
# ftp 交互中执行
passive
ls
# 成功会看到 150 + 226 及目录内容;失败则一直卡或报错 425

# 4. 上传下载测试
echo "hello" > test.txt
put test.txt
get test.txt download.txt
diff test.txt download.txt

# 5. 被动端口范围验证
# 连续执行多次 ls,观察服务器端响应中的端口是否在 40000-40100 区间

# 6. 错误排查
# 登录失败:检查 userlist_enable/userlist_deny、PAM / selinux
# ls 卡在 Entering Passive Mode:检查防火墙放行被动端口范围,pasv_address 是否公网可达
# 上传 Permission denied:检查目录权限、write_enable=YES、chroot_writeable_chroot
# 下载文件损坏:确认是否误用 ASCII 模式传二进制,改用 binary

四、常见故障速查

现象 可能原因 排查点
连不上 21 端口 服务未启动 / 防火墙未放行 ss -tlnp \| grep :21;ufw status
认证失败(530) 用户不在白名单 / 密码错 / shell 受限 vsftpd.user_list、chsh ftpuser、PAM 日志
PASV 后卡住 425 被动端口防火墙未开 / pasv_address 错误 抓包看返回的 IP:端口;验证端口连通性
上传 550 Permission denied 写权限、umask、selinux 目录写权限;getsebool -a \| grep ftp
LIST 成功但 RETR 超时 数据连接被中间设备拦截 换主动/被动模式;检查 NAT 会话超时
文件损坏 / 大小不一致 ASCII 模式传输了二进制 binary 切换后重试
500 OOPS: vsftpd: refusing to run with writable root inside chroot vsftpd 安全检查:chroot 目录不可写 设 allow_writeable_chroot=YES,或移除用户对根目录的写权限