Skip to the content.

Trzsz 中文文档

trzsz ( trz / tsz ) 是一个兼容 tmux 的文件传输工具,和 lrzsz ( rz / sz ) 类似,并且有进度条和支持目录传输。

GitHub: https://github.com/trzsz/trzsz

MIT License PyPI trzsz 中文网站

为什么?

考虑 laptop -> hostA -> hostB -> docker -> tmux 这种场景,使用 scpsftp 是不方便的。

在这种场景下,使用 lrzsz ( rz / sz ) 是很方便的,但是很可惜它与 tmux 不兼容。

tmux 不愿意支持 rz / sz ( 906, 1439 ),而重新造一个工具比修改 tmux 简单很多。

安装指南

在远程服务器上安装

  没有 sudo 权限也可以安装,只要将安装路径 ( 可能是 ~/.local/bin ) 添加到 PATH 环境变量中即可。

支持的终端

  如果你的终端也支持 trzsz,请告诉我,我很乐意将它加到此列表中。

使用指南

trz 上传文件

trz 命令可以不带任何参数,将上传文件到当前目录。也可以带一个目录参数,指定上传到哪个目录。

trz /tmp/

tsz 下载文件

tsz 可以带一个或多个文件名(可使用相对路径或绝对路径,也可使用通配符),将下载指定的文件。

tsz file1 file2 file3

-q 静默模式

trz -qtsz -q xxx ( 加上 -q 选项 ),则在传输文件时不显示进度条。

-y 覆盖模式

trz -ytsz -y xxx ( 加上 -y 选项 ),如果存在相同文件名的文件就直接覆盖。

-b 二进制模式

trz -btsz -b xxx ( 加上 -b 选项 ),二进制传输模式,对于压缩包、图片、影音等较快。

-e 转义控制字符

二进制模式时,控制字符可能会导致失败,trz -ebtsz -eb xxx ( 加上 -e 选项 ) 转义所有已知的控制字符。

-d 传输文件夹

trz -dtsz -d xxx ( 加上 -d 选项 ),则可以上传或下载指定文件夹和文件。

-B 缓冲区上限

trz -B 20mtsz -B 2M xxx 等,设置最大缓冲区上限 ( 默认 10M )。会自动根据网速选择合适的缓冲区大小,但不会超过此上限。

-t 超时时间

trz -t 30tsz -t 30 xxx 等,设置超时秒数 ( 默认 10 秒 )。在超时时间内,如果无法传完一个缓冲区大小的数据则会报错并退出。设置为 0 或负数,则永不超时。

异常处理方法

屏幕截图

trzsz 在 iTerm2 中 text 进度条示例

using trzsz in iTerm2 with text progress bar

trzsz 在 iTerm2 中 zenity 进度条示例

using trzsz in iTerm2 with zenity progress bar

trzsz 在 tabby 中 tabby-trzsz 插件示例

using trzsz in tabby with tabby-trzsz plugin

联系方式

有什么问题可以发邮件给我 lonnywong@qq.com,也可以直接提 Issues