小皮面板 ftp 支持中文

上周帮一个做外贸的小皮朋友调服务器，他用小皮面板（xp.cn）搭的面板 Windows 环境，FTP 上传产品图时卡住了——文件名全是持中中文，FileZilla 里显示一堆乱码，小皮传上去的面板图片在网页端打不开。这不是持中他一个人的问题。小皮面板默认的小皮 FTP 配置对中文支持并不友好，稍微不注意就会踩坑。面板

问题出在编码上。持中小皮面板集成的小皮 FTP 服务端通常是 vsftpd 或者 FileZilla Server（Windows 版），前者默认用 UTF-8，面板后者在 Windows 下默认走本地字符集 GBK。持中而客户端这边，小皮FileZilla 默认也是面板自动检测，但遇到纯中文文件名时经常判断失误。持中两边一错位，中文就变成了“锟斤拷”或者问号。我朋友那台服务器是 Windows Server 2019，小皮面板装的是 FileZilla Server 0.9.60，默认配置里 utf8_filesystem 是关掉的。这就是根因。

改法不复杂。打开小皮面板的 FTP 管理界面，找到“配置”或者直接编辑 FileZilla Server 的配置文件（通常在 %ProgramFiles%\FileZilla Server\FileZilla Server.xml）。把 <utf8_filesystem>0</utf8_filesystem> 改成 1，保存后重启 FTP 服务。这一步做完，服务端就按 UTF-8 处理文件名了。但别急，客户端也得同步。FileZilla 里进“站点管理器”，选中对应站点，在“字符集”标签页里把“自动检测”改成“强制 UTF-8”。两边都强制 UTF-8，中文文件名就不会再乱。

有人会问：那我用 WinSCP 或者 Windows 资源管理器直接连呢？WinSCP 默认也是自动，但它的自动逻辑比 FileZilla 靠谱一些，多数情况下能正确识别。资源管理器走的是 WebDAV 或者 SMB，跟 FTP 不是一回事，不在此讨论。如果你非要用资源管理器映射 FTP，那中文问题基本无解，建议换工具。

还有一个隐藏坑：小皮面板的 FTP 用户目录如果包含中文路径，比如 D:\网站\客户A，即使编码改对了，某些旧版 FileZilla Server 在解析路径时仍会出错。我实测过 0.9.60 版本，路径里有中文时，登录后列目录会超时。解决办法要么把用户根目录改成纯英文，要么升级到 FileZilla Server 1.x（但小皮面板默认不集成 1.x，需要手动替换）。权衡一下，改英文路径最省事。

另外提一句，Linux 下的小皮面板（其实叫“小皮面板 Linux 版”）用的是 vsftpd，默认 utf8_filesystem=YES 已经开了，反而没这个问题。所以中文 FTP 的坑主要集中在 Windows 环境。如果你用的是宝塔面板，情况类似，但宝塔的 FTP 插件默认会写 utf8_filesystem=1，比小皮省心一点。这不是踩一捧一，是实际配置差异。

最后给个检查清单：服务端 utf8_filesystem 设为 1；客户端强制 UTF-8；用户目录避免中文；重启服务后先用一个中文名文件测试上传和下载。别嫌麻烦，这三步做完，后面省心。我朋友改完到现在两周了，再没听过他抱怨乱码。

本文地址：http://www.79wt.cn/news/014d1199974.html