一、起源
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)
- 客户端开一个随机端口 N(>1024),向服务器 21 发起控制连接
- 客户端在控制连接上发送
PORT N+1,告知服务器用本机 N+1 端口准备接收数据 - 服务器主动从 20 端口向客户端 N+1 端口发起 TCP 连接,建立数据通道
- 数据传输完成后,数据连接关闭
问题:客户端若在 NAT 后,其私网地址和端口对服务器不可达,连接失败。
2.3 被动模式(PASV / Passive)
- 客户端控制连接到服务器 21 端口
- 客户端发送
PASV,请求服务器告知可连接的端口 - 服务器回复
227 Entering Passive Mode (h1,h2,h3,h4,p1,p2),其中 IP = h1.h2.h3.h4,端口 = p1*256 + p2 - 客户端主动向服务器返回的 IP + 端口发起连接,建立数据通道
- 数据传输完成后关闭
现代客户端默认使用被动模式,可兼容客户端位于 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
- 服务器管理器 → 添加角色和功能 → Web 服务器(IIS)→ FTP 服务器
- IIS 管理器 → 网站 → 添加 FTP 站点 → 选择物理路径、绑定 21
- 身份验证:启用基本(明文,建议搭配 SSL)或匿名
- 授权规则:配置允许的用户/角色、读写权限
- 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,或移除用户对根目录的写权限 |