Skip to content

de USER GUIDE

Jump to bottom
VD $ VD171 @ Priv8 edited this page Nov 4, 2026 · 2 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Tiếng Việt | 中文

VDBackup-Benutzerhandbuch

Eine vollständige, freundliche Durchführung durch VDBackup, von der Installation des Moduls über dein erstes Backup, dessen Wiederherstellung, das Senden in die Cloud, das Planen bis hin zum Öffnen auf einem PC Jahre später. Wenn du zuvor Swift Backup, Neo-Backup oder Android-DataBackup genutzt hast, wird sich das vertraut anfühlen - nur dass alles an einem Ort geschieht, ohne dass etwas "erlaubt" werden muss.

Inhaltsverzeichnis

1. Was VDBackup ist

VDBackup ist ein root-Modul mit einer integrierten WebUI, das deine Apps und ihre Daten sichert und wiederherstellt. Es ist als der offene, root-native Nachfolger von Swift Backup, Neo-Backup und Android-DataBackup konzipiert: Es zielt darauf ab, die Vereinigung dessen zu leisten, was diese Werkzeuge tun, an einem einzigen Ort, und es kann sogar deine bestehenden Neo-Backup- und Android-DataBackup-Backups importieren, sodass du umziehen kannst, ohne etwas zu verlieren.

Der entscheidende Unterschied zu einer gewöhnlichen Backup-App: VDBackup läuft vollständig aus der WebUI deines root-Managers, und das Modul ist bereits root. Es gibt keine Begleit-App zu installieren für die Kernfunktionen, keine "su gewähren"-Aufforderung zu bestätigen und nichts einzuschalten. Du öffnest die WebUI, wählst aus, was gesichert werden soll, und führst es aus.

Alles, was VDBackup erzeugt, verwendet Standardformate (tar, gzip, zstd, age, zip, restic), sodass deine Backups nie an das Modul gebunden und nie an dein spezielles Gerät gekoppelt sind. Siehe Abschnitt 11.

2. Voraussetzungen

  • Ein gerootetes Android-Gerät, verwaltet von KernelSU, APatch oder Magisk. VDBackup wird als Modul aus diesem Manager installiert.
  • Genügend freier Speicher für deine Backups (lokale Backups liegen unter dem Zustandsverzeichnis des Moduls; siehe Abschnitt 3).
  • Sonst nichts. Das Modul bündelt alle benötigten Binärdateien (tar, zstd, lz4, rclone, rsync, ssh, restic), sodass lokales Backup und Restore vollständig offline funktionieren. Nur Cloud-Ziele sprechen mit dem Netzwerk.

Einige feingranulare Extras (AppOps, SSAID, ein paar privilegierte Systembits) stützen sich auf das Android-Framework; das Modul handhabt diese intern, mit einem reinen Shell-Fallback, und sie degradieren elegant, wenn sie auf deinem Gerät nicht verfügbar sind.

3. Installation und erster Start

  1. Lade das neueste VD-Backup-vX.Y.zip-Release herunter.
  2. Flashe in deinem KernelSU-/APatch-/Magisk-Manager die Modul-Zip wie jedes andere Modul.
  3. Es ist sofort nutzbar - kein Neustart nötig. (Ein Neustart ist nur beim Wiederherstellen von SSAID jemals relevant; siehe Abschnitt 10.)
  4. Öffne die WebUI des Moduls aus dem Manager. Das ist die gesamte Oberfläche.

Welche Edition herunterladen. Jedes Release wird als mehrere flashbare Zip-Editionen ausgeliefert, sodass du nur herunterlädst, was du brauchst. Wähle eine:

  • VD-Backup-<ver>-universal-full.zip - jede CPU-Architektur und jede Binärdatei, einschließlich rclone (Cloud-Anbieter: Google Drive, S3 und 70+ weitere rclone-Backends) und restic (deduplizierte Snapshots). Funktioniert auf jedem Gerät. Größter Download.
  • VD-Backup-<ver>-universal-lite.zip - jede Architektur, aber ohne die zwei größten Binärdateien (rclone und restic). Kleinster Download; erledigt weiterhin lokale, SSH/SFTP- und rsync-Backups, mit portabler age-Verschlüsselung.
  • VD-Backup-<ver>-<abi>-full.zip (eine von arm64-v8a, armeabi-v7a, x86, x86_64) - eine einzige Architektur mit jeder Binärdatei (dieselben Funktionen wie universal-full, aber nur für die Architektur deines Geräts, also kleiner als universal-full).

Wenn du die Architektur deines Geräts kennst und alles willst, wähle die passende <abi>-full (die meisten Telefone sind arm64-v8a). Wenn du den kleinsten Download willst oder keine Cloud-Anbieter (rclone) oder Snapshots (restic) brauchst, wähle universal-lite. Wenn du alles willst und dir bei der Architektur nicht sicher bist, wähle universal-full. Bei der Installation behält das Modul unabhängig von der geflashten Edition nur die Architektur deines Geräts.

Beim ersten Start legt das Modul eine Standardkonfiguration an (nur falls noch keine existiert), sodass deine Einstellungen über Modul-Updates hinweg erhalten bleiben.

Wo der Zustand lebt. VDBackups Arbeitsdaten - deine Konfiguration, geplante Aufträge, gespeicherte Ziele, verschlüsselte Zugangsdaten, Protokolle und Audit-Trail sowie der Staging-Bereich - liegen unter:

/data/adb/vdbackup/

Wo Backups leben. Die Backups selbst werden in benutzersichtbaren, zugangsdaten-verschlüsselten Speicher geschrieben (sodass sie erst lesbar sind, nachdem du das Gerät entsperrt hast, und sie das Deinstallieren des Moduls überleben), ein Ordner pro Android-Benutzer:

/sdcard/VDBackup/            (= /data/media/<user>/VDBackup)

Behalte das aus zwei Gründen im Kopf: Backups belegen Platz unter /sdcard/VDBackup, und /data/adb/vdbackup/logs/ ist der Ort, an dem du nachschaust, wenn etwas schiefgeht.

4. Die WebUI-Tour

Die WebUI ist in einige wenige Tabs gegliedert:

  • Apps - die Liste der installierten Apps (Benutzer und System), jede mit ihrem echten Namen, ihrem Paketnamen und ihrem Symbol angezeigt (Symbole laden verzögert und werden zwischengespeichert, sodass die Liste reaktionsschnell bleibt). Die Schaltfläche in einer Zeile sichert die App; ein Tippen auf die Zeile öffnet den Backup-Verlauf dieser App, wo du jedes frühere Backup wiederherstellen kannst.
  • Backups - die Backups, die du bereits hast, jedes zeigt den App-Namen in einer Zeile und das Paket in der nächsten. Tippe auf ein Backup, um seine vollständigen Details zu sehen (Version, Datum, Größe, enthaltene Elemente, Berechtigungszählungen und das Gerät, von dem es stammt). Hier stellst du auch wieder her, führst einen Restore-Test aus, löschst ein Backup oder importierst Backups aus Neo-Backup oder Android-DataBackup.
  • Ziele - verwalte, wohin Backups gehen: lokaler Speicher plus beliebige Remote-Ziele, die du hinzufügst (siehe Abschnitt 7). Du kannst ein Ziel hier testen, bevor du dich darauf verlässt.
  • Einstellungen - ein Hell-/Dunkel-Themenumschalter, eine Akzentfarbauswahl (Voreinstellungen, eine eigene Farbe oder Zurücksetzen) und eine Sprachauswahl, Standardwerte für neue Aufträge (Standardkomprimierung, Verify an/aus, Standardverschlüsselung), die Netzwerkrichtlinie für Cloud-Transfers (siehe Abschnitt 7), Auto-Backup und die Liste ausgeschlossener Apps, die Installationsquellen-Option, der Verschlüsselungsschlüssel und die Planung.
  • Über - Version, Links, die Schwesterprojekte (Siehe auch) und das Audit-Manifest der gebündelten Binärdateien.

Bestätigungen und Meldungen nutzen App-interne Dialoge (nicht die alten System-Pop-ups), und eine Wiederherstellung oder ein Import bittet dich zu bestätigen, dass die aktuellen App-Daten überschrieben werden, bevor er fortfährt.

Backups und Wiederherstellungen laufen abgekoppelt als Hintergrund-root-Prozess. Du kannst die WebUI schließen oder sogar den root-Manager schließen, und die Operation läuft weiter. Wenn du zurückkommst, hängt sich die WebUI wieder an und zeigt den Live-Fortschritt mit einem lokalisierten Phasen-Label. Auf ROMs, die Shell-Benachrichtigungen durchreichen, erhältst du außerdem eine Android-Benachrichtigung, wenn ein Auftrag startet und endet; in jedem Fall ist die App-interne Fortschrittskarte der verlässliche Indikator.

5. Ein Backup erstellen

Der grundlegende Ablauf: öffne Apps, wähle eine App, wähle aus, was einbezogen werden soll, wähle einen Modus, stelle Komprimierung und (optional) Verschlüsselung ein, dann führe aus. Der Fortschritt erscheint live, und eine Benachrichtigung sagt dir, wann er fertig ist.

5.1 Auswählen, was gesichert werden soll

Für jede App kannst du eine beliebige Kombination dieser Elemente einbeziehen:

Element Was es ist
APK Die installierte App selbst (Basis-APK + etwaige Split-APKs).
data Die privaten Daten der App (/data/data). Das sind die üblichen "App-Daten".
device-protected data Direct-Boot-/geräteschützender Speicher (/data/user_de). Manche Apps legen hier Einstellungen ab.
external Die externen Daten der App unter Android/data.
OBB Die OBB-Erweiterungsdateien der App (Android/obb), von manchen Spielen genutzt.
media Die Medien der App unter Android/media.

Ein guter Standard für "diese App vollständig sichern" ist, sie alle einzubeziehen. Wenn du nur die Daten möchtest (zum Beispiel, um einen Spielstand zu verschieben), kannst du das APK und die großen OBB-/Medien-Elemente abwählen.

VDBackup bewahrt außerdem die Dinge, die eine Wiederherstellung originalgetreu machen: SELinux-Kontexte, uid/gid-Eigentümerschaft, Dateimodi, erweiterte Attribute (xattr) und Capabilities.

5.2 Backup-Modi: Full, Snapshot, Mirror

VDBackup bietet drei Modi. Die WebUI wählt Full vor, was für die meisten Menschen die richtige Wahl ist.

  • Full - ein vollständiges, eigenständiges, portables Backup, geschrieben als tar.zst (oder deine gewählte Komprimierung). Jeder Lauf erzeugt ein alleinstehendes Backup, das du überallhin kopieren und auf einem PC öffnen kannst. Am besten für: einen sauberen, portablen Snapshot einer App, den du archivieren und herumbewegen kannst. Das ist der Standard und die portabelste Option.
  • Snapshot - inkrementell und versioniert, gestützt auf restic. Jeder Lauf fügt einem Repository einen neuen Zeitpunkt-Snapshot hinzu, speichert nur das Geänderte und dedupliziert über Snapshots hinweg. Am besten für: einen laufenden Verlauf einer App zu führen, ohne bei jedem Lauf die volle Größe zu zahlen.
  • Mirror - eine 1:1-Synchronisierung der Live-Daten zum Ziel, gestützt auf rclone/rsync. Es hält das Ziel identisch mit dem, was gerade jetzt auf dem Gerät ist (geänderte Dateien werden kopiert, entfernte Dateien werden am Ziel gelöscht). Am besten für: eine schnelle, stets aktuelle Kopie, zum Beispiel zu einem Cloud-Remote. Beachte, dass das APK auch in einem Mirror komprimiert gespeichert wird, nie roh.

5.3 Komprimierung

Du kannst die Komprimierung für ein Full-Backup wählen:

  • none - keine Komprimierung (am schnellsten, am größten).
  • lz4 - sehr schnell, leichte Komprimierung.
  • zstd - der Standard, eine starke Balance aus Geschwindigkeit und Verhältnis. Du kannst auch eine Stufe wählen (zum Beispiel eine höhere Stufe für eine kleinere Datei).
  • gzip - der "Kompatibilitätsmodus". gzip lässt sich mit eingebauten Werkzeugen auf praktisch jedem Computer und in den meisten Dateimanagern öffnen, ohne dass etwas Zusätzliches zu installieren ist. Wähle dies, wenn dir am wichtigsten ist, das Archiv überall öffnen zu können.

Wenn du nichts wählst, verwendet VDBackup seinen konfigurierten Standard (zstd auf einer sinnvollen Stufe).

5.4 Verschlüsselung

Verschlüsselung ist optional und portabel. VDBackup verschlüsselt mit age unter Verwendung einer Passphrase (scrypt), was speziell wegen der Portabilität gewählt wurde: jedes standardmäßige age-Werkzeug auf jedem Betriebssystem kann dein Backup allein mit der Passphrase entschlüsseln. Verschlüsselung ist nie an die Hardware-Schlüssel deines Geräts gebunden, sodass ein verschlüsseltes Backup auf einem anderen Gerät wiederhergestellt und auf einem PC geöffnet werden kann. (Ein kompatibler AES-256-Zip-Modus ist ebenfalls für verschlüsselte Archive verfügbar, die du mit einem Doppelklick und einem Passwort öffnen möchtest.)

Um Verschlüsselung zu nutzen, erzeuge den Verschlüsselungsschlüssel einmal (Einstellungen), aktiviere dann die Verschlüsselung für deinen Auftrag und lege eine Passphrase fest. Die Passphrase ist das, was das Backup schützt, also wähle eine starke - es gibt keinen Hardware-Schlüssel und keine Wiederherstellungs-Hintertür.

Die APK-Regel (wichtig):

  • Das APK wird immer komprimiert gespeichert, nie roh, um Platz zu sparen.
  • Das APK wird standardmäßig nicht verschlüsselt, da das APK einer App öffentlicher Inhalt ist.
  • APK-Verschlüsselung und Datenverschlüsselung sind unabhängige Schalter. Das Einschalten der Datenverschlüsselung verschlüsselt das APK nicht. Wenn du ausdrücklich möchtest, dass auch das APK verschlüsselt wird, aktiviere den APK-Verschlüsselungsschalter explizit.

5.5 Verify und Dry-run

Zwei Sicherheitsoptionen helfen dir, einem Backup zu vertrauen, bevor du dich darauf verlässt:

  • Verify - nach dem Schreiben re-hasht VDBackup jedes Archiv und prüft es gegen das Manifest. Dies ist standardmäßig an für Full-Backups. Wenn eine Datei nicht übereinstimmt, schlägt der Auftrag mit einem klaren Fehler fehl, statt dir ein stillschweigend beschädigtes Backup zu hinterlassen.
  • Dry-run - plant den Auftrag und meldet die Größen, die er erzeugen würde, ohne etwas zu schreiben. Nutze es, um Platz abzuschätzen oder deine Elementauswahl zu prüfen, bevor du die echte Sache ausführst.

5.6 Spezial-Backups (Nachrichten, Anrufliste, WLAN, Bluetooth)

Unterhalb der App-Listen im Backups-Tab decken Spezial-Backups systemweite Daten ab, die nicht an eine einzelne App gebunden sind: Nachrichten (SMS/MMS), Kontakte und Anrufliste, WLAN-Netzwerke und Bluetooth. Wähle die Kategorien und sichere sie; sie werden roh archiviert, mit derselben SELinux-/xattr-Bewahrung und optionalen Verschlüsselung wie App-Backups. Optional wird auch eine portable Kopie geschrieben (Nachrichten, Anrufliste und Kontakte als öffenbares JSON), sodass du eine geräteübergreifende Kopie hast, die du auf einem PC ohne das Modul lesen kannst. Das Wiederherstellen eines Spezial-Backups überschreibt Live-Systemdaten und braucht einen Neustart, daher ist es hinter einer auffälligen Bestätigung abgesichert und auf demselben Gerät und derselben ROM zuverlässig.

6. Ein Backup wiederherstellen

Öffne den Backups-Tab, wähle das gewünschte Backup und starte die Wiederherstellung. Da die Wiederherstellung eine destruktive Aktion ist, bittet VDBackup dich zuerst um Bestätigung, und es hält die Aktion in einem lokalen Audit-Protokoll fest.

Eine Wiederherstellung ist originalgetreu: VDBackup löscht den aktuellen Zustand der App und extrahiert das Backup, sodass die App auf den exakten Zustand zurückgesetzt wird, der in diesem Backup erfasst wurde (einschließlich Eigentümerschaft, Modi, SELinux-Kontexte und xattr). Es ist keine Zusammenführung - es ist eine echte Wiederherstellung auf den Zeitpunkt des Backups.

Nützliche Wiederherstellungsoptionen:

  • Restore-Test - extrahiert das Backup in einen temporären Staging-Bereich und verifiziert es, ohne die Live-App zu berühren. Dies ist der sichere Weg zu bestätigen, dass ein Backup intakt und wiederherstellbar ist, bevor du irgendetwas überschreibst. Wenn der Test fehlschlägt, erhältst du einen klaren Fehler, und deine installierte App bleibt unberührt.
  • Teilweise Wiederherstellung - stelle nur einen Teil der gesicherten Elemente wieder her. Zum Beispiel nur die App-Daten wiederherstellen, ohne das APK neu zu installieren, oder die Speicherdateien wiederherstellen ohne die großen OBB/Medien. Wähle die gewünschten Elemente im Wiederherstellungsbildschirm.
  • Bei Snapshot- und Mirror-Backups zieht die Wiederherstellung jeweils aus dem versionierten Repository bzw. der gespiegelten Kopie.
  • Installationsquelle - standardmäßig meldet eine wiederhergestellte App den Play Store als ihre Installationsquelle (statt sideloaded auszusehen), was die meisten Apps und App-Prüfungen erwarten. Du kannst dies global in den Einstellungen oder pro Wiederherstellung ausschalten; ausgeschaltet bleibt die ursprüngliche Installationsquelle erhalten. Ein erweiterter Opt-in-Schalter "die initiierende Quelle fälschen" geht weiter und lässt auch das initiierende Paket und die Paketquelle der App Play-installiert aussehen; er bearbeitet die System-Paketdatenbank (zuvor gesichert) und wird nach einem Neustart wirksam.

Ein Backup löschen. Öffne die Details eines Backups (oder den Verlauf einer App) und nutze Löschen; du wirst um Bestätigung gebeten, und die Löschung wird in das Aktivitätsprotokoll geschrieben. Du kannst außerdem begrenzen, wie viele Backups pro App behalten werden (Aufbewahrung), sodass alte automatisch beschnitten werden.

Eine installierte App als System-App einhängen. Aus dem Backup-Verlauf einer App stellt Als System einhängen das APK der App in ein VDBackup-Overlay-Submodul bereit, sodass der root-Manager es aus /system/app (oder /system/priv-app) bereitstellt - die echte /system-Partition wird nie angefasst. Mit NoMount auf KernelSU greift es live; andernfalls greift es nach einem Neustart. Dies hängt nie davon ab, dass NoMount installiert ist.

7. Ziele: lokal und remote

Standardmäßig werden Backups in lokalen Speicher unter dem Zustandsverzeichnis des Moduls geschrieben. Du kannst im Ziele-Tab auch Remote-Ziele hinzufügen. Bei einem lokalen Ziel öffnet Durchsuchen einen Ordnerauswähler, sodass du einen Unterordner unter dem gemeinsamen Speicher (/sdcard) wählen kannst, statt den Pfad einzutippen.

Der Remote-Transport wird von den gebündelten Werkzeugen gehandhabt:

  • rclone - die Drehscheibe für eine riesige Bandbreite an Remotes: SFTP, SMB, WebDAV, FTP, S3, Google Drive und 70+ weitere Dienste.
  • rsync und die ssh/scp/sftp-Suite - für Delta-Sync und schlichte SSH-Ziele.
  • restic - verschlüsselte, deduplizierte Snapshot-Repositories (lokal oder remote).

Ein Cloud-Remote erstellen (kein SSH nötig). Wähle im Ziele-Tab den rclone-Zieltyp und nutze Cloud-Remote hinzufügen: wähle das Backend (SFTP, SMB, WebDAV, FTP, S3 oder Google Drive), fülle die Felder aus (Host/Benutzer/Passwort oder die S3-Schlüssel oder ein Drive-Token) und speichere. Das Remote erscheint dann in der Remote-Liste des Ziels. Passwörter werden verschleiert gespeichert, nie im Klartext. Du kannst deine Remotes von derselben Stelle aus auflisten und löschen.

Zwei Regeln halten die Remote-Nutzung sicher:

  • Zugangsdaten werden verschlüsselt im Ruhezustand im Zustandsverzeichnis des Moduls gespeichert, nie im Klartext.
  • Vor der Nutzung validieren. Nutze den Zieltest im Ziele-Tab, um zu bestätigen, dass ein Ziel funktioniert, bevor du ein echtes Backup darauf richtest.

Netzwerkrichtlinie (WLAN vs. mobile Daten). In den Einstellungen lässt dich "Cloud-Transfers über" einschränken, welche Verbindung Cloud-Transfers nutzen dürfen: WLAN und mobile Daten (der Standard), nur WLAN oder nur mobile Daten. Wenn du es einschränkst, prüft jeder Cloud-Transfer - manuell oder geplant, Upload oder Restore - zuerst die aktive Verbindung und weigert sich, auf der falschen zu laufen, sodass eine Nur-WLAN-Richtlinie nie mobile Daten verbraucht. Lokale Backups sind nie betroffen.

Google Drive. Du hast zwei Wege, Google Drive zu erreichen:

  1. Über rclone - füge Drive wie jedes andere Ziel als rclone-Remote hinzu, ohne zusätzliche App und ohne Google-Cloud-Konto. Führe auf einem beliebigen Computer einmal rclone authorize "drive" aus, melde dich im Browser bei deinem Google-Konto an und füge den ausgegebenen Token in das Token-Feld des Drive-Remotes ein.
  2. Über den optionalen Begleiter - eine winzige, Opt-in-Begleit-App, die die Google-Anmeldung und den Drive-Upload handhabt. Sie wird nur installiert, wenn du ausdrücklich das Google Drive-Begleitziel wählst, nie standardmäßig, und sie wird entfernt, wenn du sie deaktivierst. Der einmalige Google-Zustimmungsbildschirm ist der einzige Schritt, der außerhalb der WebUI geschieht. Wenn der Begleiter installiert ist, erinnert VDBackup dich daran, ihn immer mit HMA-OSS zu verbergen, damit seine Anwesenheit nicht root oder einen entsperrten Bootloader verrät, und es bietet an, ihn für dich zur HMA-OSS-Liste hinzuzufügen.

8. Planung und Aufbewahrung

VDBackup kann Backups automatisch nach einem Zeitplan ausführen. Im Planer definierst du einen Auftrag mit:

  • der App (oder dem Satz von Apps) und den zu verwendenden Elementen/dem Modus,
  • einem Ziel,
  • einem cron-artigen Zeitplan - stündlich, täglich oder wöchentlich, zu einer von dir gewählten Zeit (HH:MM),
  • einer Aufbewahrungs-Einstellung: N behalten der neuesten Backups für diesen Auftrag, ältere werden automatisch beschnitten.

Geplante Aufträge werden durch einen Boot-Zeit-Heartbeat im Modul ausgelöst: wenn ein Auftrag fällig ist, läuft er, hält seine letzte Laufzeit fest, damit er nicht zweimal auslöst, und wendet Aufbewahrung an, um alte Backups zu beschneiden. Da alles als root im Hintergrund läuft, brauchen geplante Backups nicht, dass die WebUI offen ist.

Auto-Backup bei Installation/Update. In den Einstellungen kannst du automatisches Backup aktivieren: derselbe Hintergrund-Heartbeat bemerkt neu installierte oder aktualisierte Apps und sichert sie für dich (mit keep-N-Aufbewahrung). Der erste Lauf erfasst nur, was installiert ist, sodass das Aktivieren nie dein ganzes Gerät auf einmal sichert.

Ausgeschlossene Apps (Sperrliste). Ebenfalls in den Einstellungen kannst du Apps ausschließen, die du nie automatisch oder nach Zeitplan gesichert haben möchtest; ausgeschlossene Apps werden von beiden übersprungen.

Aktivitätsprotokoll. Der Zeitplan-Tab hat eine Schaltfläche Aktivitätsprotokoll anzeigen, die den lokalen Audit-Trail zeigt - Backups, Wiederherstellungen, Löschungen, geplante und automatische Läufe sowie Bereinigungen - das Neueste zuerst.

9. Hereinmigrieren: Neo-Backup und Android-DataBackup importieren

Wenn du von Neo-Backup oder Android-DataBackup kommst, musst du nicht von vorne anfangen. Vom Backups-Tab aus kannst du deine bestehenden Backups importieren:

  1. Richte VDBackup auf deinen bestehenden Neo-Backup- oder Android-DataBackup-Backup-Ort (import-scan listet auf, was es dort findet).
  2. Wähle, welche Backups importiert werden sollen.
  3. Starte den Import. Wie andere lange Operationen läuft er abgekoppelt mit Live-Fortschritt.

Passwortverschlüsselte Neo-Backup-Backups werden unterstützt. Neo-Backups AES-256-verschlüsselte Backups können importiert werden - du wirst nach dem Passwort gefragt, wenn es benötigt wird, und das Passwort wird nur zum Entschlüsseln verwendet, nie in der Befehlszeile gespeichert.

10. SSAID (Geräte-ANDROID_ID)

SSAID ist die pro-App-ANDROID_ID - ein geräteweiter Bezeichner, den manche Apps lesen. VDBackup kann ihn sichern und wiederherstellen, aber dies ist das Sensibelste, das es berührt, daher wird es mit besonderer Sorgfalt behandelt:

  • Es ist OPTIONAL und standardmäßig AUS. VDBackup wird niemals SSAID erfassen oder wiederherstellen, es sei denn, du schaltest es für diesen Auftrag explizit ein. Die WebUI zeigt einen klar markierten, hervorgehobenen "Optional"-Hinweis, wo immer SSAID erscheint (Backup, Restore und Import), und es bleibt aus, bis du dich dafür entscheidest.
  • Es greift bei der Wiederherstellung erst nach einem Neustart. Der Android-Einstellungsanbieter cacht diese Werte, sodass ein wiederhergestelltes SSAID erst nach einem Neustart des Geräts wirksam wird.
  • Der vorherige Wert wird immer zuerst gesichert. Bevor irgendein SSAID überschrieben wird, kopiert VDBackup die Live-settings_ssaid.xml Byte für Byte in ein zeitgestempeltes Backup (das nie automatisch gelöscht wird). Wenn diese Sicherheitskopie nicht erstellt werden kann, geschieht das Überschreiben nicht. Um ein Rollback durchzuführen, stelle diese gesicherte Datei wieder her und starte neu.

Empfehlung: lass SSAID aus, es sei denn, du weißt ausdrücklich, dass du es brauchst (zum Beispiel eine bestimmte App, die sich an die Geräte-ID koppelt und die du bewusst migrierst). Für gewöhnliche App- und Datenbackups brauchst du es nicht.

11. Portabilität: Backups auf einem PC öffnen

Deine Backups sind nicht an dieses Modul gebunden und sind nie hardwaregebunden. Alles verwendet Standardformate, sodass du ein Backup auf Windows, macOS oder Linux ohne installiertes VDBackup öffnen kannst.

Ein Full-Backup-Ordner enthält eine manifest.json (die Quelle der Wahrheit, die jede Datei, die App-Version und den ursprünglichen Eigentümer/Kontext beschreibt), die APKs als *.apk.zst und die Datenarchive als <item>.tar.zst (oder .tar.gz / .tar.lz4), optional mit einem angehängten .age, wenn verschlüsselt.

Um eines auf einem PC zu öffnen, kurz gesagt:

  • Entschlüsseln (nur wenn die Datei auf .age endet) mit dem standardmäßigen age-Werkzeug und deiner Passphrase oder Schlüsseldatei.
  • Dekomprimieren und extrahieren: .tar.zst mit zstd dann tar; .tar.gz mit tar direkt; .tar.lz4 über zstd --format=lz4. Ein APK ist einfach ein zstd-komprimiertes APK, sodass das Dekomprimieren von base.apk.zst dir ein normales installierbares base.apk gibt.

Jedes verschlüsselte Backup wird mit einer RECOVERY-Notiz ausgeliefert, die die exakten Copy-Paste-Befehle für Windows, macOS und Linux enthält. Siehe ../module/etc/RECOVERY.md für das vollständige, schrittweise Kit.

Beachte, dass SELinux-Kontexte, uid/gid und Modi im tar gespeichert sind und nur dann richtig wieder angewendet werden, wenn du auf Android wiederherstellst - auf einem PC bekommst du trotzdem all deine Dateien, nur ohne dass die Android-spezifische Eigentümerschaft erzwungen wird.

12. VDBackup von einem KI-Assistenten aus steuern

VDBackup ist darauf ausgelegt, nicht nur für Menschen, sondern auch für KI-Assistenten und -Agenten freundlich zu sein. Die WebUI ist nur ein Client einer kleinen JSON-API; ein Agent kann jede Aktion des Moduls kopflos über dieselbe API verwalten (jeder Befehl gibt ein einzelnes JSON-Objekt zurück, lange Operationen laufen abgekoppelt und du fragst ihren Fortschritt per Polling ab, und dieselben Sicherheitsleitplanken gelten - SSAID bleibt Opt-in, mutierende Aktionen bleiben bestätigt und auditiert).

Wenn du möchtest, dass ein Assistent deine Backups und Wiederherstellungen für dich ausführt, verweise ihn auf AI-AGENTS.md, das die vollständige Steuerungsoberfläche dokumentiert: den Befehlsvertrag, jedes Verb mit seinen Argumenten und seinem Rückgabewert und die Sicherheitsregeln, die ein Agent beachten muss.

13. Fehlerbehebung und FAQ

Wo sind die Protokolle? Unter dem Modul-Zustandsverzeichnis, /data/adb/vdbackup/logs/. Der Live-Fortschritt für eine laufende Operation ist in progress-<opid>.json, und der Audit-Trail mutierender Aktionen (restore, delete, import, SSAID-Änderungen) ist in audit.jsonl.

Ein Backup/Restore scheint zu hängen oder ich habe die WebUI geschlossen. Operationen laufen abgekoppelt, sodass das Schließen der WebUI sie nicht stoppt. Öffne die WebUI erneut, und sie hängt sich wieder an jede laufende Operation an und zeigt den aktuellen Fortschritt.

Ich habe eine ERR_...-Meldung erhalten. Fehler werden mit einem klaren Code gemeldet. Einige häufige:

  • ERR_VERIFY - ein geschriebenes Archiv stimmte nicht mit seinem Manifest-Hash überein (die Verifizierung hat ein fehlerhaftes Backup erwischt). Führe das Backup erneut aus.
  • ERR_RESTORE_TEST - ein Restore-Test ist fehlgeschlagen; das Backup ließ sich nicht sauber extrahieren/verifizieren, und deine Live-App blieb unberührt.

Mein Remote-Ziel schlägt fehl. Nutze den Ziel-Test im Ziele-Tab, um Zugangsdaten und Konnektivität zu validieren. Denke daran, dass nur Cloud-Ziele das Netzwerk brauchen; lokales Backup/Restore ist vollständig offline.

Telefoniert irgendetwas davon nach Hause oder lädt zur Laufzeit herunter? Nein. Alle Binärdateien sind zur Build-Zeit im Modul gebündelt; zur Laufzeit wird nichts auf das Gerät geholt. Nur Cloud-Ziele (rclone/restic/ssh) sprechen mit dem Netzwerk, und nur, wenn du sie nutzt.

Wird mein Backup auf einem anderen Telefon wiederhergestellt? Ja - Backups sind portabel und nicht an die Gerätehardware gebunden. (SSAID ist die eine gerätespezifische Ausnahme, und es ist Opt-in und wird per Neustart angewendet; siehe Abschnitt 10.)

Mein verschlüsseltes Backup lässt sich nicht öffnen - ich habe die Passphrase verloren. Es gibt bauartbedingt keine Wiederherstellungs-Hintertür; die Passphrase ist das, was das Backup schützt. Bewahre sie sicher auf.

14. Deinstallation

Deinstalliere VDBackup wie jedes andere Modul aus deinem KernelSU-/APatch-/Magisk-Manager. Die Deinstallation bewahrt deine Benutzerkonfiguration und entfernt nur vorübergehenden Zustand, sodass eine spätere Neuinstallation deine Einstellungen aufgreift. Deine tatsächlichen Backups leben unter /data/adb/vdbackup/ - wenn du sie auch entfernen möchtest, lösche dieses Verzeichnis nach der Deinstallation manuell; andernfalls bleiben sie verfügbar (und, da es Standardformate sind, auf einem PC öffenbar) auch ohne das Modul.

Diese Dokumentation wurde mit Claude (Anthropic) erstellt und wird von VD171 gepflegt. Korrekturen und Verbesserungen sind willkommen - siehe CONTRIBUTING.md.

Clone this wiki locally