profileName: youpingfang postId: 236 postType: post categories:
- 8
pikpaktui 是一个专为 PikPak 网盘打造的、纯 Rust 编写的终端用户界面(TUI)和命令行(CLI)客户端。它不仅适合极客在终端高效管理文件,还对 AI 智能体(如 OpenClaw)非常友好。
核心亮点
🖥️ 交互式 TUI 界面:采用类似 Yazi 的三栏式米勒布局(Miller layout),支持缩略图预览、语法高亮以及全键盘快捷键操作。
⌨️ 功能完备的 CLI:内置 28 个子命令(包括
ls,mv,cp,rm,download,upload,share等),支持彩色输出、JSON 模式和预览(dry-run)模式。🎬 视频在线串流:支持直接将 PikPak 中的视频流式传输到本地播放器(如 IINA、mpv、VLC)。
📥 离线云下载:支持直接在终端添加磁力链接(Magnet)和 URL 进行离线下载。
🔗 分享管理:支持创建、查看、保存和删除分享链接,并可设置密码保护和到期时间。
🦀 纯 Rust 打造:基于 ratatui + crossterm + reqwest 构建,无 OpenSSL 等复杂的 C 语言依赖。
安装方法
1. 一键脚本安装 (macOS / Linux / FreeBSD)
Bash
curl -fsSL https://app.snaix.homes/pikpaktui/install.sh | bash
2. 使用 Homebrew (macOS / Linux)
Bash
brew install Bengerthelorf/tap/pikpaktui
3. 使用 Cargo (Rust 包管理器)
Bash
cargo install pikpaktui
4. 源码编译
Bash
git clone https://github.com/Bengerthelorf/pikpaktui.git
cd pikpaktui
cargo build --release
./target/release/pikpaktui
提示:你也可以直接去项目的 Releases 页面下载适用于 Windows、Linux、macOS 和 FreeBSD 的预编译二进制文件。
使用方法
1. 登录
交互式登录:直接在终端输入
pikpaktui启动,首次运行时会自动弹出登录表单。非交互式登录(适合脚本自动化):
Bash
pikpaktui login -u user@example.com -p yourpassword
2. TUI 快捷键
进入 TUI 界面后:

h:打开帮助菜单,:打开设置q:退出程序
3. 常用 CLI 命令行操作
你也可以不进入 TUI,直接在终端使用命令行操作网盘:
列出目录文件:
Bash
pikpaktui ls /下载文件:
Bash
pikpaktui download "/My Pack/video.mp4"上传本地文件:
Bash
pikpaktui upload ./local.txt "/My Pack"创建加密分享链接(保留7天):
Bash
pikpaktui share -p -d 7 /movie.mkv
环境变量配置
你可以通过配置以下环境变量来免去重复输入账号密码,或者修改 API 接口:
| 环境变量 | 描述 |
|---|---|
PIKPAK_USER |
账户邮箱(用于登录命令的默认后备) |
PIKPAK_PASS |
账户密码 |
PIKPAK_DRIVE_BASE_URL |
覆盖 PikPak 网盘 API 的默认端点 |
PIKPAK_AUTH_BASE_URL |
覆盖 PikPak 认证 API 的默认端点 |
PIKPAK_CAPTCHA_TOKEN |
登录时所需的验证码 Token |