Proton Drive CLI : utiliser Proton Drive depuis des scripts et un serveur
Depuis juin 2026, Proton propose un outil officiel en ligne de commande pour Proton Drive. Cet article décrit les commandes, la connexion sur les serveurs sans bureau, les stratégies de conflit pour les scripts et les limites par rapport à Rclone.
Le 9 juin 2026, Proton a publié la Proton Drive CLI, un outil officiel en ligne de commande pour Windows, macOS et Linux. Elle repose sur le même SDK que les applications Drive officielles, chiffre de bout en bout et est disponible sous la forme d’un unique fichier exécutable proton-drive. Le code source se trouve dans le dépôt public du SDK, sous cli/.
La CLI est conçue pour des opérations ponctuelles : téléverser des fichiers après un build, sauvegarder un dossier selon un calendrier, vérifier ou révoquer des partages. Elle ne synchronise pas en arrière-plan et ne monte pas de système de fichiers. La version actuelle est la 0.9.0 du 5 octobre 2026 ; son numéro de version montre que les commandes et options peuvent encore évoluer (la version 0.8.0 a renommé les stratégies de conflit avec un changement incompatible).
La présentation des autres options sous Linux (Rclone, client de bureau annoncé) figure dans l’article d’état Proton Drive sous Linux.
Vue d’ensemble des commandes
Les commandes sont organisées en groupes : proton-drive <gruppe> <befehl> [optionen] [argumente]. Les noms des groupes peuvent être abrégés tant qu’ils restent univoques ; pour filesystem, l’alias fs est également disponible. Sans argument, une interface interactive est lancée. L’aide complète est fournie par proton-drive help ou proton-drive <gruppe> <befehl> --help.
Les chemins dans Proton Drive sont toujours des chemins POSIX, y compris sous Windows. La racine / contient des zones virtuelles : /my-files (fichiers personnels), /devices (ordinateurs sauvegardés), /shared-by-me, /shared-with-me, /trash, ainsi que les zones Photos /photos, /albums, /photos-shared-by-me, /photos-shared-with-me et /photos-trash.
Installation sous Linux
Proton fournit les builds sur une page de téléchargement dédiée, chacun avec une somme de contrôle SHA-512. Il existe cinq variantes pour Linux :
| Build | Utilisation |
|---|---|
linux/x64 | Standard pour les systèmes x86-64 récents |
linux/x64-baseline | x86-64 sans AVX2, par exemple les NAS et processeurs de serveur plus anciens |
linux/arm64 | Serveurs ARM et ordinateurs monocarte avec glibc |
linux/x64-musl, linux/arm64-musl | Distributions utilisant musl plutôt que glibc, par exemple Alpine Linux et les images de conteneurs qui en dérivent |
Si le build standard s’interrompt au démarrage avec Illegal instruction, le processeur ne dispose pas de l’extension AVX2 ; le build x64-baseline est alors le bon choix. Le fichier intègre l’environnement d’exécution Bun et ne requiert aucune autre dépendance :
chmod +x proton-drive
sudo install -m 0755 proton-drive /usr/local/bin/proton-drive
proton-drive version
Sans droits administrateur, il suffit de copier le fichier dans ~/.local/bin, à condition que ce répertoire figure dans le PATH.
Connexion, même sur des serveurs sans bureau
auth login ne demande pas de mot de passe sur la ligne de commande. La CLI tente d’ouvrir un navigateur et affiche également l’URL de connexion. Cette URL peut être ouverte sur un autre appareil ; le terminal attend que la connexion y soit terminée. L’authentification à deux facteurs se déroule normalement dans le navigateur. La connexion fonctionne donc aussi via SSH sur un serveur sans interface graphique.
proton-drive auth login
Après une connexion réussie, la CLI enregistre la session, et non le mot de passe. Son emplacement est déterminé par la variable d’environnement PROTON_DRIVE_CREDENTIALS_STORE :
| Valeur | Emplacement de stockage |
|---|---|
keychain (par défaut) | Magasin de clés du système d’exploitation : Windows Credential Manager, macOS Keychain, sous Linux libsecret (GNOME Keyring, KWallet) |
pass | Entrée chiffrée par GPG ch.proton.drive/drive-sdk-cli/auth-session dans le gestionnaire de mots de passe pass |
unsafe_file | Fichier en clair auth-session.json dans le répertoire de données ; selon Proton, uniquement pour les tests |
Sur un serveur sans session de bureau, aucun trousseau libsecret déverrouillé n’est généralement disponible. Pour ce cas, l’option pass existe depuis la version 0.6.0. L’utilisateur sous lequel les scripts s’exécutent a besoin d’un magasin de mots de passe initialisé et d’une clé GPG que le gpg-agent peut déverrouiller sans saisie interactive. La session doit être retrouvée à chaque appel grâce à la même variable, qui doit donc aussi être définie dans les tâches Cron et les unités systemd :
export PROTON_DRIVE_CREDENTIALS_STORE=pass
proton-drive auth login
C’est un progrès par rapport à Rclone : le mot de passe et la clé TOTP ne se trouvent pas sur le serveur, et auth logout met fin à l’accès. La session conserve toutefois l’intégralité des droits du compte. Il n’existe aucune restriction à certains dossiers ni accès en lecture seule. Pour les tâches automatisées, un compte Proton distinct reste donc l’option la plus sûre.
Sous Linux, le cache, les données de l’application et les journaux se trouvent dans les répertoires XDG (~/.cache/proton-drive-cli, ~/.local/share/proton-drive-cli, ~/.local/state/proton-drive-cli). Avec PROTON_DRIVE_CACHE_DIR, les trois peuvent être placés dans un seul répertoire, par exemple pour un conteneur avec volume monté. Par défaut, la CLI écrit les journaux avec le niveau DEBUG ; PROTON_DRIVE_LOG_LEVEL=WARNING en réduit le volume.
Téléverser et télécharger dans des scripts
En mode interactif, la CLI demande quoi faire pour chaque conflit de nom. Cela n’est pas possible dans les scripts : avec --json, la question interactive est désactivée. Définissez donc toujours explicitement la stratégie de conflit pour les fichiers et les dossiers.
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 est le bon choix pour les sauvegardes : Proton Drive conserve les versions antérieures d’un fichier, et depuis la version 0.7.0, la CLI ignore automatiquement les fichiers dont le contenu n’a pas changé. La CLI ne fait toutefois pas de synchronisation : les fichiers supprimés localement restent dans Proton Drive. Pour obtenir un miroir avec suppressions, rclone sync reste nécessaire.
Le téléchargement fonctionne de manière symétrique. Les stratégies diffèrent parce que la partie locale est ici écrasée :
proton-drive filesystem download --json \
--file-conflict-strategy remove \
--folder-conflict-strategy merge \
/my-files/backup/berichte /srv/restore
La CLI ignore Proton Docs et Proton Sheets lors du téléchargement ; ils ne peuvent actuellement pas être exportés sous forme de fichiers.
Un téléversement régulier peut être planifié avec un timer systemd ou Cron. La sortie JSON peut ensuite être analysée avec jq, par exemple pour transmettre une alerte à la supervision.
Gérer les partages
Pour l’offboarding ou les audits, la gestion des partages est souvent plus utile que le transfert de fichiers. sharing status affiche pour un élément tous les membres, les invitations ouvertes et les paramètres d’un lien public :
proton-drive sharing status --json /my-files/projekte/kunde-a
Une invitation avec droits de lecture :
proton-drive sharing invite \
--user person@example.com \
--role viewer \
/my-files/projekte/kunde-a
Un lien public avec mot de passe et date d’expiration :
proton-drive sharing set-url \
--role viewer \
--password 'Linkpasswort' \
--expiration 2026-12-31 \
/my-files/projekte/kunde-a/bericht.pdf
Un mot de passe transmis sur la ligne de commande figure dans l’historique du shell et est visible dans la liste des processus pendant l’exécution. Dans les scripts, il doit donc provenir d’une variable ou d’un magasin de secrets. sharing remove-url supprime à nouveau le lien, sans affecter les membres directs ; sharing remove --user … révoque l’accès de personnes individuelles.
Takeout : export du compte
Depuis la version 0.9.0 du 5 octobre 2026, la CLI comprend la commande takeout run. Elle exporte une copie hors ligne du compte dans un dossier local, au choix avec --include my-files, devices, photos et revisions (toutes les versions antérieures des fichiers). Sans au moins une indication --include, elle n’exporte rien, et revisions nécessite my-files ou devices. Pour chaque dossier, elle écrit un fichier manifest.json qui décrit l’exportation ; le compte n’est pas modifié. La commande ne prend pas encore en charge Proton Docs et Proton Sheets. Pour une sauvegarde locale complète du contenu de Proton Drive, c’est la solution évidente.
Limites par rapport à Rclone
| Exigence | Proton Drive CLI 0.9.0 | Rclone (backend protondrive) |
|---|---|---|
| Prise en charge officielle | Oui, par Proton, Open Source | Non, ingénierie inverse, bêta |
| Connexion | Navigateur, même sur un autre appareil ; session dans le magasin de clés ou pass | Mot de passe et clé TOTP dans le fichier de configuration |
| Téléversement, téléchargement | Oui, avec stratégies de conflit et versionnage | Oui |
Miroir avec suppressions (sync) | Non | Oui |
| Monter un système de fichiers (FUSE) | Non | Oui |
| Partages, invitations, liens | Oui | Non |
| Proton Photos | Oui | Non |
| Accès aux droits limités | Non | Non |
Pour les sauvegardes, les artefacts de build et la gestion des partages, la CLI est le meilleur choix, car elle est officiellement prise en charge et ne nécessite pas de mot de passe enregistré. Pour un montage, comme celui dont a besoin par exemple une archive documentaire Paperless, et pour les miroirs avec suppressions, Rclone reste pour l’instant nécessaire. Dans les deux cas, la plus grande lacune reste la même : Proton ne propose pas d’accès machine pouvant être limité à certains dossiers ou à la lecture seule.
Historique des modifications
- 25 octobre 2026 : Mise à jour vers la version 0.9.0 du 5 octobre 2026. Ajout : la commande takeout run est désormais publiée, avec des indications sur les options —include nécessaires et l’absence de prise en charge de Proton Docs et Sheets.
Commentaires
Les commentaires sont chargés depuis GitHub / Giscus.