上周，我们完成了 Proton Drive SDK 的发布，这个共享引擎旨在让 Proton Drive 在所有平台上保持一致，并更快地为您带来所需的功能。今天，我们迈出了下一步：Proton Drive CLI 现已推出，支持 Windows、macOS 和 Linux。

CLI 将我们的云存储和端到端加密的强大功能带入脚本、备份和部署流程，无需费心编写代码。它基于驱动官方 Proton Drive 客户端应用的同一 Proton Drive SDK 构建，并与这些应用完全互操作。

致我们的开发者社区：在我们开发功能齐全的 Linux 应用的同时，CLI 已经让您可以从喜爱的脚本环境编写脚本，实现 Proton Drive 的许多关键功能（甚至可以用 cron 安排任务）。CLI 旨在补充 Proton Drive 应用，而非完全取代它 — 例如，只有应用才包含在后台运行的完整同步引擎 — 它是一种在轻量级脚本环境中实现众多目标的方式。

什么是 CLI？

命令行界面 (CLI) 是一种从 shell（如 Terminal、PowerShell 或 SSH）中运行的程序。您传入命令和参数，它完成任务后即退出。与其他 Unix 命令行工具一样，Proton Drive CLI 也可通过管道和脚本与其他工具组合，构建更大的工作流。

Proton Drive CLI 是一个单一的二进制文件，可直接放入这一环境。它支持常见的云端硬盘操作，例如列出文件夹、上传和下载文件、废件箱、分享和邀请。结果默认以纯文本易读格式显示 — 如果您要在此基础上构建自动化，可以使用 --json（或 -j）参数切换为机器友好的格式。

Proton Drive CLI 能提供哪些帮助？

迄今为止，在自动化工作流程中使用 Proton Drive — 与部署脚本、备份任务、cron 或内部运行手册等工具配合 — 要么需要手动操作（比如打开应用或拖拽文件），要么需要逆向工程破解云端硬盘的内部机制，编写脆弱且难以维护的自定义脚本。CLI 改变了这一点，让您可以直接从终端运行 Proton Drive 操作。例如，它可以在构建完成后上传文件、按计划备份文件夹、邀请审阅者，或查看已分享的内容。

当您需要在特定时间执行特定操作，而非让文件夹持续保持同步时，这尤其有用，例如在发布后发布文件、在审计前对共享文件夹进行快照，或在某人离职时撤销访问。CLI 运行操作，告知您是否成功，然后退出。

对于已经习惯在终端中工作的用户，以及希望将云端硬盘工作流程记录为可重复执行的命令、而非需要记住的一系列点击操作的团队而言，CLI 都是理想之选。

开始体验 Proton Drive CLI

发布时，CLI 涵盖了基本功能：登入和登出、浏览和管理文件与文件夹（包括废件箱），以及处理分享和邀请。

几个典型使用流程：

proton-drive auth login

# 将文件从本地目录上传到“我的文件”中的文件夹
proton-drive filesystem upload ./reports/* /my-files/Reports --conflict-strategy skip

# 查看谁拥有访问权限，然后邀请同事
proton-drive sharing status /my-files/Reports
proton-drive sharing invite --user example@pm.me --role editor --message "Please review reports" /my-files/Reports

# 下载到本地备份目录
proton-drive filesystem download /my-files/Reports ./backups

如需完整的命令集和参数，请运行 proton-drive help 或 proton-drive --help。例如 proton-drive filesystem upload --help。

进一步了解 Proton Drive CLI 的使用方法。

后续计划

Proton Drive CLI 即将新增以下功能支持：

  • 照片和相册
  • 通过安全的公开链接分享的文件和文件夹
  • 面向大型团队和托管服务提供商的多帐户支持

我们的长期目标是将 Proton Drive 应用中能做的一切操作都带到命令行。

下载 Proton Drive CLI

最快的上手方式是下载适用于您平台的预构建二进制文件：

下载 Proton Drive CLI

在 macOS 和 Linux 上，下载后需要将文件设为可执行（chmod +x proton-drive）。完成后，运行 proton-drive version 以确认构建版本。

登入通过浏览器进行 — 命令行中无需输入密码。会话由操作系统安全地存储（Windows Credential Manager、macOS 钥匙串或 Linux 上的 libsecret）。

从源代码构建

更愿意从源代码构建？CLI 使用 TypeScript 实现，通过 Bun（新窗口） 打包，可在云端硬盘 SDK 仓库（新窗口）中下载。克隆后，您可以在主目录中安装依赖并构建 CLI：

cd js/cli
bun install
bun run build
./release/proton-drive auth login
./release/proton-drive filesystem list /my-files

更多详细信息请参阅仓库中的 CLI README。

合理使用与速率限制

Proton Drive CLI 遵循与所有 Proton Drive 客户端相同的合理使用策略。为了保持在限制之内，请仅上传或下载实际发生更改的内容 — 不要重复上传相同文件，或在只有少数文件是新增时重写整个文件夹。产生异常高流量的帐户将被暂时限速，以保护所有人的服务。

现已来到您的终端，隐私保护一如既往

Proton Drive CLI 现已推出，更多功能也将很快跟进。您通过终端执行的一切操作都受到与 Proton Drive 其他部分相同的端到端加密保护。下载试用，并告诉我们您用它构建了什么。如果您使用 Linux：支持同步的全功能桌面客户端也即将推出。