Kuake CLI 是一款开源的夸克网盘命令行管理工具,支持文件列表、上传、下载、分享及跨平台操作。本指南旨在帮助新手用户理解其核心配置原理,特别是从旧版配置文件模式向环境变量模式的演进,并提供基础命令的使用示例。
注意:Kuake CLI 为非官方第三方项目,使用可能导致账号风险或 API 变更导致不可用,风险自负。
核心配置原理:为什么不再使用 config.json?
在早期版本(如 v1.3.x)中,用户需要下载 config.json 并填入 Cookie。然而,随着版本迭代,配置方式发生了重大变化,主要出于安全性和简洁性的考虑:
- v1.4.5 的 Breaking Change:从 v1.4.5 开始,CLI 不再支持将 JSON 位置参数误作配置文件。用户必须使用
-c或--config参数显式指定配置文件路径(如果仍使用文件方式)。例如,旧版kuake user ./my.json需改为kuake -c ./my.json user[1]。 - v1.5.0 的重大转向:自 v1.5.0 起,旧版的
config.json与-c, --config参数不再支持。项目强制转向使用环境变量进行认证 [1]。 - v1.6.0 的凭证持久化:v1.6.0 引入了
auth命令系列(save,status,clear),允许用户在设置 Cookie 后保存凭证,实现持久化登录,无需每次输入 [1]。
配置优先级:
- 环境变量:
KUAKE_COOKIE是核心凭证来源。此外,KUAKE_PUS和KUAKE_PUUS也可用于认证 [1]。 - 命令行参数:
-cookies参数可直接指定 Cookie 值,但优先级低于环境变量 [1]。 - 配置文件:仅在 v1.4.5 及更早版本中作为主要方式,或作为
-c指定的可选方式(v1.5.0 前) [1]。
建议:对于新用户,推荐使用
.env文件或环境变量KUAKE_COOKIE进行配置,这是当前及未来版本的标准做法。
Cookie 获取方法
Kuake CLI 需要有效的夸克网盘账号 Cookie 才能运行。获取方法如下:
浏览器开发者工具:
- 登录夸克网盘网页版。
- 打开浏览器开发者工具(F12)。
- 在“网络”(Network)标签页中,刷新页面或发起一次请求。
- 找到任意请求,查看“请求标头”(Request Headers)。
- 复制
Cookie字段的完整值。
配置方式:
- 环境变量:在终端中设置
export KUAKE_COOKIE="你的Cookie值"。 - .env 文件:复制仓库中的
.env.example为.env,取消KUAKE_COOKIE行的注释并填入 Cookie。Kuake 会自动从当前工作目录加载.env文件(可通过KUAKE_LOAD_DOTENV=0关闭) [1]。 - auth 命令(v1.6.0+):设置 Cookie 后,运行
./kuake auth save保存凭证。凭证文件权限在 Linux/macOS 上为 0600,Windows 上使用受保护 ACL,命令不会输出 Cookie 值 [1]。
- 环境变量:在终端中设置
安全警告:勿提交或分享含真实 Cookie 的文件。
基础命令示例
安装 Kuake CLI 后,可通过以下基础命令进行文件管理。所有命令均支持 JSON 输出,便于与 jq 等工具组合使用 [1]。
1. 查看用户信息
./kuake user
此命令可查询账号容量、会员信息等 [1]。
2. 列出文件目录
./kuake list "/"
列出根目录下的文件。支持指定路径参数,路径建议用引号包裹 [1]。
3. 上传文件
./kuake upload "file.txt" "/file.txt"
将本地 file.txt 上传至网盘根目录。支持并行上传(通过 --max_upload_parallel 配置)和断点续传 [1]。
4. 下载文件
./kuake download "/file.txt" "./local_file.txt"
支持并发下载、断点续传及跳过已存在的完整文件 [1]。
5. 分享管理
- 创建分享:需使用相关命令(具体参数见
--help)。 - 转存分享文件:使用
share-save命令,可从分享链接中提取文件并转存至个人网盘 [1]。 - 取消分享:使用
share-delete命令,可通过share_id或文件路径取消分享 [1]。
6. 凭证管理(v1.6.0+)
./kuake auth save # 保存凭证
./kuake auth status # 查看配置状态
./kuake auth clear # 清除凭证
使用前请运行 ./kuake --help 确认命令列表包含 auth [1]。
安装与系统要求
- 系统要求:Linux、macOS、Windows。
- 安装方式:
- 预编译二进制:从 GitHub Releases 下载对应平台的二进制文件(如
kuake-v1.6.0-linux-amd64) [1]。 - 从源码构建:需要 Go 1.25+ 和 Git。克隆仓库后运行
./build.sh即可构建 [1]。
- 预编译二进制:从 GitHub Releases 下载对应平台的二进制文件(如
更多详细文档和参数说明,请参考仓库中的 docs/cli.md [1]。
Conversation
评论