Ubuntu FTP Server 多语言支持指南
总体思路
- 让系统具备多语言与正确的字符集（locale），推荐统一使用 UTF-8，这是跨语言最稳妥的方案。
- 在服务器端启用 FTP 服务对 UTF-8 的原生支持（如 vsftpd 的 utf8_filesystem=YES）。
- 在客户端选择与服务器一致的字符编码（优先 UTF-8），或按需设置服务器端的字符集转换（如 ProFTPD 的 UseEncoding）。
- 统一命名规范：文件名与目录名统一用 UTF-8 存储，避免混用 GBK/Big5 等遗留编码。
系统层面准备
- 安装中文语言包并生成 locale：
- 安装语言包：sudo apt install -y language-pack-zh-hans
- 生成中文 locale：sudo locale-gen zh_CN.UTF-8
- 配置默认 locale（两种方式二选一）：
- 交互式：sudo dpkg-reconfigure locales（勾选 zh_CN.UTF-8 并设为默认）
- 手动编辑：/etc/default/locale
- 仅支持中文显示（系统界面仍用英文）：LANG=zh_CN.UTF-8；LANGUAGE=en_US:en
- 全中文界面：LANG=zh_CN.UTF-8；LANGUAGE=zh_CN:zh
- 终端与 SSH 客户端需使用 UTF-8（如 PuTTY、Xshell、Windows Terminal、macOS Terminal 均设为 UTF-8）。
- 如需在服务器生成含中文的图片/PDF，可安装中文字体：sudo apt install -y fonts-wqy-zenhei fonts-wqy-microhei。
服务器端配置按软件
- vsftpd（最常见）
- 编辑：/etc/vsftpd.conf
- 关键项：启用 utf8_filesystem=YES（让内核/文件系统以 UTF-8 处理文件名）
- 可选：保持默认 ASCII 传输或按需开启 ascii_upload_enable/ascii_download_enable（多数场景不建议长期开启 ASCII）
- 重启：sudo systemctl restart vsftpd
- 说明：启用 SSL/TLS（FTPS）与多语言无冲突，可按需配置证书与端口。
- ProFTPD（需处理 GBK/Big5 等场景）
- 在 proftpd.conf 中使用字符集转换指令：
- 简体中文环境：UseEncoding UTF-8 GBK
- 繁体中文环境：UseEncoding UTF-8 Big5
- 若版本较旧或未包含该功能，需重新编译启用 NLS 后再使用 UseEncoding。
- Pure-FTPd
- 现代版本默认支持 UTF-8；如需兼容旧客户端，可在配置中设置客户端/本地编码映射（具体以手册为准）。
客户端与传输设置
- 统一使用 UTF-8 作为客户端字符集（优先方案）。
- 如必须与遗留系统兼容，按实际编码设置客户端或服务器的转换：
- lftp 示例（本地文件系统为 UTF-8，远端为 GBK）：
- 在 ~/.lftp/rc 写入：set ftp:charset GBK；set file:charset UTF-8
- gFTP（旧版）可在启动前设置环境变量：export LANG=zh_CN.GBK
- 浏览器/插件类客户端（如 FireFTP）可在高级选项中设置服务器编码。
- 验证方法：
- 在服务端创建含中文的文件/目录并列出：ls、stat
- 从客户端上传/下载后核对文件名是否一致、无“???”或“方块”。
常见问题与排查
- 中文显示为 ??? 或“方块”
- 检查：服务器 locale 是否为 zh_CN.UTF-8；客户端是否为 UTF-8；vsftpd 是否启用 utf8_filesystem=YES；必要时重启服务与终端会话。
- 客户端与服务器编码不一致
- 统一为 UTF-8；如不可控，使用 ProFTPD UseEncoding 或客户端侧字符集设置进行转换。
- 日志或脚本输出中文乱码
- 确认运行环境的 LANG/LC_CTYPE 为 zh_CN.UTF-8 或 en_US.UTF-8，并在 ~/.bashrc 或 /etc/default/locale 中正确导出。
- 服务器为纯文本环境是否需要中文字体
- 不需要。字体仅在生成图片/PDF/图形界面时用到；SSH 终端显示取决于客户端字体与编码设置。
