FTP或FTPS能登录却列不出目录:排查数据连接
FTP登录成功,只说明控制连接能建立。列目录、上传和下载还需要单独的数据连接,所以“账号密码正确”并不能排除网络问题。本文的配置示例适用于Ubuntu 24.04上的独立vsftpd 3.0.5;其他FTP服务或面板托管配置不要直接照抄。SFTP属于另一种协议,请看SFTP上传与下载教程。
一、先看停在哪一步
在客户端选择与服务端一致的协议及被动模式,重新连接一次。显式FTPS通常先连接FTP控制端口再协商TLS;隐式FTPS使用另一种连接方式,不能只改端口就混用。实际端口以你的配置为准。
| 客户端现象 | 优先检查 |
|---|---|
| 登录后,列目录一直等待或报425 | 被动数据端口、返回地址及NAT映射。 |
| 出现550或明确的无权访问提示 | 账号目录、路径和权限;不要先把目录设为777。 |
| 控制连接成功,数据连接报TLS错误 | 证书、加密模式和客户端兼容性;不要关闭校验或改成明文传输来“修好”。 |
记录错误码及发生时间。共享日志前删掉密码、令牌和客户文件名。服务器可查看同一时间的服务记录:
sudo systemctl status vsftpd --no-pager
sudo journalctl -u vsftpd --since "10 minutes ago" --no-pager
二、给被动模式设置可核验的端口范围
确认当前服务确实读取/etc/vsftpd.conf,先备份该文件。不要对其他FTP软件修改这个路径,也不要直接在文件末尾反复追加同名选项。
sudo cp -a --backup=numbered /etc/vsftpd.conf /etc/vsftpd.conf.before-passive-change
上面的命令会将同名旧备份另存为编号版本,再保存本次配置;确认命令成功后才继续。打开配置文件,将已有同名项整理成唯一的一组,例如:
pasv_enable=YES
pasv_min_port=50000
pasv_max_port=50009
50000—50009只是一个小规模验证范围,并非适合所有并发量的固定值。安全组、系统防火墙都要允许相同的TCP范围;能固定客户端来源时只允许这些来源。控制端口继续保留,不要放行全部高位端口。
若服务器位于NAT后,控制端口和被动端口范围都需要正确映射。PASV返回了客户端无法访问的内网地址时,再设置pasv_address为实际对外IPv4。EPSV不返回这个地址字段,因此不能看到目录失败就认定一定是pasv_address错误。映射方法可对照NAT端口映射教程。
三、应用改动并验证实际传输
确认没有正在进行的传输后重启vsftpd,再检查状态。重启可能中断当前连接;若启动失败,查看日志并恢复本次备份,不要继续叠加修改。
sudo systemctl restart vsftpd
sudo systemctl status vsftpd --no-pager
显式FTPS也可在支持FTP及TLS的curl中进行一次列目录测试。替换测试账号和自己的域名;密码在提示时输入,不写到命令行:
curl --ssl-reqd --user testuser --list-only --connect-timeout 5 --max-time 20 ftp://ftp.example.test/
成功列目录后,用客户端上传一个无敏感内容的小文件,再下载并核对内容。能够登录、列目录、上传、下载,且TLS校验正常,才算这次操作通过。若端口已经可达但仍报550,转向检查账号目录权限,不要继续扩大防火墙范围。