Skip to content

在 iOS 和 macOS 上使用 ZMODEM 传输文件:rz 上传、sz 下载与 CRC 校验(NeoServer)

在 NeoServer 的 SSH 终端里用 rz 和 sz 传输文件。了解 iOS 与 macOS 的支持范围、上传和下载步骤、CRC 校验以及传输限制。

4 分钟阅读NeoServer

已经进入到远程目录,想上传一个配置文件,或者把日志取回本机?NeoServer 内置的 ZMODEM 实现让你直接在 SSH 终端里传输文件:运行 rz 上传,或 sz 下载。传输面板会负责文件选择、进度、接收确认和取消。

iOS 与 macOS 的支持情况

下文的流程基于 NeoServer 的 iOS 终端,包括 macOS 上运行的 iOS 版应用。单独的原生 macOS 终端在当前实现中还没有集成这套 ZMODEM 功能。在 Mac 上使用前,请先确认自己用的是哪个版本。

这里的内置 ZMODEM 指传输协议直接用 Swift 实现,包括帧封装、CRC 校验和重传,不需要浏览器扩展或 JavaScript 传输桥。

准备远程服务器

使用 SSH 终端连接,并确认远程机器上提供 rz 和 sz。lrzsz 项目提供了这些传输协议的命令行实现。在远程 shell 里检查命令是否存在:

command -v rz
command -v sz

如果缺少任何一个命令,请安装服务器发行版对应的 lrzsz 软件包,或请服务器管理员提供。NeoServer 只负责客户端一侧;远程机器仍需有对应的发送端或接收端。

请先使用直接的 SSH shell。Mosh 连接不会传递这套集成所需的原始终端字节流。如果使用了 tmux、screen 或 zellij,这个中间层也必须能正确转发 ZMODEM 流量。

用 rz 上传文件

rz 表示远程机器接收文件。从你设备的角度看,这就是一次上传。

  1. 在远程终端中切换到目标目录,并用 pwd 确认位置。
  2. 运行 rz。
  3. NeoServer 打开 ZMODEM 面板。选择 Choose Files 并挑选一个或多个本地文件。
  4. 查看进度,等待传输完成后再回到正常的终端操作。
cd ~/uploads
pwd
rz

目标目录必须已经存在,并且你的 SSH 账户对其有写入权限。文件会被发送到运行在该目录下的接收端。如果远程已存在同名文件,远程接收端的选项决定它如何处理这种冲突。

NeoServer 会为选中的上传文件准备本地副本,并分块流式发送。临时上传副本会在传输完成、取消或断开连接后清理。

用 sz 下载文件

sz 让远程机器发送文件到 NeoServer。传入一个或多个远程文件路径:

sz server.log

一次传多个文件时,把它们列在一起。路径包含空格时请加引号:

sz server.log report.json "build output.txt"

NeoServer 会对每个传入的文件请求确认。选择 Receive File 接收,或选择 Skip File 跳过该文件。收到的文件会出现在面板的 Received Files 区域;使用 Save to Files 把完成的文件导出到你指定的位置。

在 iOS 上,完成的下载还会出现在“文件”App 中 NeoServer 的 ZMODEM 文件夹里。每个收到的文件都存放在自己的目录中,因此多次下载不会在本地存储中相互覆盖。

CRC 校验与未完成的文件

ZMODEM 在传输帧和数据块上附加完整性校验。协议层面的说明可参考 Tera Term 的 ZMODEM 文档。

NeoServer 接受 Hex、Binary16 和 Binary32 帧,并按情况使用 CRC16 或 CRC32 校验。上传使用 CRC16。校验错误可以在当前传输会话内触发重试,或从某个偏移量开始重传。

下载会先写入临时的 .partial 文件。只有传输校验通过——包括发送方提供长度时的预期长度——NeoServer 才把下载移动到最终文件名。取消、失败或断开的传输会删除未完成的下载文件;已完成的文件仍然保留。

CRC 用于检测传输损坏,不能证明文件的创建者。 如果需要独立的端到端校验,请在两台机器上分别计算源文件与接收文件的加密哈希并进行对比。

取消、重试与传输限制

传输期间,NeoServer 会屏蔽普通的终端键盘输入,避免按键与协议数据混在一起。使用 ZMODEM 面板中的 Cancel 停止传输。

请记住这些限制:

  • 只能传文件。 不支持目录传输。先把目录打包,再把压缩包作为文件发送。
  • 单文件大小: 最多 4,294,967,295 字节,即 4 GiB 减 1 字节。
  • 重试仅限当前会话。 NeoServer 不会跨断开的连接保存续传状态。连接丢失后请重新连接并开始新的传输。
  • 请使用 SSH。 这套集成不支持 Mosh 终端路径,也不支持 7 位传输。

如果 rz 或 sz 没有打开传输面板

首先确认远程机器上存在该命令,并且你使用的是支持此功能的 NeoServer 终端版本。然后退出所有终端复用器,在直接的 SSH shell 中再试一次同样的命令。

上传时,检查远程目标目录和账户权限。下载时,检查源路径和读取权限。如果传输已开始但无法完成,请查看面板中的错误信息,并在检查连接、文件大小和本地存储空间后重试。

当你想从正在工作的目录里搬移文件时,ZMODEM 非常实用。NeoServer 的 SFTP 工具则适合浏览远程文件夹、可视化地管理文件。初始 SSH 连接的设置方法请参阅 NeoServer 快速开始。

NeoServer

SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac

App Store

准备好试试了吗?

NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac

App Store 免费下载