ENZCOM // Drive – gemeinsamer Sync-Kern und Nextcloud-Anbindung
  • JavaScript 94%
  • TypeScript 3.3%
  • PHP 1.2%
  • Python 0.8%
  • SCSS 0.4%
  • Andere 0.3%
Datei suchen
2026-10-29 12:27:23 +01:00
enzcom_drive_sync ENZCOM Drive: nativer Sync-Kern 0.1.0 und Nextcloud-Erweiterung 0.1.2 2026-10-28 17:12:08 +01:00
nextcloud ENZCOM Drive Nextcloud 0.2.1: native Files capabilities and ENZCOM Drive interaction model 2026-10-29 12:27:23 +01:00
tests ENZCOM Drive: nativer Sync-Kern 0.1.0 und Nextcloud-Erweiterung 0.1.2 2026-10-28 17:12:08 +01:00
LICENSE ENZCOM Drive: nativer Sync-Kern 0.1.0 und Nextcloud-Erweiterung 0.1.2 2026-10-28 17:12:08 +01:00
README.md ENZCOM Drive: nativer Sync-Kern 0.1.0 und Nextcloud-Erweiterung 0.1.2 2026-10-28 17:12:08 +01:00

ENZCOM // Drive – Sync-Kern 0.1.0

Gemeinsamer Linux-Sync-Kern für den eigenen GET-/POST-Dateitransport und die Nextcloud-Erweiterung ENZCOM // Drive ab 0.1.2. Er synchronisiert gewöhnliche lokale Dateien und Verzeichnisse. Die bestehende Desktopanwendung und OpenVFS werden durch dieses Paket nicht ersetzt oder automatisch umkonfiguriert.

Verhalten

  • Native Nextcloud-Anmeldung mit Benutzer- oder App-Kennwort. Für einen dauerhaft eingerichteten Client ein eigenes App-Kennwort mit Dateizugriff verwenden.
  • Dauerhafte SQLite-Datenbank mit gemeinsamem Ausgangsstand, Server-Cursor, offenen Aufträgen und Konflikten. Ein exklusiver Prozess verwaltet den Bestand.
  • Mehrteilige Uploads mit Prüfsummen und wiederverwendbarer Auftragskennung. Verlorene Commit-Antworten werden über die ursprüngliche Quittung abgeglichen. Ein serverseitig ungeklärter Auftrag stoppt die Verarbeitung.
  • Downloads werden in Teilen fortgesetzt, vollständig mit SHA-256 geprüft und erst danach lokal übernommen. Neue lokale Arbeit verhindert Überschreiben.
  • Umbenennen und Verschieben erhalten die Server-Dateiidentität; Datei- und Verzeichnisänderungen werden in beide Richtungen übertragen.
  • Gleichzeitige Inhaltsänderungen erzeugen einen Konflikt. Beide Fassungen bleiben erhalten. Auflösung prüft erneut die angezeigten Ausgangsrevisionen.
  • Fehlender Zugriff, ein unvollständiger Abgleich oder ein verschwundener Listeneintrag sind kein Löschauftrag. Bestätigte entfernte Serverdateien werden lokal in einen geschützten Wiederherstellungsbereich verschoben.

Installation und Einrichtung

Das Paket enzcom-drive-sync benötigt Python 3.10 oder neuer. Nach Installation steht enzcom-drive-sync bereit. Es installiert keine Autostarts und übernimmt keine vorhandenen Nextcloud-Profile oder Synchronisationsordner.

Eine neue Verbindung benötigt eine absolute lokale Ordneradresse, ein separates Zustandsverzeichnis auf demselben Dateisystem, die Nextcloud-Adresse und die Kennung des gewählten Serverordners. Der Server muss das Profil nextcloud-native-events-v1, Downloadteile und SHA-256 anbieten. Der Client wechselt bei fehlender Unterstützung nicht auf DAV zurück.

Die Konfigurationsdatei enthält url, user, scope, root, state und credential_file. Die beiden Dateien für Konfiguration und Zugangsdaten sind nur für den eigenen Betriebssystembenutzer lesbar (Modus 0600); alle Pfade sind absolut. Das Kennwort darf nicht als Kommandozeilenargument übergeben werden. Produktive Verbindungen benötigen HTTPS. Eine ausdrücklich konfigurierte Loopback-Verbindung ist ausschließlich für einen privaten Transport vorgesehen.

enzcom-drive-sync --config /absoluter/pfad/verbindung.json
enzcom-drive-sync --config /absoluter/pfad/verbindung.json --watch 10

Ein einzelner Aufruf arbeitet eine begrenzte Folge von Änderungen ab. syncing bedeutet, dass weitere Durchläufe erforderlich sind. synchronized bezeichnet einen abgeschlossenen Durchlauf, attention vorhandene Konflikte. paused weist auf eine unterbrochene oder nicht zulässige Verarbeitung hin.

Bei einem Inhaltskonflikt wird der relative Dateipfad ausdrücklich ausgewählt:

enzcom-drive-sync --config /absoluter/pfad/verbindung.json --resolve dokument.txt --keep local
enzcom-drive-sync --config /absoluter/pfad/verbindung.json --resolve dokument.txt --keep remote

Nur eine Variante ausführen. Ändert sich eine Fassung seit der Konflikterkennung, wird die Auflösung abgewiesen. Andere Konfliktarten bleiben zur Prüfung stehen. Vorhandene Wiederherstellungs- und Konfliktkopien werden nicht automatisch gelöscht.

Server und Grenzen

Die beiliegende Nextcloud-Erweiterung 0.1.2 verwendet native Datei- und Freigabeereignisse als dauerhaft gespeicherte Änderungshinweise. Bei Änderungen und regelmäßig spätestens nach 60 Sekunden wird der berechtigte Bestand erneut abgeglichen. Jede ausgegebene Metadatenseite und jeder Inhaltsabruf prüft die Berechtigung. Das Journal ist kein transaktionales Dateisystemprotokoll.

Der aktuelle Umfang ist auf 20.000 Einträge je gewähltem Bereich und 1 GiB je hochgeladener Datei begrenzt. Getrennte Verbindungen und getrennte lokale Ordner sind erforderlich. Symlinks, Hardlinks, nicht reguläre Dateien und Namen, die sich nur durch Großschreibung oder Unicode-Normalisierung unterscheiden, werden abgewiesen. Zustands- und Synchronisationsverzeichnis müssen getrennt bleiben.

Die Erweiterung benötigt die bestehende ENZCOM-Berechtigungsanbindung in Nextcloud; sie ersetzt keine produktive Files-Installation allein durch Kopieren. Der im Quelltext enthaltene isolierte Autorisierungsmodus ist kein produktiver Einrichtungsweg. Öffentliche Freigabeseiten, Office-/App-Dateiauswahlen sowie virtuelle Dateien und Desktopoberfläche sind separate Integrationsarbeiten.

Dies ist keine Migration vorhandener Benutzerordner, keine E2EE-Lösung und keine Fernlöschung bereits heruntergeladener Daten. Lokale Dateien, Wiederherstellungs- und Zustandsdaten benötigen den üblichen Schutz des Betriebssystems und seiner Datenträger. Eine Schlüsselbundanbindung der Oberfläche bleibt separat.

Prüfung und Quellen

Nachgewiesen sind der bidirektionale Abgleich auf zwei realen Linux-Geräten, Datei-/Ordnerumbenennungen, verschachtelte Ordner, bestätigte Löschungen, Änderungen über native Nextcloud-Datei-APIs, verlorene Prozesse während Upload und Download, verlorene Commit-Antworten, Netzunterbrechung, konkurrierende Änderungen, explizite Inhaltskonfliktauflösung und Entzug des nativen Dateizugriffs. Diese Prüfung ersetzt keine Last-, Langzeit-, OpenVFS- oder Kundenmigration.

Der Quellstand enthält enzcom_drive_sync/ und tests/test_core.py sowie unter nextcloud/enzcom_drive/ die zugehörige Servererweiterung. Die Servererweiterung steht unter AGPL-3.0-or-later; der neu entwickelte Sync-Kern unter MIT. ENZCOM-Markenrechte bleiben vorbehalten.