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 界面后: image.png

  • 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