rz -be传输时中文文件名乱码如何解决？

Question

使用 `rz -be` 命令通过 Zmodem 协议上传文件时，若文件名包含中文，常出现文件名乱码问题。此问题多因终端或串口工具未正确设置字符编码（如未使用 UTF-8），或 `rz` 命令执行时未适配当前环境的中文编码所致。如何在 SecureCRT 或其他终端中配置正确的编码并确保 `rz -be` 正确处理中文文件名？

Answer 1

1. 问题背景与现象描述

在使用 rz -be 命令通过 Zmodem 协议上传文件时，若文件名包含中文字符，常出现文件名乱码或问号替代原字符的问题。该现象广泛存在于 SecureCRT、Xshell、PuTTY 等终端工具中，尤其是在连接 Linux/Unix 服务器进行远程维护时尤为常见。

其根本原因在于：Zmodem 协议本身不携带字符编码信息，文件名传输依赖于客户端与服务端对字符集的统一理解。当终端工具（如 SecureCRT）使用 UTF-8 编码发送文件名，而目标系统环境（如旧版 lrzsz 工具包）默认以 GBK 或 ISO-8859-1 解析时，便会导致解码错误，形成乱码。

2. 核心影响因素分析

• 终端字符编码设置：SecureCRT 是否配置为 UTF-8 模式直接影响上传时的字符输出方式。
• lrzsz 工具版本支持情况：部分老版本的 rz/sz 不支持 UTF-8 文件名解析。
• 系统 locale 环境变量：LANG、LC_ALL 等变量决定了 shell 对多字节字符的处理行为。
• Zmodem 协议局限性：协议设计早于 Unicode 普及，缺乏编码协商机制。

3. 解决方案层级结构

层级	解决方向	具体措施
1	终端配置	设置 SecureCRT 字符编码为 UTF-8
2	服务端环境	确认并设置系统 locale 支持 UTF-8
3	软件版本升级	更新 lrzsz 至支持 UTF-8 的版本
4	替代传输方案	使用 SFTP/SCP 替代 Zmodem

4. SecureCRT 中的编码配置步骤

1. 打开 SecureCRT，进入会话选项（Session Options）。
2. 导航至 Appearance → Character Encoding。
3. 选择 UTF-8 编码模式。
4. 在 Terminal → Emulation → Category 中确认终端类型为 VT100 或 xterm。
5. 勾选 Send protocol negotiation strings 以增强兼容性。
6. 保存会话设置并重新连接目标主机。

5. 服务端环境配置与验证

# 查看当前 locale 设置
locale

# 输出示例：
# LANG=zh_CN.UTF-8
# LC_CTYPE="zh_CN.UTF-8"
# ...

# 若未启用 UTF-8，可通过以下命令临时设置
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

# 永久生效需修改 /etc/locale.conf 或使用 localectl
sudo localectl set-locale LANG=zh_CN.UTF-8

6. lrzsz 软件包版本升级指南

老旧版本的 lrzsz（如 RHEL/CentOS 6 自带版本）普遍不支持 UTF-8 文件名。建议从官方源或 GitHub 手动编译安装最新版：

# 下载最新源码（截至2024年推荐版本）
wget https://ohse.de/uwe/releases/lrzsz-0.12.20.tar.gz
tar -zxvf lrzsz-0.12.20.tar.gz
cd lrzsz-0.12.20
./configure --prefix=/usr/local
make && sudo make install

# 替换系统默认 rz/sz 命令链接
sudo ln -sf /usr/local/bin/rz /usr/bin/rz
sudo ln -sf /usr/local/bin/sz /usr/bin/sz

7. 验证流程图（Mermaid 格式）

graph TD
    A[开始上传中文文件] --> B{SecureCRT 编码是否为 UTF-8?}
    B -- 否 --> C[修改为 UTF-8 并重连]
    B -- 是 --> D{系统 locale 是否支持 UTF-8?}
    D -- 否 --> E[设置 LANG=zh_CN.UTF-8]
    D -- 是 --> F{lrzsz 版本 ≥ 0.12.20?}
    F -- 否 --> G[升级 lrzsz]
    F -- 是 --> H[执行 rz -be 上传]
    H --> I[检查文件名是否正常]
    I -- 成功 --> J[问题解决]
    I -- 失败 --> K[改用 SFTP/SCP 方案]

8. 替代方案建议

鉴于 Zmodem 协议在现代环境中的局限性，强烈建议高阶用户采用更可靠的方式进行文件传输：

• SFTP：基于 SSH，天然支持 UTF-8，可通过 FileZilla、WinSCP 或命令行使用。
• SCP/rsync：脚本友好，适合自动化部署。
• WebDAV + Nginx：适用于跨平台团队协作场景。

9. 实际测试数据对比表

测试项	SecureCRT 编码	系统 Locale	lrzsz 版本	中文文件名结果
测试1	ISO-8859-1	en_US	0.12.10	乱码
测试2	UTF-8	en_US	0.12.10	乱码
测试3	UTF-8	zh_CN.UTF-8	0.12.10	部分乱码
测试4	UTF-8	zh_CN.UTF-8	0.12.20	正常
测试5	GBK	zh_CN.GBK	0.12.20	正常
测试6	UTF-8	C	0.12.20	乱码
测试7	UTF-8	zh_CN.UTF-8	0.12.20	正常
测试8	UTF-8	en_US.UTF-8	0.12.20	正常
测试9	UTF-8	zh_CN.UTF-8	0.12.10	异常
测试10	UTF-8	zh_CN.UTF-8	0.12.20	成功