Kuake CLI 入门指南:核心配置原理与基础使用

本指南介绍了 Kuake CLI 的核心配置原理与基础使用。重点说明了从 v1.5.0 起弃用 config.json 并转向环境变量(KUAKE_COOKIE)和 .env 文件的配置变化,以及 v1.6.0 新增的 auth 凭证持久化功能。提供了获取 Cookie 的方法及 list、upload、download 等基础命令示例,适用于新手用户快速上手。

READ

Kuake CLI 是一款开源的夸克网盘命令行管理工具,支持文件列表、上传、下载、分享及跨平台操作。本指南旨在帮助新手用户理解其核心配置原理,特别是从旧版配置文件模式向环境变量模式的演进,并提供基础命令的使用示例。

注意:Kuake CLI 为非官方第三方项目,使用可能导致账号风险或 API 变更导致不可用,风险自负。

来源1

核心配置原理:为什么不再使用 config.json?

在早期版本(如 v1.3.x)中,用户需要下载 config.json 并填入 Cookie。然而,随着版本迭代,配置方式发生了重大变化,主要出于安全性和简洁性的考虑:

  1. v1.4.5 的 Breaking Change:从 v1.4.5 开始,CLI 不再支持将 JSON 位置参数误作配置文件。用户必须使用 -c 或 --config 参数显式指定配置文件路径(如果仍使用文件方式)。例如,旧版 kuake user ./my.json 需改为 kuake -c ./my.json user [1]。
  2. v1.5.0 的重大转向:自 v1.5.0 起,旧版的 config.json 与 -c, --config 参数不再支持。项目强制转向使用环境变量进行认证 [1]。
  3. 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 进行配置,这是当前及未来版本的标准做法。

来源1 · 来源2

Kuake CLI 需要有效的夸克网盘账号 Cookie 才能运行。获取方法如下:

  1. 浏览器开发者工具:

    • 登录夸克网盘网页版。
    • 打开浏览器开发者工具(F12)。
    • 在“网络”(Network)标签页中,刷新页面或发起一次请求。
    • 找到任意请求,查看“请求标头”(Request Headers)。
    • 复制 Cookie 字段的完整值。
  2. 配置方式:

    • 环境变量:在终端中设置 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 的文件。

来源1

基础命令示例

安装 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]。

来源1 · 来源2

安装与系统要求

  • 系统要求:Linux、macOS、Windows。
  • 安装方式:
    • 预编译二进制:从 GitHub Releases 下载对应平台的二进制文件(如 kuake-v1.6.0-linux-amd64) [1]。
    • 从源码构建:需要 Go 1.25+ 和 Git。克隆仓库后运行 ./build.sh 即可构建 [1]。

更多详细文档和参数说明,请参考仓库中的 docs/cli.md [1]。

来源1

Conversation

评论

正在加载评论