宝塔面板FTP登录失败的排查与解决方法
| 宝塔FTP登录失败 | 用户在使用FTP客户端（如FileZilla）连接服务器时提示“登录失败”、“认证失败”或“连接超时”。 |
| FTP账号密码错误 | 输入的用户名或密码不正确，或忘记修改默认密码。 |
| 防火墙限制FTP端口 | 服务器防火墙或云服务商安全组未放行21端口（FTP控制端口）或被动模式端口范围。 |
| FTP连接异常 | 可能由于服务未运行、配置文件损坏、被动模式设置不当等引起。 |
| Pure-FTPd配置问题 | 宝塔默认使用Pure-FTPd服务，其配置文件异常可能导致无法正常登录。 |
常见原因及解决方案汇总表
| 异常类型 | 可能原因 | 解决方案 |
|---|---|---|
| 账号密码错误 | 密码输入错误、忘记密码或浏览器自动填充旧密码 | 在宝塔中重置FTP用户密码；清除浏览器缓存或更换设备测试 |
| FTP服务未运行 | Pure-FTPd服务崩溃或被手动停止 | 登录宝塔【软件商店】→ 启动或重启Pure-FTPd服务 |
| 防火墙/安全组限制 | 端口21未放行，或未开放被动模式端口范围 | 放行21端口和被动模式端口（如39000-40000） |
| 被动模式配置错误 | 客户端未启用被动模式或未设置数据端口范围 | 修改Pure-FTPd配置文件，设置PassivePortRange并重启服务 |
| IP访问限制 | 设置了IP白名单但不在允许列表中 | 修改Pure-FTPd配置文件，更新允许IP列表 |
| 权限不足或目录归属错误 | FTP用户无权访问指定目录 | 检查网站目录权限是否为755，所有者是否为对应FTP用户 |
| SSL/TLS加密连接失败 | 使用了加密连接但证书配置错误 | 在FTP客户端中尝试关闭加密选项或重新配置证书 |
| 多网卡/内网IP导致连接失败 | 多IP环境下Pure-FTPd返回内网IP导致连接失败 | 配置ForcePassiveIP参数为公网IP，避免NAT问题 |
更新时间：2025-06-04 22:32:28