Proton Drive CLI: använd Proton Drive från skript och servern
Sedan juni 2026 erbjuder Proton ett officiellt kommandoradsverktyg för Proton Drive. Artikeln beskriver kommandon, inloggning på servrar utan skrivbordsmiljö, konfliktstrategier för skript och begränsningarna jämfört med Rclone.
Den 9 juni 2026 släppte Proton Proton Drive CLI, ett officiellt kommandoradsverktyg för Windows, macOS och Linux. Det bygger på samma SDK som de officiella Drive-apparna, krypterar end-to-end och finns som en enskild körbar fil proton-drive. Källkoden finns i det offentliga SDK-repositoriet på cli/.
CLI:n är avsedd för enskilda, tidsbestämda åtgärder: ladda upp filer efter en build, säkerhetskopiera en mapp enligt ett schema, granska eller återkalla delningar. Den synkroniserar inte i bakgrunden och monterar inget filsystem. Den aktuella versionen är 0.9.0 från 5 oktober 2026; versionsnumret visar att kommandon och alternativ fortfarande kan ändras (version 0.8.0 döpte om konfliktstrategierna med en inkompatibel ändring).
En jämförelse med övriga Linux-alternativ (Rclone, annonserad skrivbordsklient) finns i statusartikeln Proton Drive på Linux.
Kommandoöversikt
Kommandona är organiserade i grupper: proton-drive <gruppe> <befehl> [optionen] [argumente]. Gruppnamn kan förkortas så länge de förblir entydiga; för filesystem finns dessutom aliaset fs. Utan argument startar ett interaktivt skal. Fullständig hjälp fås med proton-drive help respektive proton-drive <gruppe> <befehl> --help.
Sökvägarna i Proton Drive är alltid POSIX-sökvägar, även i Windows. Roten / innehåller virtuella områden: /my-files (egna filer), /devices (säkerhetskopierade datorer), /shared-by-me, /shared-with-me, /trash samt Photos-områdena /photos, /albums, /photos-shared-by-me, /photos-shared-with-me och /photos-trash.
Installation på Linux
Proton tillhandahåller byggen på en egen nedladdningssida, vart och ett med SHA-512-kontrollsumma. För Linux finns fem varianter:
| Build | Användning |
|---|---|
linux/x64 | Standard för moderna x86-64-system |
linux/x64-baseline | x86-64 utan AVX2, till exempel NAS-enheter och äldre server-CPU:er |
linux/arm64 | ARM-servrar och enkortsdatorer med glibc |
linux/x64-musl, linux/arm64-musl | Distributioner med musl i stället för glibc, till exempel Alpine Linux och containeravbildningar baserade på det |
Om standardbygget avbryts vid start med Illegal instruction saknar CPU:n AVX2-tillägget; då är bygget x64-baseline rätt val. Filen har Bun-körtiden inbäddad och behöver inga ytterligare beroenden:
chmod +x proton-drive
sudo install -m 0755 proton-drive /usr/local/bin/proton-drive
proton-drive version
Utan administratörsrättigheter räcker det att kopiera filen till ~/.local/bin, förutsatt att denna katalog finns i PATH.
Inloggning, även på servrar utan skrivbordsmiljö
auth login frågar inte efter något lösenord på kommandoraden. CLI:n försöker öppna en webbläsare och visar även inloggnings-URL:en. Denna URL kan öppnas på en annan enhet; terminalen väntar tills inloggningen där är slutförd. Tvåfaktorsautentiseringen sker som vanligt i webbläsaren. Därmed fungerar inloggningen även via SSH på en server utan grafiskt gränssnitt.
proton-drive auth login
Efter lyckad inloggning sparar CLI:n sessionen, inte lösenordet. Var den lagras bestäms av miljövariabeln PROTON_DRIVE_CREDENTIALS_STORE:
| Värde | Lagringsplats |
|---|---|
keychain (standard) | Operativsystemets nyckellager: Windows Credential Manager, macOS Keychain, i Linux libsecret (GNOME Keyring, KWallet) |
pass | GPG-krypterad post ch.proton.drive/drive-sdk-cli/auth-session i lösenordshanteraren pass |
unsafe_file | Klartextfilen auth-session.json i datakatalogen; enligt Proton endast för tester |
På en server utan skrivbordssession saknas normalt en upplåst libsecret-nyckelring. För detta fall finns alternativet pass sedan version 0.6.0. Användaren som skripten körs under behöver för detta en initierad lösenordsbutik och en GPG-nyckel som gpg-agent kan låsa upp utan interaktiv inmatning. Sessionen måste hittas via samma variabel vid varje anrop, alltså även vara angiven i Cron-jobb och systemd-enheter:
export PROTON_DRIVE_CREDENTIALS_STORE=pass
proton-drive auth login
Jämfört med Rclone är detta ett framsteg: lösenord och TOTP-nyckel finns inte på servern, och auth logout avslutar åtkomsten. Sessionen har dock fortfarande hela kontots omfattning. Det finns ingen begränsning till enskilda mappar eller skrivskyddad åtkomst. För automatiserade flöden förblir därför ett separat Proton-konto det säkrare alternativet.
Cache, applikationsdata och loggar finns i Linux i XDG-katalogerna (~/.cache/proton-drive-cli, ~/.local/share/proton-drive-cli, ~/.local/state/proton-drive-cli). Med PROTON_DRIVE_CACHE_DIR kan alla tre placeras i en enda katalog, exempelvis för en container med monterad volym. CLI:n skriver som standard loggar med nivån DEBUG; PROTON_DRIVE_LOG_LEVEL=WARNING minskar mängden.
Uppladdning och nedladdning i skript
Interaktivt frågar CLI:n vid varje namnkonflikt vad som ska ske. I skript är det inte möjligt: med --json är den interaktiva frågan avstängd. Ange därför alltid konfliktstrategin för filer och mappar uttryckligen.
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 är rätt val för säkerhetskopior: Proton Drive behåller tidigare versioner av en fil, och CLI:n hoppar automatiskt över filer med oförändrat innehåll sedan version 0.7.0. CLI:n synkroniserar dock inte: lokalt raderade filer finns kvar i Proton Drive. Den som behöver en spegel med raderingar är fortfarande hänvisad till rclone sync.
Nedladdning fungerar spegelvänt. Strategierna skiljer sig åt eftersom den lokala sidan skrivs över här:
proton-drive filesystem download --json \
--file-conflict-strategy remove \
--folder-conflict-strategy merge \
/my-files/backup/berichte /srv/restore
CLI:n hoppar över Proton Docs och Proton Sheets vid nedladdning; de kan för närvarande inte exporteras som filer.
En regelbunden uppladdning kan schemaläggas med en systemd-timer eller Cron. JSON-utdata kan sedan utvärderas med jq, exempelvis för ett meddelande till övervakningen.
Hantera delningar
För offboarding eller revisioner är delningshanteringen ofta mer användbar än filöverföring. sharing status visar alla medlemmar, öppna inbjudningar och inställningarna för en offentlig länk för ett objekt:
proton-drive sharing status --json /my-files/projekte/kunde-a
En inbjudan med läsrättigheter:
proton-drive sharing invite \
--user person@example.com \
--role viewer \
/my-files/projekte/kunde-a
En offentlig länk med lösenord och utgångsdatum:
proton-drive sharing set-url \
--role viewer \
--password 'Linkpasswort' \
--expiration 2026-12-31 \
/my-files/projekte/kunde-a/bericht.pdf
Ett lösenord som anges på kommandoraden finns i skalhistoriken och syns i processlistan medan körningen pågår. I skript bör det därför komma från en variabel eller ett hemlighetslager. sharing remove-url tar bort länken utan att påverka direkta medlemmar; sharing remove --user … återkallar åtkomsten för enskilda personer.
Takeout: export av kontot
Sedan version 0.9.0 från 5 oktober 2026 innehåller CLI:n kommandot takeout run. Det exporterar en offlinekopia av kontot till en lokal mapp, valfritt med --include my-files, devices, photos och revisions (alla tidigare filversioner). Utan minst en --include-angivelse exporterar det ingenting, och revisions förutsätter my-files eller devices. För varje mapp skriver det en manifest.json som beskriver exporten; kontot ändras inte. Kommandot stöder ännu inte Proton Docs och Proton Sheets. För en fullständig lokal säkerhetskopia av Proton Drive-innehållet är det den naturliga vägen.
Begränsningar jämfört med Rclone
| Krav | Proton Drive CLI 0.9.0 | Rclone (protondrive-backend) |
|---|---|---|
| Officiellt stödd | Ja, av Proton, öppen källkod | Nej, reverse engineering, beta |
| Inloggning | Webbläsare, även på en annan enhet; session i nyckellagret eller pass | Lösenord och TOTP-nyckel i konfigurationsfilen |
| Uppladdning, nedladdning | Ja, med konfliktstrategier och versionshantering | Ja |
Spegel med raderingar (sync) | Nej | Ja |
| Montera filsystem (FUSE) | Nej | Ja |
| Delningar, inbjudningar, länkar | Ja | Nej |
| Proton Photos | Ja | Nej |
| Åtkomst med begränsad omfattning | Nej | Nej |
För säkerhetskopior, buildartefakter och delningshantering är CLI:n det bättre valet, eftersom den stöds officiellt och inte kräver något sparat lösenord. För en montering, som exempelvis ett Paperless-dokumentarkiv behöver, och för speglingar med raderingar är Rclone tills vidare nödvändigt. Den största luckan är densamma i båda fallen: Proton erbjuder ingen maskinåtkomst som kan begränsas till enskilda mappar eller läsbehörighet.
Ändringshistorik
- 25 oktober 2026: Uppdaterat till version 0.9.0 från 5 oktober 2026. Tillagt: Kommandot takeout run har därmed släppts, inklusive information om nödvändiga —include-angivelser och avsaknaden av stöd för Proton Docs och Sheets.
Kommentarer
Kommentarerna hämtas från GitHub / Giscus.