vsFTP故障排除：常见问题及解决方案

1. 无法连接到FTP服务器

问题描述：客户端无法连接至vsFTP服务器，提示“连接超时”或“拒绝连接”。
可能原因：

vsFTP服务未启动；
防火墙阻止了FTP端口（默认21）或被动模式（PASV）端口范围；
配置文件（/etc/vsftpd.conf）中listen参数未设置为YES。
解决方案：
检查服务状态：使用systemctl status vsftpd确认服务是否运行，未运行则用systemctl start vsftpd启动，并通过systemctl enable vsftpd设置开机自启；
配置防火墙：若使用firewalld，执行firewall-cmd --add-service=ftp --permanent并firewall-cmd --reload；若使用iptables，添加规则iptables -A INPUT -p tcp --dport 21 -j ACCEPT；
验证配置文件：检查/etc/vsftpd.conf中listen=YES（IPv4）或listen_ipv6=YES（IPv6）是否启用，修改后重启服务systemctl restart vsftpd。

问题描述：用户输入正确用户名密码后，提示“登录失败”或“认证错误”。
可能原因：

问题描述：用户可登录但无法上传文件（提示“权限拒绝”）或下载文件（提示“无法读取”）。
可能原因：

用户对目标目录无写权限（上传问题）；
目标目录权限过严（如700），导致无法读取（下载问题）；
SELinux限制了FTP访问（常见于CentOS/RHEL系统）。
解决方案：
调整目录权限：使用chmod命令设置用户主目录权限为755（chmod 755 /home/username），上传目录设置为775（chmod 775 /home/username/upload）；
修改目录所有权：使用chown命令将用户主目录所有权赋予该用户（chown username:username /home/username）；
调整SELinux策略：若SELinux处于Enforcing模式，执行setsebool -P ftpd_disable_trans 1临时关闭SELinux对FTP的限制，或通过semanage fcontext -a -t public_content_rw_t "/path/to/directory(/.*)?"设置正确上下文并restorecon -Rv /path/to/directory应用。

问题描述：主动模式（PORT）下客户端可连接但无法传输数据，或被动模式（PASV）下客户端提示“无法连接数据端口”。
可能原因：

主动模式下，服务器防火墙未开放数据端口（默认20）；
被动模式下，服务器防火墙未开放pasv_min_port至pasv_max_port范围（默认范围为30000-31000）；
客户端网络限制（如企业防火墙禁止PASV端口）。
解决方案：
主动模式配置：确保防火墙开放TCP 20端口（firewall-cmd --add-port=20/tcp --permanent）；
被动模式配置：编辑/etc/vsftpd.conf，设置pasv_enable=YES、pasv_min_port=30000、pasv_max_port=31000，并开放该端口范围（firewall-cmd --add-port=30000-31000/tcp --permanent）；
客户端设置：若客户端位于NAT后，需在vsftpd.conf中设置pasv_address=服务器公网IP。

问题描述：服务器日志（/var/log/vsftpd.log）显示“500 OOPS: cannot change directory”或类似错误。
可能原因：

SELinux处于Enforcing模式，阻止了FTP用户切换目录或访问文件；
目标目录的SELinux上下文不正确（如应为public_content_rw_t但实际为user_home_t）。
解决方案：
临时关闭SELinux：执行setenforce 0（重启后失效）；
永久关闭SELinux：编辑/etc/selinux/config，将SELINUX=enforcing改为SELINUX=permissive，并重启服务器；
调整SELinux上下文：使用chcon -Rv --type=public_content_rw_t /path/to/directory设置正确上下文，或通过semanage fcontext永久修改。

问题描述：vsFTP服务无法启动（systemctl start vsftpd失败），或启动后功能异常（如无法登录、无法上传）。
可能原因：

配置文件中存在语法错误（如多余空格、拼写错误）；
关键参数设置冲突（如chroot_local_user=YES与allow_writeable_chroot=NO同时启用）。
解决方案：
检查配置文件语法：使用vsftpd -t命令测试配置文件，若有错误会提示具体行号；
修正关键参数冲突：若启用chroot_local_user=YES（限制用户至主目录），需添加allow_writeable_chroot=YES（允许主目录可写），避免“500 OOPS”错误；
备份并重置配置：备份原配置文件（cp /etc/vsftpd.conf /etc/vsftpd.conf.bak），然后恢复默认配置（cp /usr/share/doc/vsftpd/vsftpd.conf /etc/vsftpd.conf），再根据需求修改。

问题描述：故障现象不明确，无法快速定位原因。
解决方案：

查看vsFTP专用日志：默认路径为/var/log/vsftpd.log（部分系统可能在/var/log/xferlog），使用tail -f /var/log/vsftpd.log实时查看连接和操作日志；
查看系统认证日志：若登录失败，检查/var/log/secure（CentOS/RHEL）或/var/log/auth.log（Ubuntu/Debian），寻找认证相关的错误信息（如“invalid password”）；
启用详细日志：在vsftpd.conf中设置xferlog_enable=YES（启用传输日志）和log_ftp_protocol=YES（记录详细协议信息），重启服务后获取更全面的日志数据。