Linux 上 FileZilla 故障排查步骤
一 快速自检
- 核对站点参数：协议（优先选 SFTP - SSH File Transfer Protocol）、主机名/IP、端口（SFTP 默认 22，FTP 默认 21）、用户名、密码或密钥。错误的协议或端口是最常见的原因。
- 网络连通性：在终端执行 ping 目标主机，确认可达；必要时更换网络或排除本地/边界路由问题。
- 服务状态：服务器侧确认对应服务已运行（FTP 看 vsftpd/ProFTPD，SFTP 看 sshd）。
- 客户端版本：更新到 最新版本 FileZilla，避免已知兼容性与安全漏洞问题。
二 常见错误代码与处理
| 错误码 |
含义 |
处理要点 |
| 530 |
登录认证失败 |
检查用户名/密码；SFTP 确认使用密钥或密码正确；必要时重置密码 |
| 220 |
服务就绪（可能伴随空闲超时提示） |
属提示信息；如频繁断开，适当提高超时或保持会话活跃 |
| 421 |
来自此 IP 的连接过多 |
关闭多余连接；联系管理员放宽连接数限制 |
| 425 |
无法打开数据连接 |
多由防火墙/NAT 导致；切换 主动/被动模式；放行相关端口 |
| 426 |
连接关闭，传输中断 |
常见于服务器磁盘满或链路中断；检查服务器磁盘空间 |
| 450 |
请求的文件操作未执行 |
文件被占用或空间不足；释放空间或解除占用 |
| 550 |
权限被拒绝 |
检查服务器上目录与文件的读写/执行权限及属主 |
以上错误码与处置要点可快速定位认证、数据通道、配额与权限等高频问题。
三 协议与模式专项排查
- 优先使用 SFTP（基于 SSH，通常更可靠、穿透 NAT 更容易）：站点管理器选择 SFTP - SSH File Transfer Protocol，端口 22；若用密码登录失败，可在服务器检查 /etc/ssh/sshd_config 的 PasswordAuthentication yes 并重启 sshd。
- FTP 专项：
- 加密选择：若服务器不支持 SSL/TLS，改用普通 FTP（安全性较低）；若支持，在站点设置启用 FTP over TLS 并信任服务器证书。
- 模式切换：在“编辑-设置-传输-FTP”切换 主动/被动模式；被动模式需在服务器与防火墙开放一段端口范围（见下文防火墙设置）。
- 字符集：出现中文乱码时，在“编辑-设置-文件传输-文件名字符集”设为 UTF-8。
四 防火墙与端口配置
- 放行关键端口：
- SFTP：放行 22/TCP。
- FTP：放行 21/TCP（控制通道）；若用被动模式，还需放行服务器配置的被动端口范围（例如 50000-51000/TCP）。
- firewalld 示例：
- 放行 FTP 与 SSH：sudo firewall-cmd --permanent --add-service=ftp；sudo firewall-cmd --permanent --add-service=ssh；sudo firewall-cmd --reload
- 放行自定义被动端口范围（示例）：sudo firewall-cmd --permanent --add-port=50000-51000/tcp；sudo firewall-cmd --reload
- 服务器侧 FTP 服务：如使用 vsftpd，确认服务运行（sudo systemctl status vsftpd），并检查被动端口与 IP 配置。
五 日志定位与工具辅助
- 客户端日志：在 FileZilla 菜单“编辑-设置-日志”开启日志，日志文件通常位于安装目录，文件名类似 FileZilla_log.2025-12-10.txt；连接失败时根据日志中的错误码与阶段（连接/握手/登录/数据）快速定位。
- 服务器日志：
- SFTP/SSH：查看 /var/log/auth.log（Debian/Ubuntu）或 /var/log/secure（RHEL/CentOS）以定位认证与连接细节。
- FTP：查看 FTP 服务日志（如 vsftpd 日志）以判断被动端口、权限与配额问题。
- 其他：适当延长超时（编辑-设置-连接-超时时间），更新或重装客户端以排除版本问题。