Proton Drive CLI: Bruk Proton Drive fra skript og serveren
Siden juni 2026 har Proton tilbudt et offisielt kommandolinjeverktøy for Proton Drive. Artikkelen beskriver kommandoer, innlogging på servere uten skrivebordsmiljø, konfliktstrategier for skript og begrensningene sammenlignet med Rclone.
- juni 2026 lanserte Proton Proton Drive CLI, et offisielt kommandolinjeverktøy for Windows, macOS og Linux. Det er basert på samme SDK som de offisielle Drive-appene, krypterer ende-til-ende og er tilgjengelig som én enkelt kjørbar fil
proton-drive. Kildekoden ligger i det offentlige SDK-repositoriet påcli/.
CLI-en er beregnet for enkeltstående, tidsavgrensede oppgaver: laste opp filer etter en build, sikkerhetskopiere en mappe etter en tidsplan, kontrollere eller trekke tilbake delinger. Den synkroniserer ikke i bakgrunnen og monterer ikke et filsystem. Den aktuelle versjonen er 0.9.0 fra 5. oktober 2026; versjonsnummeret viser at kommandoer og alternativer fortsatt kan endres (versjon 0.8.0 ga konfliktstrategiene nye navn i en inkompatibel endring).
Plasseringen blant de øvrige Linux-alternativene (Rclone, annonsert desktop-klient) finnes i statusartikkelen Proton Drive på Linux.
Kommandooversikt
Kommandoene er organisert i grupper: proton-drive <gruppe> <befehl> [optionen] [argumente]. Gruppenavn kan forkortes så lenge de fortsatt er entydige; for filesystem finnes det i tillegg aliaset fs. Uten argumenter starter en interaktiv shell. Fullstendig hjelp får du med proton-drive help eller proton-drive <gruppe> <befehl> --help.
Stiene i Proton Drive er alltid POSIX-stier, også i Windows. Roten / inneholder virtuelle områder: /my-files (egne filer), /devices (sikkerhetskopierte datamaskiner), /shared-by-me, /shared-with-me, /trash samt Photos-områdene /photos, /albums, /photos-shared-by-me, /photos-shared-with-me og /photos-trash.
Installasjon på Linux
Proton tilbyr buildene på en egen nedlastingsside, hver med SHA-512-kontrollsum. For Linux finnes fem varianter:
| Build | Bruk |
|---|---|
linux/x64 | Standard for moderne x86-64-systemer |
linux/x64-baseline | x86-64 uten AVX2, for eksempel NAS-enheter og eldre server-CPU-er |
linux/arm64 | ARM-servere og enkelkortmaskiner med glibc |
linux/x64-musl, linux/arm64-musl | Distribusjoner med musl i stedet for glibc, for eksempel Alpine Linux og container-images basert på dette |
Hvis standard-builden avsluttes ved oppstart med Illegal instruction, mangler CPU-en AVX2-utvidelsen; da er builden x64-baseline riktig valg. Filen har Bun-runtime innebygd og trenger ingen andre avhengigheter:
chmod +x proton-drive
sudo install -m 0755 proton-drive /usr/local/bin/proton-drive
proton-drive version
Uten administratorrettigheter holder det å kopiere filen til ~/.local/bin, så lenge denne katalogen ligger i PATH.
Innlogging, også på servere uten skrivebordsmiljø
auth login ber ikke om passord på kommandolinjen. CLI-en prøver å åpne en nettleser og oppgir også innloggings-URL-en. Denne URL-en kan åpnes på en annen enhet; terminalen venter til innloggingen er fullført der. Tofaktorautentiseringen foregår da som normalt i nettleseren. Dermed fungerer innlogging også via SSH på en server uten grafisk brukergrensesnitt.
proton-drive auth login
Etter vellykket innlogging lagrer CLI-en økten, ikke passordet. Hvor den ligger, bestemmes av miljøvariabelen PROTON_DRIVE_CREDENTIALS_STORE:
| Verdi | Lagringssted |
|---|---|
keychain (standard) | Operativsystemets nøkkellager: Windows Credential Manager, macOS Keychain, under Linux libsecret (GNOME Keyring, KWallet) |
pass | GPG-kryptert oppføring ch.proton.drive/drive-sdk-cli/auth-session i passordbehandleren pass |
unsafe_file | Klartekstfilen auth-session.json i datakatalogen; ifølge Proton kun for testing |
På en server uten skrivebordssesjon mangler det normalt en opplåst libsecret-nøkkelring. For dette tilfellet finnes alternativet pass siden versjon 0.6.0. Brukeren som kjører skriptene, trenger da et initialisert passordlager og en GPG-nøkkel som gpg-agent kan låse opp uten interaktiv inndata. Økten må finnes via den samme variabelen ved hvert kall, så den må også være satt i Cron-jobber og systemd-enheter:
export PROTON_DRIVE_CREDENTIALS_STORE=pass
proton-drive auth login
Sammenlignet med Rclone er dette et fremskritt: Passord og TOTP-nøkkel ligger ikke på serveren, og auth logout avslutter tilgangen. Økten har likevel fortsatt fullt omfang av kontoen. Det finnes ingen begrensning til enkeltmapper eller skrivebeskyttet tilgang. For automatiserte prosesser er derfor en egen Proton-konto fortsatt det sikrere alternativet.
Hurtigbuffer, applikasjonsdata og logger ligger under Linux i XDG-katalogene (~/.cache/proton-drive-cli, ~/.local/share/proton-drive-cli, ~/.local/state/proton-drive-cli). Med PROTON_DRIVE_CACHE_DIR kan alle tre legges i én enkelt katalog, for eksempel for en container med et montert volum. CLI-en skriver logger på nivået DEBUG som standard; PROTON_DRIVE_LOG_LEVEL=WARNING reduserer mengden.
Opplasting og nedlasting i skript
Interaktivt spør CLI-en ved hver navnekonflikt hva som skal skje. Dette er ikke mulig i skript: Med --json er den interaktive forespørselen deaktivert. Angi derfor alltid konfliktstrategien eksplisitt for filer og mapper.
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 er riktig valg for sikkerhetskopiering: Proton Drive beholder tidligere versjoner av en fil, og siden versjon 0.7.0 hopper CLI-en automatisk over filer med uendret innhold. CLI-en synkroniserer imidlertid ikke: Filer som slettes lokalt, blir værende i Proton Drive. De som trenger et speil med slettinger, er fortsatt avhengige av rclone sync.
Nedlasting fungerer speilvendt. Strategiene er forskjellige fordi den lokale siden her overskrives:
proton-drive filesystem download --json \
--file-conflict-strategy remove \
--folder-conflict-strategy merge \
/my-files/backup/berichte /srv/restore
CLI-en hopper over Proton Docs og Proton Sheets ved nedlasting; de kan foreløpig ikke eksporteres som filer.
En regelmessig opplasting kan planlegges med en systemd-timer eller Cron. JSON-utdataene kan deretter evalueres med jq, for eksempel for en melding til overvåkingen.
Administrere delinger
For offboarding eller revisjoner er delingsadministrasjon ofte mer nyttig enn filoverføring. sharing status viser alle medlemmer, åpne invitasjoner og innstillingene for en offentlig lenke for et element:
proton-drive sharing status --json /my-files/projekte/kunde-a
En invitasjon med leserettigheter:
proton-drive sharing invite \
--user person@example.com \
--role viewer \
/my-files/projekte/kunde-a
En offentlig lenke med passord og utløpsdato:
proton-drive sharing set-url \
--role viewer \
--password 'Linkpasswort' \
--expiration 2026-12-31 \
/my-files/projekte/kunde-a/bericht.pdf
Et passord som oppgis på kommandolinjen, havner i shell-historikken og er synlig i prosesslisten mens kommandoen kjører. I skript bør det derfor komme fra en variabel eller en hemmelighetslagring. sharing remove-url fjerner lenken uten å påvirke direkte medlemmer; sharing remove --user … trekker tilbake tilgangen for enkeltpersoner.
Takeout: eksport av kontoen
Siden versjon 0.9.0 fra 5. oktober 2026 inneholder CLI-en kommandoen takeout run. Den eksporterer en frakoblet kopi av kontoen til en lokal mappe, valgfritt med --include my-files, devices, photos og revisions (alle tidligere filversjoner). Uten minst én --include-angivelse eksporterer den ingenting, og revisions forutsetter my-files eller devices. For hver mappe skriver den en manifest.json som beskriver eksporten; den endrer ingenting på kontoen. Kommandoen støtter ennå ikke Proton Docs og Proton Sheets. For en fullstendig lokal sikkerhetskopi av innholdet i Proton Drive er dette den nærliggende løsningen.
Begrensninger sammenlignet med Rclone
| Krav | Proton Drive CLI 0.9.0 | Rclone (protondrive-backend) |
|---|---|---|
| Offisielt støttet | Ja, av Proton, åpen kildekode | Nei, reverse engineering, beta |
| Innlogging | Nettleser, også på en annen enhet; økt i nøkkellageret eller pass | Passord og TOTP-nøkkel i konfigurasjonsfilen |
| Opplasting, nedlasting | Ja, med konfliktstrategier og versjonering | Ja |
Speil med slettinger (sync) | Nei | Ja |
| Montere filsystem (FUSE) | Nei | Ja |
| Delinger, invitasjoner, lenker | Ja | Nei |
| Proton Photos | Ja | Nei |
| Tilgang med begrenset omfang | Nei | Nei |
For sikkerhetskopiering, build-artefakter og delingsadministrasjon er CLI-en det bedre valget, fordi den er offisielt støttet og fungerer uten lagret passord. For en mount, slik som et Paperless-dokumentarkiv trenger, og for speiling med slettinger er Rclone foreløpig fortsatt nødvendig. Det største gapet er det samme i begge tilfeller: Proton tilbyr ingen maskintilgang som kan begrenses til enkeltmapper eller lesetilgang.
Endringslogg
- 25. oktober 2026: Oppdatert til versjon 0.9.0 fra 5. oktober 2026. Lagt til: Kommandoen takeout run er nå publisert, inkludert merknader om nødvendige —include-angivelser og manglende støtte for Proton Docs og Sheets.
Kommentarer
Kommentarene lastes inn fra GitHub / Giscus.