vsftpd 启动失败或用户无法登录、传文件、查看目录，主因是 selinux 限制、防火墙未放行被动端口、ftpusers 黑名单拦截及 umask 配置不当，需依次检查配置语法、pam 设置、setsebool -p ftp_home_dir on、pasv_min/max_port 与 firewall-cmd 放行、user_list/ftpusers 文件内容及 local_umask/file_open_mode 参数。
vsftpd 能跑起来，但用户连不上、传不了文件、登录后看不到目录——问题八成出在 SELinux、防火墙或用户权限配置上，不是安装没成功。
vsftpd 安装后启动失败：检查 systemd 状态和配置语法
安装完 vsftpd 后直接 systemctl start vsftpd 报错，别急着重装。先看真实原因：
- 运行
systemctl status vsftpd，重点看最后一行的 “Failed with result” 提示（比如exit-code或timeout） - 常见是配置文件有语法错误：执行
vsftpd /etc/vsftpd/vsftpd.conf（不加参数），它会立即校验并报错具体哪一行 - 默认配置里
listen=NO且listen_ipv6=YES，如果系统没启用 IPv6，会导致启动卡住；改成listen=YES并注释掉listen_ipv6行更稳妥
匿名用户能连，本地用户登录失败：检查 PAM 和 userlist 设置
很多教程照抄 local_enable=YES 就以为完事了，实际本地用户登录常被两个机制拦住：
-
/etc/vsftpd/user_list和/etc/vsftpd/ftpusers是黑名单（默认都启用）。只要用户名出现在任一文件里，就拒绝登录。删掉或注释掉对应行即可 - SELinux 默认禁止 FTP 访问用户家目录：
setsebool -P ftp_home_dir on必须执行，否则登录后ls返回空或“550 Permission denied” - 确保用户家目录权限合理（如
chmod 755 /home/username），且vsftpd.conf中未设置chroot_local_user=YES却没配allow_writeable_chroot=YES（后者从 vsftpd 3.0.3 开始强制要求）
FTP 连接超时或被动模式失败：调整防火墙和 pasv_* 参数
客户端能登录但列目录卡住、上传中断，基本是被动模式（PASV）端口没放行：
- vsftpd 默认用随机高端口（1024–65535），必须限定范围并在防火墙开放：在
vsftpd.conf加两行：pasv_min_port=40000pasv_max_port=40100 - firewalld 放行端口段：
firewall-cmd --permanent --add-port=40000-40100/tcp，再firewall-cmd --reload - 如果服务器在 NAT 后（如云主机），还需设
pasv_address=你的公网IP，否则客户端收到的是内网地址，连不上
上传文件后属主变成 root 或权限异常：理解 vsftpd 的 umask 行为
用户上传的文件属主是 root、权限是 600，不是预期的本人和 644，这是因为 vsftpd 默认以 root 启动，上传时用的是服务进程的 umask（通常是 077）：
- 改
vsftpd.conf：file_open_mode=0644（控制新建文件权限）local_umask=022（控制上传后文件的权限掩码） - 注意：
local_umask值不是最终权限，而是“去掉哪些位”，022 → 文件得 644，目录得 755；若要上传即 644，别设成 002 - 重启服务前，用
ps aux | grep vsftpd确认只有主进程（无残留子进程），避免配置未生效
真正卡住人的从来不是“怎么装”，而是 ftpusers 黑名单、SELinux 布尔值、被动端口段和 umask 的组合效果——四个地方任意一个漏掉，FTP 就表现得像“半瘫痪”。
