Minulý týden jsme dokončili spuštění Proton Drive SDK, sdíleného enginu navrženého tak, aby harmonizoval Proton Drive napříč všemi platformami a přinášel vám potřebné funkce rychleji. Dnes děláme další krok: Proton Drive CLI je tady, k dispozici pro Windows, macOS a Linux.

CLI přináší výkon našeho cloudového úložiště a koncového šifrování do skriptů, záloh a nasazovacích pipeline bez nutnosti psát kód. Je postaveno na stejném Proton Drive SDK, které pohání naše oficiální klientské aplikace Proton Drive, a je s nimi plně interoperabilní.

Pro naši komunitu vývojářů: Zatímco vyvíjíme plnohodnotnou aplikaci pro Linux, CLI vám již umožňuje skriptovat mnoho klíčových funkcí Proton Drive z vašeho oblíbeného skriptovacího prostředí (nebo dokonce plánovat úlohy pomocí cronu). CLI má doplňovat aplikaci Proton Drive. Nejedná se o plnohodnotnou náhradu — plnohodnotný synchronizační engine běžící na pozadí například obsahují pouze aplikace — ale spíše o způsob, jak dosáhnout mnoha cílů z lehkého skriptovacího prostředí.

Co je CLI?

Příkazové řádkové rozhraní (CLI) je program, který spouštíte z prostředí shell, jako je Terminál, PowerShell nebo SSH. Předáte příkaz a argumenty, program provede práci a ukončí se. Podobně jako u jiných unixových nástrojů příkazového řádku můžete Proton Drive CLI řetězit a skriptovat společně s dalšími nástroji do větších pracovních postupů.

Proton Drive CLI je jediný binární soubor, který můžete do tohoto světa zasadit. Podporuje běžné operace s diskem, jako je výpis složek, nahrávání a stahování souborů, koš, sdílení nebo pozvánky. Výsledky se ve výchozím nastavení zobrazují jako prostý, čitelný text — a pokud na tomto základě stavíte automatizaci, můžete přepnout na formát čitelný pro stroje pomocí parametru --json (nebo -j).

Jak Proton Drive CLI pomáhá?

Až dosud znamenalo používání Proton Drive jako součásti automatizovaného pracovního postupu — vedle nástrojů, jako jsou nasazovací skripty, zálohovací úlohy, cron nebo interní příručky — buď ruční práci (jako je otevření aplikace nebo přetahování souborů), nebo zpětné inženýrství vnitřního fungování disku za účelem psaní vlastních skriptů, které byly křehké a těžko udržovatelné. CLI to mění tím, že vám umožňuje spouštět operace Proton Drive přímo z terminálu. Může například nahrát soubory po dokončení sestavení, plánovaně zálohovat složku, pozvat recenzenta nebo zkontrolovat, co bylo sdíleno.

To je užitečné zejména tehdy, když potřebujete, aby k určité akci došlo v určitý čas, spíše než abyste udržovali složky neustále synchronizované, jako je například publikování souborů po vydání verze, pořízení snímku sdílené složky před auditem nebo odvolání přístupu, když někdo odchází z organizace. CLI provede operaci, sdělí vám, zda proběhla úspěšně, a ukončí se.

Je to skvělá volba pro každého, kdo již v terminálu pracuje, a pro týmy, které chtějí mít své pracovní postupy pro disk zapsané jako opakovatelné příkazy, spíše než jako řadu kliknutí, které si musí pamatovat.

Začněte s Proton Drive CLI

Při spuštění pokrývá CLI to nejdůležitější: přihlášení a odhlášení, procházení a správu souborů a složek (včetně koše) a také správu sdílení a pozvánek.

Několik typických postupů:

proton-drive auth login

# Nahrát soubory z místního adresáře do složky v Moje soubory
proton-drive filesystem upload ./reports/* /my-files/Reports --conflict-strategy skip

# Zkontrolovat, kdo má přístup, a poté pozvat kolegu
proton-drive sharing status /my-files/Reports
proton-drive sharing invite --user example@pm.me --role editor --message "Zkontrolujte prosím zprávy" /my-files/Reports

# Stáhnout do místního zálohovacího adresáře
proton-drive filesystem download /my-files/Reports ./backups

Pro úplnou sadu příkazů a přepínačů spusťte proton-drive help nebo proton-drive --help. Například proton-drive filesystem upload --help.

Zjistěte více o používání Proton Drive CLI.

Co bude následovat

Chystaná vylepšení Proton Drive CLI zahrnují podporu pro:

  • Fotografie a alba
  • Soubory a složky sdílené pomocí zabezpečeného veřejného odkazu
  • Podpora více účtů pro větší týmy a poskytovatele spravovaných služeb

Naším dlouhodobým cílem je přenést vše, co můžete dělat v aplikaci Proton Drive, do příkazového řádku.

Stáhnout Proton Drive CLI

Nejrychlejším způsobem, jak začít, je stáhnout si předpřipravené binární soubory pro vaši platformu:

V systémech macOS a Linux budete muset soubor po stažení nastavit jako spustitelný (chmod +x proton-drive). Jakmile to provedete, spusťte příkaz proton-drive version, abyste potvrdili sestavení.

Přihlášení probíhá přes prohlížeč — v příkazovém řádku nezadáváte žádné heslo. Vaše relace jsou bezpečně ukládány vaším operačním systémem (Správce přihlašovacích údajů systému Windows, Klíčenka v macOS nebo libsecret v Linuxu).

Sestavit ze zdrojového kódu

Dáváte přednost sestavení ze zdrojového kódu? CLI je implementováno v TypeScriptu, zabaleno pomocí nástroje Bun(nové okno) a je k dispozici ke stažení v repozitáři Drive SDK(nové okno). Po jeho naklonování můžete nainstalovat závislosti a sestavit CLI z hlavního adresáře:

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

Další podrobnosti naleznete v souboru README pro CLI v repozitáři.

Zásady poctivého využívání a limity četnosti

Proton Drive CLI se řídí stejnými zásadami poctivého využívání jako všichni klienti Proton Drive. Chcete-li se vejít do limitů, nahrávejte nebo stahujte pouze to, co se skutečně změnilo — nenahrávejte opakovaně stejné soubory ani nepřepisujte celé složky, pokud je nových pouze několik souborů. Účty, které generují neobvykle vysoký síťový provoz, jsou dočasně omezovány, aby byla služba chráněna pro všechny.

Nyní ve vašem terminálu, se stejnou úrovní soukromí

Proton Drive CLI je k dispozici již dnes a další funkce budou brzy následovat. Vše, co děláte přes terminál, je chráněno stejným koncovým šifrováním jako zbytek Proton Drive. Stáhněte si ho, vyzkoušejte a dejte nám vědět, co vytvoříte. A pokud používáte Linux: plnohodnotný desktopový klient se synchronizací je již na cestě.