FileZilla Client 3.71.1 常用配置文档：站点管理器、传输设置、字符集与故障排查

这篇是 FileZilla Client 3.71.1（win64） 的常用配置速查文档，按实际使用顺序组织：先认识配置入口，再依次配置站点连接、传输行为、连接模式、字符集、SFTP 密钥与密码安全，最后是效率功能、命令行、配置迁移和故障排查。软件介绍与下载见 《FileZilla Client 3.71.1 中文介绍与使用教程：Windows 下免费开源的 FTP / FTPS / SFTP 客户端》。

一、配置入口地图

优先级要记住：站点管理器里「传输设置」「字符集」页签的配置只对该站点生效，会覆盖「编辑 → 设置」里的全局默认值。所以改了全局设置却没效果时，先看看这个站点是不是单独设过。

二、站点管理器：新建一个连接

菜单「文件 → 站点管理器」→「新站点」，常规页签要填这些字段：

1. 临时连接可以用顶部「快速连接」栏填主机 / 用户 / 密码 / 端口，点 Quickconnect；但长期使用的服务器建议一律建站点，方便保存字符集、传输模式等细项。
2. 「传输设置」页签里可单独限制该站点的并发连接数，或把传输模式从「默认」强制改为「被动」——很多列目录问题就在这一步解决。
3. 「字符集」页签可对单个站点指定编码，不影响其他站点。

三、传输设置与断点续传

「编辑 → 设置 → 传输」是调优的主战场：

断点续传：传一半断线后重新连接，把同一个文件再拖到目标目录，在「目标文件已存在」对话框里选「续传」，FileZilla 会从已传输的字节继续；可勾选「总是执行此操作」让后续同类情况自动处理。前提是服务器支持续传且文件未被改动。

四、连接模式：被动与主动（列目录失败的首要排查点）

官方 Wiki 的 Network Configuration 讲得很清楚：FTP 用两条连接，21 端口传命令，另一条数据连接传目录列表和文件内容。两种模式的区别在于数据连接谁主动发起：

1. 连上却读不出目录（常见报错 425 Can't open data connection / Failed to retrieve directory listing），先在站点管理器「传输设置」页签把传输模式从「默认」改为被动。
2. 被动模式下客户端本地防火墙要允许 FileZilla 发起到任意高端口的出站连接；官方建议干脆两种模式都配置好，因为部分服务器配置有误、只支持其中一种。
3. 确实需要主动模式时，在「编辑 → 设置 → 连接 → FTP」里填外部 IP（固定 IP 手填、动态 IP 可让程序自动获取），并指定一段本地端口（建议 50000 以上、至少 50 个，TCP 端口释放有延迟，范围太小会导致连续传小文件失败），再到防火墙 / 路由器放行并转发。
4. 首次配置可运行官方的网络配置向导，它会引导设置并做连通性测试。

官方 Wiki 还提醒一类隐蔽问题：杀毒软件或本机防火墙如果拦截某些随机出站端口，被动模式会偶发「cannot open data connection」——能连上、传几次才失败一次，这种要看安全软件日志。另外有些路由器会偷偷改写 PORT / PASV 命令里的地址，看似能用，一遇到加密或非常规端口就全盘失效。

五、字符集与中文乱码

官方 Wiki「Character Encoding」的说明值得先看一眼：最初的 FTP 规范（RFC 959）只允许 7 位 ASCII，1999 年的 RFC 2640 才把 UTF-8 引入为向后兼容的扩展。FileZilla 严格遵循规范、使用 UTF-8，不会为了迁就非标准编码去破坏协议；而不少老旧服务器擅自使用本地编码，客户端无法自动识别，于是出现中文文件名乱码甚至列不出目录。

1. 规范服务器会在 FEAT 响应里包含 UTF8；FileZilla 会自动使用该能力，一般无需手工干预。
2. 中文乱码时，在该站点的「字符集」页签把「自动」改为强制 UTF-8，断开重连再试。注意改的是站点级设置，别只改全局。
3. 只在对端确实是老旧中文系统时才用「自定义字符集」（如 GBK / GB2312），并且要和服务端保持一致；这只是权宜之计，官方更建议让服务端升级到支持 UTF-8 的软件。
4. SFTP 情况类似：SFTP 规范 v4 起要求 UTF-8，但最常用的 v3（OpenSSH 实现）未强制，实践中基本都按 UTF-8 处理。

关于 OPTS UTF-8 ON：网上有些教程让用户手工发这条命令，其实它来自一份早已过期、且与 RFC 2640 冲突的草案；合规客户端无论该命令是否成功都会使用 UTF-8。别把它当万能解法。

六、SFTP 密钥登录与兼容性

• 站点管理器里「登录类型」选密钥文件并指定私钥；Windows 下常见 .ppk，必要时可用 PuTTYgen 在格式间转换。私钥文件本身要设好权限，别随手放进共享目录。
• 3.70.5 起站点管理器新增 SFTP compatibility flags 页签，用来兼容有怪癖的 SSH 服务端，遇到 SFTP 认证或目录列表异常可以来这里排查。
• 3.71.0 起 SFTP 组件升级到 fzssh 1.4.0，支持更多算法与密钥文件格式；老版本若遇到「不支持的密钥格式」，升级客户端往往比折腾密钥格式更省事。
• 3.71.1 改进了服务端不提供 password 认证方式时，keyboard-interactive 请求被当作普通密码提示的判断逻辑，对某些双因素 / 交互认证服务器有帮助。

七、密码安全、配置备份与迁移（务必看）

「编辑 → 设置 → 界面 → 密码」里有三种保存方式，安全性差别很大：

主密码丢失无法找回，官方也不提供恢复途径，务必记牢。登录类型选「询问密码」的站点不会把密码写进配置文件。另外「文件 → 导出」生成的 XML 会原样带上已保存的密码，导出的文件别放共享盘、别发邮件、别上传网盘，用完及时删除；官方 Trac 上就有专门说明这一点的工单。

配置文件位置与迁移方式：

• Windows：%APPDATA%\FileZilla；Linux / macOS：~/.config/filezilla。主要文件有 sitemanager.xml（站点）、filezilla.xml（设置）、filters.xml（过滤器）、queue.sqlite3（队列）、recentservers.xml（最近连接）。
• 正规迁移路径：「文件 → 导出」勾选站点管理器条目 / 设置 / 队列 / 过滤器，保存为 XML，再在目标机器用「文件 → 导入」恢复；若启用了主密码，目标机器也需要同样的主密码。
• 也可以退出程序后直接整个复制配置目录，但要注意配置不在安装目录里——只拷 Program Files 下的程序文件，站点列表一定丢失。
• 程序打不开、疑似配置损坏时，官方 FAQ 建议先重装（不会动配置）；仍不行才删除配置目录，删除前先备份，否则站点与设置全部丢失。

八、效率功能与命令行

官方支持的命令行参数（可用来做快捷方式或简单脚本）：

filezilla -s                          # 启动时打开站点管理器
filezilla -c "0/foo/bar/Backup server"   # 直接连接站点管理器里的指定站点
filezilla ftp://user@host/path --local="D:\work"   # 用 URL 连接并指定本地目录
filezilla --logontype=ask ftp://host # 连接时询问未提供的登录信息
filezilla -v                          # 输出版本信息后退出
filezilla --close                     # 关闭所有正在运行的实例（仅 Windows）

URL 形式支持 ftp://（默认）、ftps://、ftpes://、sftp://；-c 的站点路径要用完整路径，段内的斜杠需要转义。注意免费版不含命令行批处理（FileZilla Pro CLI 才有），这里的参数只用于启动与跳转。

九、常见故障排查表

十、日常配置检查清单

1. 常用服务器都建在站点管理器里，按用途命名，生产环境设了醒目的背景色。
2. 每个站点协议、端口、加密方式与登录类型都核对过，公用电脑不保存明文密码。
3. 自己专用电脑启用了主密码保护，且主密码已妥善记住。
4. 被动模式可用，中文文件名显示正常，大文件超时设置合理。
5. 已配置好文件名过滤器，误传无关目录的风险可控。
6. 做过一次「文件 → 导出」备份，导出的 XML 存放在私有位置。

小结

FileZilla Client 的配置可以归纳成四件事：站点怎么连（站点管理器）、文件怎么传（传输设置与被动模式）、名字怎么显示（UTF-8 字符集）、密码怎么存（主密码与导出安全）。前两件决定能不能用，第三件决定中文文件名是否正常，第四件决定账号会不会漏。把这四处按本文配好，绝大多数「连得上却传不了」的问题都能解决。

参考与下载：官方下载页（3.71.1）｜官方版本历史｜官方 Wiki：Network Configuration｜官方 Wiki：Character Encoding｜官方 Wiki：命令行参数｜官方 FAQ。安装包与网盘镜像见本站介绍篇。