Proton Drive CLI: utilizzare Proton Drive da script e server
Da giugno 2026, Proton offre uno strumento ufficiale da riga di comando per Proton Drive. L'articolo descrive i comandi, l'accesso su server senza desktop, le strategie di conflitto per gli script e i limiti rispetto a Rclone.
Il 9 giugno 2026 Proton ha pubblicato la Proton Drive CLI, uno strumento ufficiale da riga di comando per Windows, macOS e Linux. Si basa sullo stesso SDK delle app ufficiali di Drive, cifra end-to-end ed è disponibile come singolo file eseguibile proton-drive. Il codice sorgente si trova nel repository SDK pubblico all’indirizzo cli/.
La CLI è pensata per singole operazioni eseguite in momenti specifici: caricare file dopo una build, eseguire il backup pianificato di una cartella, verificare o revocare condivisioni. Non sincronizza in background né monta un filesystem. La versione attuale è la 0.9.0 del 5 ottobre 2026; il numero di versione indica che comandi e opzioni possono ancora cambiare (la versione 0.8.0 ha rinominato le strategie di conflitto con una modifica incompatibile).
Il posizionamento rispetto alle altre opzioni Linux (Rclone, client desktop annunciato) è illustrato nell’articolo sullo stato Proton Drive su Linux.
Panoramica dei comandi
I comandi sono organizzati in gruppi: proton-drive <gruppe> <befehl> [optionen] [argumente]. I nomi dei gruppi possono essere abbreviati finché restano univoci; per filesystem è disponibile anche l’alias fs. Senza argomenti viene avviata una shell interattiva. La guida completa è disponibile con proton-drive help oppure proton-drive <gruppe> <befehl> --help.
I percorsi in Proton Drive sono sempre percorsi POSIX, anche su Windows. La radice / contiene aree virtuali: /my-files (file propri), /devices (computer sottoposti a backup), /shared-by-me, /shared-with-me, /trash e le aree Photos /photos, /albums, /photos-shared-by-me, /photos-shared-with-me e /photos-trash.
Installazione su Linux
Proton rende disponibili le build in una propria pagina di download, ciascuna con checksum SHA-512. Per Linux sono disponibili cinque varianti:
| Build | Utilizzo |
|---|---|
linux/x64 | Standard per sistemi x86-64 recenti |
linux/x64-baseline | x86-64 senza AVX2, ad esempio dispositivi NAS e CPU server meno recenti |
linux/arm64 | Server ARM e computer a scheda singola con glibc |
linux/x64-musl, linux/arm64-musl | Distribuzioni con musl anziché glibc, ad esempio Alpine Linux e immagini di container basate su di essa |
Se la build standard si interrompe all’avvio con Illegal instruction, alla CPU manca l’estensione AVX2; in tal caso la build x64-baseline è la scelta giusta. Il file include il runtime Bun e non richiede ulteriori dipendenze:
chmod +x proton-drive
sudo install -m 0755 proton-drive /usr/local/bin/proton-drive
proton-drive version
Senza diritti di amministratore è sufficiente copiare il file in ~/.local/bin, a condizione che questa directory sia nel PATH.
Accesso, anche su server senza desktop
auth login non richiede una password sulla riga di comando. La CLI tenta di aprire un browser e stampa anche l’URL di accesso. Questo URL può essere aperto su un altro dispositivo; il terminale attende finché l’accesso non viene completato lì. L’autenticazione a due fattori avviene normalmente nel browser. In questo modo l’accesso funziona anche via SSH su un server senza interfaccia grafica.
proton-drive auth login
Dopo l’accesso riuscito, la CLI salva la sessione, non la password. La sua posizione è determinata dalla variabile d’ambiente PROTON_DRIVE_CREDENTIALS_STORE:
| Valore | Posizione di archiviazione |
|---|---|
keychain (predefinito) | Archivio delle chiavi del sistema operativo: Windows Credential Manager, macOS Keychain, su Linux libsecret (GNOME Keyring, KWallet) |
pass | Voce cifrata con GPG ch.proton.drive/drive-sdk-cli/auth-session nel gestore di password pass |
unsafe_file | File di testo semplice auth-session.json nella directory dei dati; secondo Proton, solo per test |
Su un server senza sessione desktop di norma manca un portachiavi libsecret sbloccato. Per questo caso, dalla versione 0.6.0 è disponibile l’opzione pass. L’utente con cui vengono eseguiti gli script necessita di un password store inizializzato e di una chiave GPG che gpg-agent possa sbloccare senza input interattivo. La sessione deve essere trovata tramite la stessa variabile a ogni chiamata, quindi la variabile deve essere impostata anche nei job Cron e nelle unità systemd:
export PROTON_DRIVE_CREDENTIALS_STORE=pass
proton-drive auth login
Rispetto a Rclone, questo è un progresso: password e chiave TOTP non risiedono sul server e auth logout termina l’accesso. Tuttavia, la sessione continua ad avere l’intera portata dell’account. Non esiste una limitazione a singole cartelle o al solo accesso in lettura. Per i processi automatizzati, un account Proton separato resta quindi l’alternativa più sicura.
Cache, dati dell’applicazione e log si trovano su Linux nelle directory XDG (~/.cache/proton-drive-cli, ~/.local/share/proton-drive-cli, ~/.local/state/proton-drive-cli). Con PROTON_DRIVE_CACHE_DIR è possibile collocare tutti e tre in un’unica directory, ad esempio per un container con volume montato. Per impostazione predefinita, la CLI scrive i log con il livello DEBUG; PROTON_DRIVE_LOG_LEVEL=WARNING ne riduce la quantità.
Caricamento e download negli script
In modalità interattiva, la CLI chiede cosa fare a ogni conflitto di nome. Negli script non è possibile: con --json la richiesta interattiva viene disattivata. Definite quindi sempre esplicitamente la strategia di conflitto per file e cartelle.
proton-drive filesystem upload --json \
--file-conflict-strategy create-new-revision \
--folder-conflict-strategy merge \
--skip-thumbnails \
/srv/export/berichte /my-files/backup
create-new-revision è la scelta adatta per i backup: Proton Drive conserva le versioni precedenti di un file e, dalla versione 0.7.0, la CLI salta automaticamente i file con contenuto invariato. La CLI però non effettua un confronto: i file eliminati localmente restano in Proton Drive. Chi necessita di uno specchio con eliminazioni deve continuare a usare rclone sync.
Il download funziona in modo speculare. Le strategie differiscono perché qui viene sovrascritto il lato locale:
proton-drive filesystem download --json \
--file-conflict-strategy remove \
--folder-conflict-strategy merge \
/my-files/backup/berichte /srv/restore
La CLI salta Proton Docs e Proton Sheets durante il download; al momento non è possibile esportarli come file.
Un caricamento regolare può essere pianificato con un timer systemd o Cron. L’output JSON può poi essere analizzato con jq, ad esempio per inviare una notifica al monitoraggio.
Gestire le condivisioni
Per l’offboarding o gli audit, la gestione delle condivisioni è spesso più utile del trasferimento di file. sharing status mostra per un elemento tutti i membri, gli inviti aperti e le impostazioni di un link pubblico:
proton-drive sharing status --json /my-files/projekte/kunde-a
Un invito con diritti di lettura:
proton-drive sharing invite \
--user person@example.com \
--role viewer \
/my-files/projekte/kunde-a
Un link pubblico con password e data di scadenza:
proton-drive sharing set-url \
--role viewer \
--password 'Linkpasswort' \
--expiration 2026-12-31 \
/my-files/projekte/kunde-a/bericht.pdf
Una password passata sulla riga di comando viene memorizzata nella cronologia della shell ed è visibile nell’elenco dei processi durante l’esecuzione. Negli script dovrebbe quindi provenire da una variabile o da un archivio di segreti. sharing remove-url rimuove nuovamente il link senza interessare i membri diretti; sharing remove --user … revoca l’accesso a singole persone.
Takeout: esportazione dell’account
Dalla versione 0.9.0 del 5 ottobre 2026, la CLI include il comando takeout run. Esporta una copia offline dell’account in una cartella locale, opzionalmente con --include my-files, devices, photos e revisions (tutte le versioni precedenti dei file). Senza almeno un’indicazione --include non esporta nulla e revisions richiede my-files o devices. Per ogni cartella scrive un file manifest.json che descrive l’esportazione; non modifica nulla nell’account. Il comando non supporta ancora Proton Docs e Proton Sheets. Per un backup locale completo del contenuto di Proton Drive, è la soluzione più ovvia.
Limiti rispetto a Rclone
| Requisito | Proton Drive CLI 0.9.0 | Rclone (backend protondrive) |
|---|---|---|
| Supporto ufficiale | Sì, da Proton, open source | No, reverse engineering, beta |
| Accesso | Browser, anche su un altro dispositivo; sessione nel portachiavi o in pass | Password e chiave TOTP nel file di configurazione |
| Caricamento, download | Sì, con strategie di conflitto e versionamento | Sì |
Specchio con eliminazioni (sync) | No | Sì |
| Montare un filesystem (FUSE) | No | Sì |
| Condivisioni, inviti, link | Sì | No |
| Proton Photos | Sì | No |
| Accesso con portata limitata | No | No |
Per backup, artefatti di build e gestione delle condivisioni, la CLI è la scelta migliore perché è supportata ufficialmente e non richiede una password memorizzata. Per un mount, come quello necessario ad esempio per un archivio documentale Paperless, e per le sincronizzazioni speculari con eliminazioni, Rclone resta per ora necessario. In entrambi i casi, la lacuna maggiore rimane la stessa: Proton non offre un accesso macchina limitabile a singole cartelle o al solo accesso in lettura.
Cronologia delle modifiche
- 25 ottobre 2026: aggiornato alla versione 0.9.0 del 5 ottobre 2026. Aggiunto: il comando takeout run è ora pubblicato, incluse le indicazioni sulle necessarie opzioni —include e sul supporto mancante per Proton Docs e Sheets.
Commenti
I commenti vengono caricati da GitHub / Giscus.