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

渗透场景推荐至少装 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 均可预览（需对应依赖）。

常用快捷键

导航

文件操作

选择

搜索

其他

与 [[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的能看，等后期官方修复吧。

参考资料

• 官方文档
• GitHub 仓库
• 插件列表