"FTP 能登录,但目录列不出来"是 FTP 使用中最经典的一类故障。输账号密码都通过了,眼看就要连上,结果卡在列目录那一步,或者报一个 425 Can't open data connection、无法建立数据连接。新手常常以为是账号权限问题,反复改目录权限,白忙一场。实际上这类问题的根源几乎都在 FTP 的"双连接"机制上——命令连接成功了,但第二条数据连接没建起来。
这篇专门讲清楚这个机制导致的各种列目录失败:先解释 FTP 为什么有两条连接、主动模式和被动模式到底谁连谁,再给出 vsftpd 的配置方法、防火墙和云安全组的正确放行方式、NAT 环境下的处理,最后附一张错误码对照表和完整排查流程。命令区分 RHEL/CentOS/Rocky 与 Debian/Ubuntu。
理解"数据连接的方向"是解开这个问题的钥匙。把这一个点想通,后面所有现象都能解释。下面从原理讲起。
一、FTP 为什么要两条连接
FTP 协议诞生得早,设计上把"控制"和"数据"分开:控制连接传命令(登录、切换目录、列目录、取文件),数据连接专门传目录列表和文件内容。控制连接始终保持,数据连接在每次需要传数据时临时建立。
问题的关键就在这里:数据连接由谁发起、连到哪个端口,取决于使用主动还是被动模式。这两种模式方向相反,防火墙和 NAT 的处理方式也完全相反。列目录失败,十有八九是数据连接的方向被防火墙挡了。
| 连接类型 | 默认端口 | 传什么 | 生命周期 |
|---|---|---|---|
| 控制连接 | 21 | 命令与响应 | 整个会话保持 |
| 数据连接(主动模式) | 服务器 20 → 客户端随机端口 | 目录列表、文件 | 每次传输临时建立 |
| 数据连接(被动模式) | 服务器随机高端口 → 客户端 | 目录列表、文件 | 每次传输临时建立 |
二、主动模式与被动模式:谁连谁
这是全文最核心的一节,务必理清。
主动模式(Active / PORT):客户端通过控制连接告诉服务器"我在某个 IP 的某个端口等你",然后服务器主动发起到客户端那个端口的数据连接。方向是"服务器 → 客户端"。
问题在于:客户端通常在防火墙或 NAT 后面,服务器从外部主动连客户端的随机端口,会被客户端侧的防火墙直接挡掉。所以主动模式在现代网络环境下基本不可用。
被动模式(Passive / PASV):客户端发一个 PASV 命令,服务器回一个 IP 和端口,告诉客户端"你来连我这个端口",然后客户端发起到服务器的数据连接。方向是"客户端 → 服务器"。
被动模式对客户端友好,因为客户端发出的连接通常能通过自己的防火墙。但对服务器有要求:服务器必须开放一段用于被动数据连接的端口范围,并在防火墙、云安全组、以及 NAT 映射里全部放行,否则客户端连不上,就会卡在列目录。
一句话记忆:主动模式是服务器连客户端,被动模式是客户端连服务器。 现代客户端默认都用被动模式,所以排查重点几乎都在服务器的被动端口放行上。
三、症状与根因对照
先把常见症状和根因对上号,再动手。
| 症状/错误 | 含义 | 根因方向 |
|---|---|---|
425 Can't open data connection |
数据连接建不起来 | 被动端口未放行 |
| 列目录一直卡住后超时 | 数据连接被丢弃 | 防火墙 DROP,NAT 映射缺失 |
229 Entering Extended Passive Mode 后无下文 |
服务器给了端口但客户端连不上 | 被动端口范围/公网 IP 配置错 |
500 Illegal PORT command |
服务器不允许主动模式 | 需切到被动模式 |
| 小文件能传、大文件卡 | 数据连接被中途重置 | MTU 或中间设备问题 |
| 能列目录但下载报错 | 类似,数据连接方向问题 | 同被动模式排查 |
如果客户端报 425,先把客户端切到被动模式试一次;如果本来就在被动模式,那就是服务器侧端口没放行。
四、配置 vsftpd 的被动模式
以 vsftpd 为例,配置文件在 RHEL 系是 /etc/vsftpd/vsftpd.conf,Debian/Ubuntu 是 /etc/vsftpd.conf。下面列出与数据连接相关的关键项。
# 被动模式相关配置
pasv_enable=YES
# 指定被动模式使用的端口范围(务必在防火墙同步放行)
pasv_min_port=30000
pasv_max_port=30100
# 关键:服务器在 NAT 后面时,必须告诉客户端正确的公网 IP
# 否则客户端会拿到内网 IP 去连,必然失败
pasv_address=203.0.113.10
# 主动模式相关(一般保持开启即可,主要使用被动模式)
port_enable=YES
# 若服务器不允许主动模式,可关闭
# port_enable=NO
改完重启服务并检查监听:
systemctl restart vsftpd
systemctl enable vsftpd
# 看到 21 端口监听
ss -lntp | grep ':21'
被动端口范围不要开得太大,经验上 100 个端口足够中小规模使用;但并发传输很多时可适当放大,比如 1000 个。范围越大,防火墙配置越麻烦,也更容易被滥用,够用即可。
五、防火墙与云安全组的正确放行
这是最容易漏的一环:系统防火墙和云安全组是两层,必须都放行。很多人只改了服务器里的 firewalld,结果云控制台安全组没放行被动端口,照样列不出目录。
# RHEL/CentOS/Rocky:放行 21 和被动端口范围
# 先记录原规则便于回滚
firewall-cmd --list-all > /root/fw.bak
firewall-cmd --permanent --add-port=21/tcp
firewall-cmd --permanent --add-port=30000-30100/tcp
firewall-cmd --reload
# Debian/Ubuntu:ufw 需要按端口范围放行
ufw allow 21/tcp
ufw allow 30000:30100/tcp
ufw status verbose
然后在云控制台的安全组/防火墙里,把同样的 21 端口和 30000-30100 端口范围放行到该实例。两层都通了,数据连接才能建立。
# 验证被动端口是否可达(从客户端侧机器执行)
nc -zv -w 5 203.0.113.10 21
nc -zv -w 5 203.0.113.10 30000
风险提示:开放端口范围会扩大攻击面,尤其 FTP 明文传输,建议:尽量限制来源 IP(安全组或防火墙的 source 只放行合作方出口 IP);能上 FTPS 就上 FTPS;条件允许时优先改造成 SFTP,从根本上绕开双连接问题。回滚方式:保留修改前的规则备份(firewall-cmd --list-all 输出、ufw status 输出),出问题时按备份恢复并 reload。
六、NAT 环境下的特殊处理
如果服务器本身在 NAT 后面(比如内网机器通过网关做端口映射对外提供服务),被动模式还有额外坑:服务器默认会把自己网卡的 IP(内网地址)通过 PASV 响应告诉客户端,客户端拿这个内网 IP 根本连不上。
解决办法就是前面配置里的 pasv_address,显式指定公网 IP:
pasv_address=203.0.113.10
pasv_addr_resolve=NO
同时,NAT 网关/防火墙上的端口映射要把被动端口范围一起映射出去,只映射 21 是不够的。经验上,映射 21 加上整段被动端口,例如 30000-30100,与服务器配置范围保持一致。
如果无法开放大范围端口映射,另一种思路是限制被动端口范围到一两个端口(如只开 30000),牺牲并发能力换取简单的 NAT 配置,适合低并发场景。
七、完整排查流程
按顺序来,每一步拿到证据再往下走。
# 1. 客户端先用被动模式连接(绝大多数客户端默认即是)
# 若客户端在主动模式,先切到被动模式重试
# 2. 确认服务在监听、被动端口范围已配置
grep -E 'pasv|port_enable' /etc/vsftpd/vsftpd.conf
ss -lntp | grep -E ':21|:3000'
# 3. 从客户端侧测被动端口可达性
nc -zv -w 5 <服务器IP> 30000
# 4. 用 ftp/lftp 命令行观察 PASV 响应里返回的 IP 和端口
ftp <服务器IP>
# 登录后输入 passive 或直接 dir,观察返回的 227/229 行里的 IP
# 227 Entering Passive Mode (203,0,113,10,117,48)
# 括号里前四段是 IP,后两段高位*256+低位 就是端口:
# 117*256+48 = 30000
# 5. 若返回的 IP 是内网地址,说明 pasv_address 未设置
# 6. 查看 vsftpd 日志
tail -n 50 /var/log/vsftpd.log # 若开启了日志
journalctl -u vsftpd -n 50 --no-pager
判读要点:如果 nc 测被动端口不通,问题在防火墙或安全组;如果 PASV 响应里的 IP 是内网地址,问题在 pasv_address 或 NAT 映射;如果都正常但仍旧卡住,检查中间是否有设备做了深度包检测或连接跟踪超时。
八、性能与容量参考
被动模式的端口范围和并发强相关,以下是经验值:
- 每个数据传输(列目录、传文件)占用一个被动端口,端口数决定同时进行的传输数上限。
- 中小规模应用,20-100 个被动端口通常够用;高并发场景需要放大到数百甚至上千。
- FTP 明文传输且单连接速度受限于延迟窗口,跨公网传大文件时速度往往不如 SFTP 或 rsync。
- 小文件极多的场景,FTP 反复建数据连接的开销明显,传输效率低,建议打包成归档再传。
- 被动端口范围越大,被扫描和滥用的风险越高,安全组上尽量配合来源 IP 白名单。
常见问题
Q:FTP 能登录、能执行命令,但 dir 一直卡住,为什么?
这是数据连接没建起来。客户端处于被动模式时,说明服务器的被动端口范围没在防火墙或安全组放行;客户端处于主动模式时,说明客户端在 NAT/防火墙后面,服务器连不进去。先把客户端切到被动模式,再放行服务器的被动端口。
Q:425 Can't open data connection 到底怎么修?
先确认 vsftpd 配置了 pasv_min_port/pasv_max_port,再确认这段端口在系统防火墙和云安全组都放行了。如果服务器在 NAT 后面,还要设置 pasv_address 为公网 IP,并在网关上映射整段被动端口。
Q:只放行了 21 端口,为什么列目录不行?
因为目录列表和数据传输走的是第二条数据连接,端口不是 21,而是被动模式下服务器指定的高端口。只开 21 只能建立控制连接,数据连接会被挡,表现就是能登录、列不出目录。
Q:PASV 返回的 IP 是 192.168.x.x 这种内网地址,怎么办?
说明服务器在 NAT 后面,却把自己的内网 IP 告诉了客户端。设置 pasv_address 为公网 IP 即可解决。这是内网 FTP 服务对外提供时的典型问题。
Q:换了被动端口范围后客户端连不上,怎么回滚?
把 pasv_min_port/pasv_max_port 改回原来的范围并重启 vsftpd,同时撤掉新范围在防火墙和安全组里的放行规则。改动前记录原范围和原规则,出问题按记录恢复,比现场猜要快。
总结
"FTP 能登录但列不出目录"几乎都是数据连接的问题,不是账号权限问题,别一上来就改目录权限。
数据连接的方向是核心:主动模式服务器连客户端(现代网络下基本不可用),被动模式客户端连服务器(默认且推荐),排查重点在服务器被动端口是否放行。
被动模式的三件事必须全部做对:配置 pasv_min_port/pasv_max_port、在系统防火墙与云安全组放行整段端口、NAT 环境下设置 pasv_address 为公网 IP 并映射端口范围。
系统防火墙和云安全组是两层,只改一层不行;排查时用 nc 测被动端口可达性,看 PASV 响应里的 IP 是否为公网地址,两个证据基本能定位问题。
FTP 双连接天生对防火墙不友好,长期方案是迁到 SFTP:单端口、加密、天然穿透 NAT;改端口、改防火墙前先备份规则,留好回滚路径。
企业QQ咨询




