Debian如何排查vsftp连接问题

Debian 上排查 vsftpd 连接问题的系统化步骤

一 服务与基础连通性检查

• 确认服务已安装并运行，设置开机自启：sudo systemctl status vsftpd；如未运行执行 sudo systemctl start vsftpd；启用开机自启 sudo systemctl enable vsftpd。若未安装：sudo apt-get update && sudo apt-get install vsftpd。
• 监听与地址：检查 vsftpd 是否在 IPv4/IPv6 上监听。常见配置为 listen=YES、listen_ipv6=NO（仅 IPv4）；若仅启用 IPv6，确保客户端与网络均支持。
• 连通性快速测试：
  • 端口连通：nc -vz 服务器IP 21 或 telnet 服务器IP 21；
  • 本机监听：ss -ltnp | grep :21 或 netstat -tulpen | grep :21；
  • 路由与云安全组：确认云厂商安全组/本机防火墙放行 TCP 21 及被动端口范围。

二 配置与权限核查

• 核心配置项（/etc/vsftpd/vsftpd.conf）建议逐项核对：
  • 匿名/本地：anonymous_enable=NO；local_enable=YES；
  • 写入与目录限制：write_enable=YES；chroot_local_user=YES；
  • 认证与 PAM：pam_service_name=vsftpd；
  • 被动模式（推荐）：pasv_enable=YES；pasv_min_port=10090；pasv_max_port=10100（示例范围，需与防火墙一致）；
  • IPv6：listen=YES；listen_ipv6=NO（仅 IPv4 场景）。
• 用户访问控制：
  • /etc/ftpusers 为“禁止登录”名单（如 root 常被列入）；
  • 启用白名单时：userlist_enable=YES；userlist_file=/etc/vsftpd.userlist；userlist_deny=NO（仅列表内用户可登录）。
• 目录与权限：
  • 用户家目录存在且权限正确，例如：chown ftpuser:ftpuser /home/ftpuser；chmod 755 /home/ftpuser；
  • 日志目录可写：mkdir -p /var/log/vsftpd；chown vsftpd:vsftpd /var/log/vsftpd；chmod 755 /var/log/vsftpd。
• 修改配置后重启：sudo systemctl restart vsftpd。

三 防火墙与被动模式端口放行

• UFW：sudo ufw allow 21/tcp；如启用被动端口范围，还需放行示例端口段：sudo ufw allow 10090:10100/tcp。
• firewalld：sudo firewall-cmd --permanent --add-service=ftp；sudo firewall-cmd --reload（如需显式端口段：–add-port=10090-10100/tcp）。
• iptables：sudo iptables -A INPUT -p tcp --dport 21 -j ACCEPT；sudo iptables -A INPUT -p tcp --dport 10090:10100 -j ACCEPT。
• 云服务器：在控制台安全组放行 TCP 21 与所选的被动端口范围。

四 日志定位与常见错误

• 关键日志：
  • 服务日志：tail -f /var/log/vsftpd.log；
  • 传输日志：/var/log/xferlog；
  • 系统日志：journalctl -u vsftpd -f 或 tail -f /var/log/syslog。
• 常见报错对照与处理：