W zeszłym tygodniu zakończyliśmy wdrażanie pakietu Proton Drive SDK – wspólnego silnika stworzonego w celu ujednolicenia Proton Drive na wszystkich platformach i szybszego dostarczania Ci potrzebnych funkcji. Dzisiaj robimy kolejny krok: narzędzie Proton Drive CLI jest już dostępne dla systemów Windows, macOS i Linux.
Narzędzie CLI przenosi możliwości naszej przestrzeni dyskowej w chmurze i szyfrowania end-to-end do skryptów, kopii zapasowych i potoków wdrażania bez konieczności pisania kodu. Zostało ono zbudowane na bazie tego samego pakietu Proton Drive SDK, który napędza nasze oficjalne aplikacje klienckie Proton Drive, i jest z nimi w pełni kompatybilne.
Dla naszej społeczności programistów: Chociaż pracujemy nad w pełni funkcjonalną aplikacją dla systemu Linux, CLI już teraz pozwala Ci na tworzenie skryptów dla wielu kluczowych funkcji Proton Drive w Twoich ulubionych środowiskach skryptowych (lub nawet planowanie zadań za pomocą crona). CLI ma stanowić dopełnienie aplikacji Proton Drive. Nie jest to jej pełny zamiennik — na przykład tylko aplikacje zawierają pełny silnik synchronizacji działający w tle — ale raczej sposób na osiągnięcie wielu celów w lekkim środowisku skryptowym.
Czym jest CLI?
Interfejs wiersza poleceń (CLI) to program, który uruchamiasz z poziomu powłoki, takiej jak Terminal, PowerShell czy SSH. Przekazujesz polecenie oraz argumenty, program wykonuje zadanie i kończy działanie. Podobnie jak w przypadku innych narzędzi wiersza poleceń systemu Unix, możesz łączyć Proton Drive CLI z innymi narzędziami za pomocą potoków i skryptów w celu tworzenia większych przepływów pracy.
Proton Drive CLI to pojedynczy plik binarny, który możesz wdrożyć do tego środowiska. Obsługuje on typowe operacje na dysku, takie jak wyświetlanie listy folderów, przesyłanie i pobieranie plików, kosz, udostępnianie czy zaproszenia. Wyniki są domyślnie wyświetlane w postaci zwykłego, czytelnego tekstu – a jeśli budujesz na tym automatyzację, możesz przełączyć się na format przyjazny dla maszyn za pomocą parametru --json (lub -j).
Jak pomaga Proton Drive CLI?
Do tej pory korzystanie z Proton Drive w ramach zautomatyzowanego przepływu pracy – obok narzędzi takich jak skrypty wdrażania, zadania tworzenia kopii zapasowych, cron czy wewnętrzne instrukcje operacyjne (runbooks) – oznaczało konieczność robienia tego ręcznie (np. otwieranie aplikacji lub przeciąganie plików) albo inżynierię wsteczną wewnętrznych mechanizmów dysku w celu napisania niestandardowych skryptów, które były niestabilne i trudne w utrzymaniu. CLI to zmienia, umożliwiając uruchamianie operacji Proton Drive bezpośrednio z poziomu terminala. Może na przykład przesyłać pliki po zakończeniu budowania projektu, tworzyć kopie zapasowe folderu zgodnie z harmonogramem, zapraszać recenzenta lub sprawdzać, co zostało udostępnione.
Jest to szczególnie przydatne, gdy potrzebujesz, aby określona akcja odbyła się w konkretnym czasie, zamiast ciągłego synchronizowania folderów – na przykład przy publikowaniu plików po wydaniu nowej wersji, robieniu migawki udostępnionego folderu przed audytem lub unieważnianiu dostępu, gdy ktoś odchodzi z firmy. CLI uruchamia operację, informuje Cię, czy się powiodła, i kończy działanie.
To naturalny wybór dla każdego, kto już pracuje w terminalu, oraz dla zespołów, które chcą, aby ich przepływy pracy na dysku były zapisane w postaci powtarzalnych poleceń, a nie serii kliknięć, o których trzeba pamiętać.
Zacznij korzystać z Proton Drive CLI
W momencie premiery CLI obejmuje najważniejsze funkcje: logowanie i wylogowywanie się, przeglądanie i zarządzanie plikami oraz folderami (w tym koszem), a także obsługę udostępniania i zaproszeń.
Kilka typowych przepływów pracy:
proton-drive auth login
# Prześlij pliki z katalogu lokalnego do folderu w Moje pliki
proton-drive filesystem upload ./reports/* /my-files/Reports --conflict-strategy skip
# Sprawdź, kto ma dostęp, a następnie zaproś współpracownika
proton-drive sharing status /my-files/Reports
proton-drive sharing invite --user example@pm.me --role editor --message "Proszę o przejrzenie raportów" /my-files/Reports
# Pobierz do lokalnego katalogu kopii zapasowych
proton-drive filesystem download /my-files/Reports ./backups
Aby poznać pełny zestaw poleceń i flag, uruchom proton-drive help lub proton-drive --help. Na przykład: proton-drive filesystem upload --help.
Dowiedz się więcej o korzystaniu z Proton Drive CLI.
Co dalej
Nadchodzące aktualizacje Proton Drive CLI wprowadzą:
- obsługę zdjęć i albumów
- plików i folderów udostępnionych za pomocą bezpiecznego, publicznego linku
- obsługę wielu kont dla większych zespołów i dostawców usług zarządzanych
Naszym długoterminowym celem jest przeniesienie wszystkiego, co możesz zrobić w aplikacji Proton Drive, do wiersza poleceń.
Pobierz Proton Drive CLI
Najszybszym sposobem na rozpoczęcie pracy jest pobranie gotowych plików binarnych dla Twojej platformy:
W systemach macOS i Linux po pobraniu pliku musisz nadać mu uprawnienia do uruchamiania (chmod +x proton-drive). Gdy to zrobisz, uruchom polecenie proton-drive version, aby potwierdzić kompilację.
Logowanie odbywa się za pośrednictwem przeglądarki – nie podajesz hasła w wierszu poleceń. Twoje sesje są bezpiecznie przechowywane przez system operacyjny (Windows Credential Manager, macOS Keychain lub libsecret w systemie Linux).
Zbuduj ze źródeł
Wolisz samodzielnie zbudować program ze źródeł? CLI zostało napisane w języku TypeScript, spakowane za pomocą Bun(nowe okno) i jest dostępne do pobrania w repozytorium Drive SDK(nowe okno). Po sklonowaniu repozytorium możesz zainstalować zależności i zbudować CLI z katalogu głównego:
cd js/cli
bun install
bun run build
./release/proton-drive auth login
./release/proton-drive filesystem list /my-files
Więcej szczegółów znajdziesz w pliku README narzędzia CLI w repozytorium.
Zasady uczciwego korzystania i limity żądań
Proton Drive CLI podlega tym samym zasadom uczciwego korzystania, co wszystkie aplikacje klienckie Proton Drive. Aby nie przekroczyć limitów, przesyłaj lub pobieraj tylko to, co faktycznie się zmieniło – nie przesyłaj wielokrotnie tych samych plików ani nie zapisuj ponownie całych folderów, gdy tylko kilka plików jest nowych. Konta generujące nietypowo wysoki ruch sieciowy są tymczasowo ograniczane, aby chronić stabilność usługi dla wszystkich użytkowników.
Teraz w Twoim terminalu, z zachowaniem tego samego poziomu prywatności
Proton Drive CLI jest już dostępne, a kolejne funkcje pojawią się wkrótce. Wszystko, co robisz w terminalu, jest chronione przez to samo szyfrowanie end-to-end, co reszta Proton Drive. Pobierz je, wypróbuj i daj nam znać, co udało Ci się stworzyć. A jeśli korzystasz z systemu Linux: w pełni funkcjonalna aplikacja desktopowa z funkcją synchronizacji jest już w drodze.
