Yazi：终端文件管理器安装与试用

Wed, 25 Mar 2026 16:31:08 +0800

Yazi：终端文件管理器安装与试用

什么是 Yazi

Yazi 是一个用 Rust 编写的现代终端文件管理器，纯 TUI 界面，无需图形环境，SSH 连接即可直接使用。相比传统的 ls + cd 工作流，Yazi 提供文件预览、图片缩略图、压缩包浏览、快速搜索等功能，与 tmux 配合使用体验极佳。

安装

Kali / Debian / Ubuntu

官方暂无 apt 包，需手动下载预编译二进制：

1wget https://github.com/sxyazi/yazi/releases/latest/download/yazi-x86_64-unknown-linux-musl.zip
2wget "https://gh-proxy.org/https://github.com/sxyazi/yazi/releases/latest/download/yazi-x86_64-unknown-linux-musl.zip"
3unzip yazi-x86_64-unknown-linux-musl.zip
4cd yazi-x86_64-unknown-linux-musl
5sudo mv yazi ya /usr/local/bin/
6yazi --version

可选依赖（按需安装）

1sudo apt install -y ffmpeg 7zip jq poppler-utils fd-find ripgrep fzf zoxide imagemagick
2# 如果报错
3echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4
4sudo apt install -y ffmpeg zoxide
5# 或换源
6sudo tee /etc/apt/sources.list << 'EOF'
7deb https://mirrors.aliyun.com/kali kali-rolling main non-free contrib
8EOF
9sudo apt update && sudo apt install -y ffmpeg zoxide

依赖	功能
ffmpeg	视频缩略图预览
7zip	压缩包预览与解压
jq	JSON 文件预览
poppler-utils	PDF 预览
fd-find	文件搜索（`s` 键）
ripgrep	文件内容全文搜索
fzf	快速子目录导航
zoxide	历史目录跳转
imagemagick	HEIC / JPEG XL 预览

渗透场景推荐至少装 fd-find + ripgrep + fzf，搜文件和搜内容效率极高。

Shell 集成（推荐）

在 ~/.zshrc（Kali）或 ~/.bashrc 中加入以下函数，使退出 Yazi 时自动 cd 到最后浏览的目录：

1function y() {
2 local tmp="$(mktemp -t "yazi-cwd.XXXXX")"
3 yazi "$@" --cwd-file="$tmp"
4 if cwd="$(cat -- "$tmp")" && [ -n "$cwd" ] && [ "$cwd" != "$PWD" ]; then
5 cd -- "$cwd"
6 fi
7 rm -f -- "$tmp"
8}

然后执行 source ~/.zshrc 生效。之后用 y 命令启动，按 q 退出后会自动跳转到你最后浏览的目录。

基本界面

启动后界面分为三栏：

左栏（父目录） | 中栏（当前目录） | 右栏（预览）

上下移动光标时右栏实时预览文件内容，文本、图片、压缩包、PDF 均可预览（需对应依赖）。

常用快捷键

操作	快捷键
进入目录 / 打开文件	`Enter` 或 `l`
返回上级目录	`h`
上 / 下移动	`k` / `j`
跳到顶部 / 底部	`gg` / `G`
跳到指定行	`数字 + G`（如 `5G`）

文件操作

操作	快捷键
复制文件	`y`
剪切文件	`x`
粘贴	`p`
重命名	`r`
删除（移入回收站）	`d`
永久删除	`D`
新建文件	`a`，输入文件名回车
新建文件夹	`a`，文件名末尾加 `/`
复制文件路径	`c` 然后 `c`（复制完整路径）

选择

操作	快捷键
选中 / 取消当前文件	`Space`
全选	`Ctrl + a`
反选	`Ctrl + r`

搜索

操作	快捷键
在当前目录过滤	`/` 输入关键词
递归搜索文件名（fd）	`s`
搜索文件内容（ripgrep）	`S`
使用 fzf 快速跳转	`z`
zoxide 历史跳转	`Z`

其他

操作	快捷键
显示 / 隐藏隐藏文件	`.`
排序方式	`,`
打开 Shell（当前目录）	`!`
查看文件权限信息	`Space` 选中后 `~`
退出（不 cd）	`q`
退出（cd 到当前目录）	`Q`（需配置 shell 集成）

与 [[Tmux终端复用|tmux]] 配合使用

在 tmux 的某个 pane 里开一个 Yazi，旁边 pane 做其他工作，两边互不干扰：

Ctrl+a | # 垂直分屏
左边：y # 启动 Yazi 浏览文件
右边：正常命令行操作

需要把某个文件路径传到命令行时，在 Yazi 里按 c c 复制路径，切换到右边 pane 粘贴即可。

案例展示

启动后界面：

 ~/pentest/targets
 .. README.md
 192.168.1.100/ → # Target: Windows AD
 192.168.1.200/ # Scope: 192.168.1.0/24
 loot/ # Creds found: admin:Password123
 scans/
 exploits/

联合使用

`s` 键（fd 搜索）没结果

Kali 里 fd 的包名是 fd-find，但二进制叫 fdfind 不叫 fd，Yazi 找不到：

1sudo apt install -y fd-find
2which fdfind # 应该输出 /usr/bin/fdfind
3sudo ln -s /usr/bin/fdfind /usr/local/bin/fd
4fd --version

`S` 键（ripgrep 内容搜索）没结果

确认 rg 是否可用：

1rg --version

没装的话：

1sudo apt install -y ripgrep

`z` 提示找不到（fzf 跳转）

需要 fzf 版本 >= 0.53.0，Kali apt 源的版本太旧：

1fzf --version # 看当前版本

如果版本低于 0.53.0，手动装新版：

1wget https://github.com/junegunn/fzf/releases/latest/download/fzf-linux_amd64.tar.gz
2tar -xzf fzf-linux_amd64.tar.gz
3sudo mv fzf /usr/local/bin/
4fzf --version

`Z` 提示找不到（zoxide 历史跳转）

zoxide 装好后还需要初始化才能用，在 ~/.zshrc 加：

1eval "$(zoxide init zsh)"

然后 source ~/.zshrc，并且需要先用 cd 访问几个目录积累历史，zoxide 才有记录可以跳。

验证顺序

1fd --version # 应该有输出
2rg --version # 应该有输出
3fzf --version # 应该 >= 0.53.0
4zoxide --version # 应该有输出

四个都通了再进 Yazi 测试。

各功能实际用法

`s` — 文件名搜索（fd）

进入 Yazi 按 s，弹出输入框，输入关键词回车，结果列表出来后用 j/k 选择，Enter 跳到该文件。

场景：找某个目录下所有 .py 文件 → 输入 .py
场景：找名字含 config 的文件 → 输入 config

`S` — 文件内容搜索（ripgrep）

按 S，输入要搜索的字符串，回车，列出所有包含该内容的文件。

场景：找哪个文件里有 password → 输入 password
场景：找包含某个函数名的脚本 → 输入函数名

`z` — fzf 快速跳转

按 z，弹出 fzf 界面，模糊匹配当前目录树下的子目录，输入几个字母筛选，Enter 直接跳过去。

`Z` — zoxide 历史跳转

按 Z，从你历史访问过的目录里模糊匹配跳转。需要先用 cd 或在 Yazi 里逛几个目录积累记录才有效果，第一次用是空的。

还需要确认 zoxide 初始化加进去了：

1grep "zoxide" ~/.zshrc

没有的话加上：

1echo 'eval "$(zoxide init zsh)"' >> ~/.zshrc
2source ~/.zshrc

进 Yazi 试一下 s 搜个文件名看有没有结果。

PDF预览

pdftoppm 是 poppler-utils 里的工具，装了但找不到，检查一下：

1which pdftoppm
2dpkg -l | grep poppler

如果 which pdftoppm 没输出，重装一次：

1sudo apt install --reinstall poppler-utils
2which pdftoppm

如果有输出路径但 Yazi 还是报错，说明路径不在 Yazi 的 $PATH 里，告诉我 which pdftoppm 的输出结果。

MP4视频预览

目前版本 Yazi 26.2.2 (5b2dd41 2026-03-24) 关于视频预览的bug还没修，目前Kali上看不了视频，似乎只有mac的能看，等后期官方修复吧。

Tui on 静静的安全笔记

Yazi：终端文件管理器安装与试用

Yazi：终端文件管理器安装与试用

什么是 Yazi

安装

Kali / Debian / Ubuntu

可选依赖（按需安装）

Shell 集成（推荐）

基本界面

常用快捷键

导航

文件操作

选择

搜索

其他

与 [[Tmux终端复用|tmux]] 配合使用

案例展示

联合使用

`s` 键（fd 搜索）没结果

`S` 键（ripgrep 内容搜索）没结果

`z` 提示找不到（fzf 跳转）

`Z` 提示找不到（zoxide 历史跳转）

验证顺序

各功能实际用法

`s` — 文件名搜索（fd）

`S` — 文件内容搜索（ripgrep）

`z` — fzf 快速跳转

`Z` — zoxide 历史跳转

PDF预览

MP4视频预览

参考资料

Tui on 静静的安全笔记

Yazi：终端文件管理器安装与试用

Yazi：终端文件管理器安装与试用

什么是 Yazi

安装

Kali / Debian / Ubuntu

可选依赖（按需安装）

Shell 集成（推荐）

基本界面

常用快捷键

导航

文件操作

选择

搜索

其他

与 [[Tmux终端复用|tmux]] 配合使用

案例展示

联合使用

s 键（fd 搜索）没结果

S 键（ripgrep 内容搜索）没结果

z 提示找不到（fzf 跳转）

Z 提示找不到（zoxide 历史跳转）

验证顺序

各功能实际用法

s — 文件名搜索（fd）

S — 文件内容搜索（ripgrep）

z — fzf 快速跳转

Z — zoxide 历史跳转

PDF预览

MP4视频预览

参考资料

`s` 键（fd 搜索）没结果

`S` 键（ripgrep 内容搜索）没结果

`z` 提示找不到（fzf 跳转）

`Z` 提示找不到（zoxide 历史跳转）

`s` — 文件名搜索（fd）

`S` — 文件内容搜索（ripgrep）

`z` — fzf 快速跳转

`Z` — zoxide 历史跳转