На прошлой неделе мы завершили запуск Proton Drive SDK — общего движка, призванного унифицировать работу Proton Drive на всех платформах и быстрее предоставлять вам нужные функции. Сегодня мы делаем следующий шаг: вышел Proton Drive CLI, доступный для Windows, macOS и Linux.
CLI позволяет перенести возможности нашего облачного хранилища и сквозного шифрования в скрипты, резервные копии и конвейеры развертывания без необходимости писать код. Он создан на базе того же Proton Drive SDK, на котором работают наши официальные клиентские приложения Proton Drive, и полностью совместим с ними.
Для нашего сообщества разработчиков: пока мы разрабатываем полнофункциональное приложение для Linux, CLI уже позволяет автоматизировать многие ключевые функции Proton Drive с помощью скриптов в ваших любимых средах выполнения (или даже планировать задачи с помощью cron). CLI призван дополнить приложение Proton Drive. Это не полноценная замена (например, только в приложениях есть полноценный механизм синхронизации, работающий в фоновом режиме), а скорее способ решения многих задач в легковесной среде выполнения скриптов.
Что такое CLI?
Интерфейс командной строки (CLI) — это программа, которую вы запускаете из оболочки, такой как Терминал, PowerShell или SSH. Вы передаете команду и аргументы, она выполняет задачу и завершает работу. Как и другие консольные инструменты Unix, вы можете объединять Proton Drive CLI через конвейеры и скрипты с другими инструментами в более сложные рабочие процессы.
Proton Drive CLI — это один исполняемый файл, который отлично впишется в эту среду. Он поддерживает стандартные операции с хранилищем, такие как просмотр папок, загрузка и скачивание файлов, работа с Корзиной, общий доступ или приглашения. По умолчанию результаты отображаются в виде простого читаемого текста, а если вы настраиваете автоматизацию, то можете переключиться на машиночитаемый формат с помощью параметра --json (или -j).
Чем полезен Proton Drive CLI?
До сих пор использование Proton Drive в автоматизированных рабочих процессах — наряду с такими инструментами, как скрипты развертывания, задачи резервного копирования, cron или внутренние инструкции — означало либо выполнение действий вручную (например, открытие приложения или перетаскивание файлов), либо реверс-инжиниринг внутренней архитектуры хранилища для написания собственных скриптов, которые были ненадежными и сложными в поддержке. CLI меняет это, позволяя выполнять операции Proton Drive прямо из терминала. Например, он может загружать файлы после завершения сборки, создавать резервную копию папки по расписанию, отправлять приглашение рецензенту или проверять, для каких файлов открыт общий доступ.
Это особенно полезно, когда вам нужно выполнить конкретное действие в определенное время, а не постоянно синхронизировать папки: например, опубликовать файлы после релиза, сделать снимок общей папки перед аудитом или закрыть доступ при офбординге сотрудника. 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 "Пожалуйста, проверьте отчеты" /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
Самый быстрый способ начать работу — скачать готовые исполняемые файлы для вашей платформы:
В macOS и Linux после скачивания вам потребуется сделать файл исполняемым (chmod +x proton-drive). После этого выполните proton-drive version, чтобы подтвердить сборку.
Вход в систему выполняется через браузер — вводить пароль в командной строке не требуется. Ваши сеансы надежно хранятся операционной системой (Диспетчером учетных данных Windows, Связкой ключей macOS или libsecret в Linux).
Сборка из исходного кода
Предпочитаете сборку из исходного кода? CLI написан на TypeScript, собран с помощью Bun(новое окно) и доступен для скачивания в репозитории Drive SDK(новое окно). Клонировав репозиторий, вы можете установить зависимости и собрать CLI из корневого каталога:
cd js/cli
bun install
bun run build
./release/proton-drive auth login
./release/proton-drive filesystem list /my-files
Подробности можно найти в файле README для CLI в репозитории.
Правила добросовестного использования и лимиты частоты запросов
В отношении Proton Drive CLI действуют те же правила добросовестного использования, что и для всех остальных клиентов Proton Drive. Чтобы не превышать лимиты, загружайте или скачивайте только то, что действительно изменилось: не загружайте повторно одни и те же файлы и не перезаписывайте папки целиком, если добавилось лишь несколько новых файлов. Скорость доступа для аккаунтов, генерирующих аномально высокий трафик, временно ограничивается в целях защиты сервиса для всех пользователей.
Теперь и в вашем терминале — с тем же уровнем конфиденциальности
Proton Drive CLI доступен уже сегодня, и в скором времени появятся новые функции. Все, что вы делаете в терминале, защищено тем же сквозным шифрованием, что и остальные сервисы Proton Drive. Скачайте его, попробуйте в деле и поделитесь своими отзывами. И если вы работаете на Linux: полнофункциональный классический клиент с поддержкой синхронизации уже на подходе.
