Mit rclone auf Ende-zu-Ende-verschlüsselte Ordner zugreifen
Der OpenCloud Web Client verschlüsselt Ende-zu-Ende-verschlüsselte Ordner im Format rclone crypt. Sie können einen solchen Ordner daher mit rclone auf Ihrem Computer einbinden. Der eingebundene Ordner verhält sich wie ein lokaler Ordner: Sie können Dateien mit Ihren gewohnten Anwendungen öffnen, bearbeiten und hinzufügen, während die Dateiinhalte und -namen auf dem OpenCloud-Server verschlüsselt bleiben.
Dateien werden auf Ihrem Computer verschlüsselt, bevor rclone sie hochlädt. Dateien, die über die Einbindung erstellt wurden, können im OpenCloud Web Client geöffnet werden. Dateien, die im Web Client erstellt wurden, können über die Einbindung geöffnet werden.
Diese Anleitung basiert auf OpenCloud 9.0.0 und richtet sich an Benutzer, die mit der Kommandozeile vertraut sind.
Übersicht
Die Einrichtung umfasst folgende Schritte:
- Erstellen Sie im OpenCloud Web Client den verschlüsselten Ordner.
- Installieren Sie rclone auf Ihrem Computer.
- Erstellen Sie ein App-Token in OpenCloud.
- Rufen Sie die WebDAV-URL des verschlüsselten Ordners ab.
- Erstellen Sie ein WebDAV-Remote in rclone.
- Erstellen Sie ein crypt-Remote zur Entschlüsselung.
- Binden Sie den verschlüsselten Ordner ein.
Voraussetzungen
Sie benötigen:
- einen Ende-zu-Ende-verschlüsselten Ordner in OpenCloud und dessen Passwort
- ein OpenCloud App-Token
- die WebDAV-URL des verschlüsselten Ordners
Für die Einrichtung werden zwei aufeinander aufbauende rclone-Remotes verwendet:
| Remote-Typ | Beispielname | Zweck |
|---|---|---|
| WebDAV | opencloud-e2ee | Stellt die Verbindung zum verschlüsselten .vault-Ordner in OpenCloud her |
crypt | opencloud-decrypted | Ermöglicht den entschlüsselten Zugriff auf die Ordnerinhalte |
opencloud-e2ee und opencloud-decrypted sind Beispielnamen. Sie können beliebige Namen für die Remotes wählen. Entscheidend ist, dass Sie die gewählten Namen in der gesamten Konfiguration und in allen Befehlen einheitlich verwenden.
Bewahren Sie das Passwort des verschlüsselten Ordners sicher auf. OpenCloud kann es weder zurücksetzen noch wiederherstellen. Wenn Sie das Passwort verlieren, verlieren Sie dauerhaft den Zugriff auf den verschlüsselten Ordner und dessen Inhalte.
Das App-Token und das Passwort des verschlüsselten Ordners sind separate Anmeldedaten für unterschiedliche Zwecke:
| Anmeldedaten | Zweck |
|---|---|
| OpenCloud App-Token | Authentifiziert die WebDAV-Verbindung |
| Passwort des verschlüsselten Ordners | Wird von rclone crypt zum Ver- und Entschlüsseln der Ordnerinhalte verwendet |
Verwenden Sie weder das App-Token als crypt-Passwort noch das Passwort des verschlüsselten Ordners als WebDAV-Passwort.
rclone installieren
Für die Einbindung benötigen Sie je nach Betriebssystem rclone und eine FUSE- oder NFS-Komponente.
- Linux
- macOS
- Windows
Installieren Sie rclone mit dem offiziellen Installationsskript:
sudo -v ; curl https://rclone.org/install.sh | sudo bash
Installieren Sie FUSE 3, beispielsweise unter Debian und Ubuntu:
sudo apt install fuse3
Weitere Installationsmethoden finden Sie in der rclone-Installationsanleitung.
Installieren Sie rclone mit dem offiziellen Installationsskript:
sudo -v ; curl https://rclone.org/install.sh | sudo bash
Installieren Sie rclone nicht mit Homebrew. Die Homebrew-Version von rclone unterstützt das Einbinden nicht.
Es ist keine zusätzliche Software erforderlich. Unter macOS verwendet diese Anleitung rclone nfsmount, das den Ordner über einen integrierten NFS-Server einbindet.
Weitere Installationsmethoden finden Sie in der rclone-Installationsanleitung.
Installieren Sie rclone und WinFsp in PowerShell:
winget install Rclone.Rclone
winget install WinFsp.WinFsp
WinFsp ist zum Einbinden von Ordnern unter Windows erforderlich. Öffnen Sie nach der Installation ein neues PowerShell-Fenster, damit der Befehl rclone verfügbar ist.
Weitere Installationsmethoden finden Sie in der rclone-Installationsanleitung.
Überprüfen Sie die Installation:
rclone version
App-Token erstellen
Erstellen Sie in Ihren OpenCloud-Kontoeinstellungen ein eigenes App-Token für rclone. Kopieren Sie es, sobald es angezeigt wird, da es später nicht erneut angezeigt werden kann.
Eine ausführliche Anleitung finden Sie unter App-Tokens.
Das App-Token wird als Passwort für das WebDAV-Remote verwendet. Es ist nicht das Passwort des verschlüsselten Ordners. Das Passwort Ihres OpenCloud-Kontos funktioniert nicht mit rclone.
WebDAV-URL abrufen
Aktivieren Sie in Ihren OpenCloud-Kontoeinstellungen „WebDAV-Informationen in der Detailansicht anzeigen“, öffnen Sie das Detail-Panel des verschlüsselten Ordners und kopieren Sie dessen WebDAV-URL. Eine allgemeine Anleitung finden Sie unter Über WebDAV mit einem Space verbinden.
Die URL muss auf den verschlüsselten .vault-Ordner verweisen, zum Beispiel:
https://cloud.example.com/dav/spaces/<space-id>/Encrypted.vault
WebDAV-Remote konfigurieren
Führen Sie rclone config aus und erstellen Sie ein WebDAV-Remote. In dieser Anleitung wird opencloud-e2ee als Beispielname verwendet. Verwenden Sie:
- die WebDAV-URL des verschlüsselten Ordners als URL
infinitescaleals Anbieter- Ihren OpenCloud-Benutzernamen als Benutzer
- Ihr OpenCloud App-Token als Passwort
Wenn rclone Passwörter in seine Konfiguration schreibt, speichert es sie in verschleierter Form. Wenn Sie die Konfiguration manuell bearbeiten, erstellen Sie den Wert für pass mit rclone obscure. Führen Sie rclone config file aus, um die Konfigurationsdatei auf Ihrem System zu finden.
Die resultierende Konfiguration sollte ungefähr so aussehen:
[opencloud-e2ee]
type = webdav
url = https://cloud.example.com/dav/spaces/<space-id>/Encrypted.vault
vendor = infinitescale
user = <username>
pass = <obscured-app-token>
Weitere Informationen zu den Backend-Optionen finden Sie in der rclone-WebDAV-Dokumentation.
Testen Sie die WebDAV-Verbindung, bevor Sie fortfahren:
rclone ls opencloud-e2ee:
Ersetzen Sie opencloud-e2ee durch den Namen Ihres WebDAV-Remotes, falls Sie einen anderen Namen gewählt haben.
Wenn die Verbindung funktioniert, zeigt rclone möglicherweise verschlüsselte Dateinamen an. Beim WebDAV-Remote ist dies zu erwarten.
Verschlüsseltes Remote konfigurieren
Das crypt-Remote stellt nicht direkt eine Verbindung zu OpenCloud her. Es ergänzt das vorhandene WebDAV-Remote um Ver- und Entschlüsselung. Erstellen und testen Sie zuerst das WebDAV-Remote.
Erstellen Sie ein zweites Remote mit dem crypt-Backend. In dieser Anleitung wird opencloud-decrypted als Beispielname verwendet. Konfigurieren Sie es wie folgt:
- Setzen Sie
remoteauf den exakten Namen Ihres WebDAV-Remotes, gefolgt von einem Doppelpunkt. - Setzen Sie
filename_encryptionaufstandard. - Aktivieren Sie
directory_name_encryption. - Verwenden Sie das Passwort des verschlüsselten Ordners als
password. - Konfigurieren Sie keinen zusätzlichen Wert für
password2.
Die resultierende Konfiguration sollte ungefähr so aussehen:
[opencloud-decrypted]
type = crypt
remote = opencloud-e2ee:
filename_encryption = standard
directory_name_encryption = true
password = <obscured-folder-password>
Der Wert remote besteht immer aus dem exakten Namen des WebDAV-Remotes, gefolgt von :. Geben Sie in diesem Feld nicht die WebDAV-URL ein.
Wenn Sie die Konfiguration manuell bearbeiten, erstellen Sie den Wert für password mit rclone obscure. Weitere Informationen zu den Backend-Optionen finden Sie in der rclone-crypt-Dokumentation.
Die in der rclone-Konfigurationsdatei gespeicherten Passwörter sind lediglich verschleiert und nicht sicher verschlüsselt. Schützen Sie die Konfigurationsdatei vor unbefugtem Zugriff.
Testen Sie das verschlüsselte Remote:
rclone ls opencloud-decrypted:
Ersetzen Sie opencloud-decrypted durch den Namen Ihres crypt-Remotes, falls Sie einen anderen Namen gewählt haben.
rclone sollte die ursprünglichen Dateinamen anzeigen. Wenn verschlüsselte Dateinamen angezeigt werden, lesen Sie Verschlüsselte Dateinamen werden angezeigt.
Verschlüsselten Ordner einbinden
Binden Sie das crypt-Remote ein, nicht das WebDAV-Remote. Nur das crypt-Remote entschlüsselt die Ordnerinhalte.
- Linux
- macOS
- Windows
Erstellen Sie einen leeren Ordner als Einhängepunkt:
mkdir -p ~/OpenCloud-Encrypted
Binden Sie den verschlüsselten Ordner ein:
rclone mount opencloud-decrypted: ~/OpenCloud-Encrypted --vfs-cache-mode writes
Der Ordner bleibt eingebunden, solange der Befehl ausgeführt wird. Lassen Sie das Terminal geöffnet, während Sie mit den Dateien arbeiten.
Fügen Sie --daemon hinzu, um die Einbindung im Hintergrund auszuführen:
rclone mount opencloud-decrypted: ~/OpenCloud-Encrypted --vfs-cache-mode writes --daemon
Erstellen Sie einen leeren Ordner als Einhängepunkt:
mkdir -p ~/OpenCloud-Encrypted
Binden Sie den verschlüsselten Ordner ein:
rclone nfsmount opencloud-decrypted: ~/OpenCloud-Encrypted --vfs-cache-mode writes
Der Ordner bleibt eingebunden, solange der Befehl ausgeführt wird. Lassen Sie das Terminal geöffnet, während Sie mit den Dateien arbeiten. Der eingebundene Ordner wird auch im Finder angezeigt.
Fügen Sie --daemon hinzu, um die Einbindung im Hintergrund auszuführen:
rclone nfsmount opencloud-decrypted: ~/OpenCloud-Encrypted --vfs-cache-mode writes --daemon
Binden Sie den verschlüsselten Ordner in PowerShell als Laufwerk X: ein:
rclone mount opencloud-decrypted: X: --vfs-cache-mode writes
Verwenden Sie einen noch nicht belegten Laufwerksbuchstaben. Soll rclone einen freien Laufwerksbuchstaben auswählen, verwenden Sie * anstelle von X:.
Das Laufwerk bleibt eingebunden, solange der Befehl ausgeführt wird. Lassen Sie das PowerShell-Fenster geöffnet, während Sie mit den Dateien arbeiten. Das Laufwerk wird im Datei-Explorer angezeigt.
Ersetzen Sie opencloud-decrypted durch den Namen Ihres crypt-Remotes, falls Sie einen anderen Namen gewählt haben.
Eine rclone-Einbindung ermöglicht den Zugriff auf Dateien über ein virtuelles Dateisystem. Sie erstellt keine vollständig synchronisierte lokale Kopie. Für den Zugriff auf noch nicht zwischengespeicherte Dateien ist eine aktive Verbindung zu OpenCloud erforderlich.
--vfs-cache-mode writes puffert geänderte Dateien auf Ihrem Computer, bevor sie hochgeladen werden. Die meisten Anwendungen benötigen diese Option, um Dateien im eingebundenen Ordner zu bearbeiten. Außerdem wiederholt rclone fehlgeschlagene Uploads. Weitere Informationen finden Sie in der Dokumentation zu rclone mount.
Sie können nun mit den Dateien im eingebundenen Ordner arbeiten. Neue und geänderte Dateien werden auf Ihrem Computer verschlüsselt und zu OpenCloud hochgeladen.
Einbindung überprüfen
- Erstellen Sie eine kleine Testdatei im eingebundenen Ordner.
- Prüfen Sie nach Abschluss des Uploads, ob die Datei im OpenCloud Web Client korrekt angezeigt wird.
- Erstellen Sie im Web Client eine kleine Datei im verschlüsselten Ordner.
- Prüfen Sie, ob die Datei über den eingebundenen Ordner zugänglich ist.
Änderungen aus dem OpenCloud Web Client können bis zu fünf Minuten benötigen, bevor sie im eingebundenen Ordner erscheinen, da rclone die Ordnerstruktur zwischenspeichert.
Verschlüsselten Ordner aushängen
Schließen Sie vor dem Aushängen alle geöffneten Dateien und stellen Sie sicher, dass ausstehende Uploads abgeschlossen sind. Bei aktiviertem VFS-Caching können Änderungen noch lokal gespeichert sein und auf den Upload zu OpenCloud warten. Prüfen Sie vor dem Beenden von rclone, ob kürzlich geänderte Dateien im Web Client korrekt angezeigt werden.
- Linux
- macOS
- Windows
Wenn die Einbindung im Terminal ausgeführt wird, drücken Sie Strg+C.
Wenn die Einbindung im Hintergrund ausgeführt wird, verwenden Sie:
fusermount3 -u ~/OpenCloud-Encrypted
Verwenden Sie auf Systemen mit FUSE 2 stattdessen fusermount -u.
Wenn die Einbindung im Terminal ausgeführt wird, drücken Sie Strg+C.
Wenn die Einbindung im Hintergrund ausgeführt wird, verwenden Sie:
pgrep -fl "rclone nfsmount opencloud-decrypted: $HOME/OpenCloud-Encrypted"
Vergewissern Sie sich, dass die Ausgabe ausschließlich den rclone-Prozess für diese Einbindung enthält. Notieren Sie die Prozess-ID am Anfang der Zeile und senden Sie anschließend SIGTERM an diesen Prozess:
kill -TERM <pid>
Wenn Sie einen anderen Remote-Namen oder Einhängepunkt gewählt haben, passen Sie das pgrep-Muster an. Verwenden Sie weder killall noch ein ungefiltertes pkill, da dadurch andere rclone-Prozesse beendet werden können.
Drücken Sie im PowerShell-Fenster, in dem die Einbindung ausgeführt wird, Strg+C.
Fehlerbehebung
Verschlüsselte Dateinamen werden angezeigt
Verschlüsselte Dateinamen sind zu erwarten, wenn Sie das WebDAV-Remote direkt verwenden, beispielsweise mit rclone ls opencloud-e2ee:.
Verwenden Sie das crypt-Remote zum Auflisten und Einbinden:
rclone ls opencloud-decrypted:
Wenn rclone ls opencloud-decrypted: keine Ausgabe zurückgibt, prüfen Sie zunächst, ob der verschlüsselte Ordner Dateien enthält. Der Befehl rclone ls listet Dateien auf, zeigt jedoch keine leeren Verzeichnisse an. Ein leeres Ergebnis weist daher nicht zwangsläufig auf einen Konfigurationsfehler hin.
Wenn der Ordner Dateien enthält und das crypt-Remote verschlüsselte Dateinamen oder keine Dateien anzeigt, prüfen Sie, ob das crypt-Passwort mit dem Passwort des verschlüsselten Ordners übereinstimmt und ob filename_encryption und directory_name_encryption wie unter Verschlüsseltes Remote konfigurieren beschrieben gesetzt sind.
rclone findet den Konfigurationsabschnitt nicht
Der folgende Fehler weist darauf hin, dass das crypt-Remote die WebDAV-URL anstelle des Namens des WebDAV-Remotes enthält:
didn't find section in config file ("https")
Die Option remote in der crypt-Konfiguration muss den Namen des WebDAV-Remotes gefolgt von einem Doppelpunkt enthalten:
Richtig:
remote = opencloud-e2ee:
Falsch:
remote = https://cloud.example.com/dav/...
Aktualisieren Sie den Wert remote und führen Sie den Test erneut aus.
Der Ordner kann nicht eingebunden werden
- Linux
- macOS
- Windows
- Prüfen Sie, ob FUSE 3 installiert ist.
- Prüfen Sie, ob der Einhängepunkt vorhanden und leer ist.
- Auf aktuellen Ubuntu-Versionen kann AppArmor FUSE-Einbindungen blockieren. Weitere Informationen finden Sie in der Dokumentation zu
rclone mount.
- Prüfen Sie, ob rclone nicht mit Homebrew installiert wurde. Führen Sie
which rcloneaus und installieren Sie rclone bei Bedarf mit dem Installationsskript neu. - Prüfen Sie, ob der Einhängepunkt vorhanden und leer ist.
- Wenn macOS rclone mit der Meldung blockiert, dass der Entwickler nicht verifiziert werden kann, lesen Sie die rclone-Installationsanleitung.
- Prüfen Sie, ob WinFsp installiert ist.
- Prüfen Sie, ob der Laufwerksbuchstabe bereits verwendet wird.