Backups in Dropbox speichern

So richtest Du Deine Dropbox als Ziel für Deine Backups ein. Ein Passwort trägst Du dabei nicht ein: Du meldest Dich bei Dropbox an, stimmst dort zu und kommst auf die Seite „Ziele“ zurück.

Das brauchst Du

• ein Dropbox-Konto mit genug freiem Platz für Deine Backups,
• eine Website, deren Verwaltung über https:// erreichbar ist,
• die PHP-Erweiterung cURL mit https auf dem Webserver.

Fehlt dem Webserver cURL, ist Dropbox in der Auswahl der Ziel-Arten ausgegraut und trägt das Label Auf diesem Server nicht verfügbar.

Schritt 1: Ziel-Art wählen

Öffne die Seite Ziele und klicke auf Ziel hinzufügen. Wähle Dropbox.

1. Name ist frei wählbar. Das Plugin schlägt „Dropbox 1“ vor; jeder Name geht, der noch nicht vergeben ist.
2. Der Hinweis zur Anmeldung sagt, dass Du zu Dropbox weitergeleitet wirst und danach auf diese Seite zurückkommst, und dass der Dienst auth.cloneworx.de die Anmeldung vermittelt.
3. Der Hinweis der Ziel-Art sagt, dass das Plugin in Deiner Dropbox einen eigenen Ordner unter „Apps“ bekommt und sonst nichts sieht, und dass sich gelöschte Backups in Dropbox noch eine Zeit lang wiederherstellen lassen.
4. Die Schaltfläche Mit Dropbox verbinden beginnt die Anmeldung.

Das Formular hat kein Feld für ein Passwort, kein Feld für einen Ordner und keine Schaltfläche Verbindung testen: Ein Ziel der Art Dropbox entsteht erst mit der Anmeldung, und sein Ort ist der Ordner, den Dropbox für die App führt.

Schritt 2: Mit Dropbox verbinden

Klicke auf Mit Dropbox verbinden. Dein Browser verlässt die Seite Ziele:

1. Melde Dich bei Dropbox an und stimme zu.
2. Danach zeigt der Dienst auth.cloneworx.de eine Seite, die die Website nennt, an die der Zugang übergeben wird. Geh nur weiter, wenn das Deine Website ist.
3. Dein Browser kommt auf die Seite Ziele zurück. Dort steht kurz Anmeldung wird abgeschlossen …

Das Plugin speichert das Ziel, testet die Verbindung sofort und meldet das Ergebnis: „…“ gespeichert und verbunden. Speichern musst Du nicht mehr.

1. Alle Ziele sind verbunden.
2. Die Meldung nennt das Ziel: gespeichert und verbunden.
3. Das neue Ziel steht in der Liste. Der grüne Punkt heißt: verbunden.
4. Der Ort des Ziels ist die Adresse des verbundenen Dropbox-Kontos.

Eine begonnene Anmeldung gilt 15 Minuten. Pläne und Backups nutzen ein Ziel erst nach einem gelungenen Verbindungstest.

Findet das Plugin in Deiner Dropbox Backups, die nicht in Deiner Liste stehen, erscheint die Kachel Backups gefunden an „…“. Mehr dazu: Backups nach einem Totalverlust wiederfinden.

Schritt 3: Das Ziel im Backup-Plan wählen

• Dein erstes Ziel: Das Plugin legt den Plan „Tägliches Backup“ an: täglich zu einer zufälligen Uhrzeit, alles, dieses Ziel, Max. Sicherungen 7. Der Plan ist pausiert, bis Du ihn einschaltest.
• Ein weiteres Ziel: Wähle es auf der Seite Backup in der Kachel Backup-Pläne in einem Plan. Die freie Version erlaubt zwei Pläne und ein Ziel je Plan.

Mehr dazu: Backups automatisch planen.

Wenn die Anmeldung nicht klappt

Kommst Du ohne Zugang von Dropbox zurück, entsteht kein Ziel. Die Seite Ziele meldet den Grund, und das Formular öffnet sich wieder mit Deinen Angaben.

1. Die Meldung sagt: Dropbox meldet, dass der Zugriff nicht erlaubt wurde. Es wurde nichts verbunden.
2. Das Formular ist wieder offen, mit Deinen Angaben.
3. Die Schaltfläche Mit Dropbox verbinden beginnt die Anmeldung neu.

Meldung	Was tun
Das Verbinden braucht https: Die Adresse der Verwaltung dieser Website beginnt nicht mit https.	Die Meldung steht im Formular, bevor der Browser die Seite verlässt. Der Anmeldedienst übergibt einen Zugang nur an eine Website, deren Verwaltung über https:// erreichbar ist. Stelle die Website auf https um.
Die Anmeldung wurde abgebrochen. Es wurde nichts verbunden.	Das ist eine Auskunft, kein Fehler. Klicke noch einmal auf Mit Dropbox verbinden, wenn Du das Ziel einrichten willst.
… meldet, dass der Zugriff nicht erlaubt wurde. Es wurde nichts verbunden.	Beginne die Anmeldung neu und stimme bei Dropbox zu.
… hat nicht alle Berechtigungen erteilt, die das Backup braucht. Es wurde nichts verbunden.	Das Plugin braucht alle vier Berechtigungen, siehe den Abschnitt „Was das Plugin in Dropbox sehen darf“. Beginne die Anmeldung neu.
Diese Anmeldung ist unbekannt oder abgelaufen. Bitte verbinde neu.	Das Formular öffnet sich hier nicht wieder. Klicke auf Ziel hinzufügen und beginne neu.
Die Anmeldung hat zu lange gedauert oder wurde schon benutzt. Bitte verbinde neu.	Beginne die Anmeldung neu.
Der Anmeldedienst ist im Moment nicht erreichbar. Bitte versuche es später noch einmal.	Versuche es später noch einmal. Unter der Meldung führt Protokoll anzeigen zum allgemeinen Protokoll.
… ist im Moment nicht erreichbar oder meldet einen Fehler. Bitte versuche es später noch einmal.	Die Meldung nennt Dropbox. Versuche es später noch einmal. Auch hier führt Protokoll anzeigen zum allgemeinen Protokoll.
Die Anmeldung hat geklappt, aber der erste Zugriff auf das Konto ist gescheitert: …	Hinter dem Doppelpunkt steht der Grund. Beginne die Anmeldung neu, wenn er behoben ist.

Was das Plugin in Dropbox sehen darf

Die App hat bei Dropbox die Zugriffsart „App folder“: Das Plugin sieht in Deiner Dropbox seinen eigenen Ordner unter „Apps“ und sonst nichts. Den Namen dieses Ordners legt Dropbox fest. Jede andere Datei in Deiner Dropbox sieht das Plugin nicht.

Das Plugin bittet Dropbox um vier Berechtigungen:

Berechtigung	Wofür
account_info.read	die Adresse und den Platz des Kontos lesen
files.metadata.read	die Dateien in seinem Ordner auflisten
files.content.read	die Dateien in seinem Ordner lesen
files.content.write	Dateien in seinen Ordner schreiben

Die Backups liegen in Deiner Dropbox unter Apps/<Name der App>/cloneworx-backup-<Code>/<Backup>/. Aufbau und Dateien eines Backups sind dieselben wie an jedem anderen Ziel.

Der Anmeldedienst auth.cloneworx.de

Dropbox verlangt für die Anmeldung ein Geheimnis. Ein Geheimnis kann nicht in einem Plugin stehen, dessen Code jeder lesen kann. Es liegt deshalb bei einem kleinen Dienst von cloneworx, auth.cloneworx.de, der die Anmeldung vermittelt.

Wer sendet	Was der Dienst erfährt
Dein Browser, wenn Du auf Mit Dropbox verbinden klickst	die Adresse der Verwaltungsseite Deiner Website, einen Zufallswert und die Sprache
Dein Webserver, nach der Rückkehr	den Code der Anmeldung. Der Dienst reicht die Anmeldung an Dropbox weiter.
Dein Webserver, solange das Ziel benutzt wird	den gespeicherten Dauerzugang, immer wenn ein neuer Zugang nötig ist: alle paar Stunden

Dazu kommen, wie bei jeder Anfrage, die IP-Adressen von Browser und Webserver. Der Dienst speichert nichts. Er erhält nie ein Backup, nie eine Datei und nie die Adresse Deines Dropbox-Kontos.

Am Ziel liegen zwei Werte, verschlüsselt wie jedes Passwort eines Ziels: der Dauerzugang und der Zugang, der wenige Stunden gilt. Die Adresse des verbundenen Dropbox-Kontos steht sichtbar beim Ziel. Im Protokoll und im Support-Bericht steht sie nie.

Die Felder der Ansicht Erweitert

1. Zeitgrenze für den Verbindungsaufbau (Sekunden) nimmt 3 bis 60, Vorgabe ist 10.
2. Upload-Rate (Bytes je Sekunde) darf leer bleiben: Dann gilt, was der Verbindungstest gemessen hat. Das Plugin wählt danach die Größe der Abschnitte eines Uploads.

Ein Feld für einen Ordner gibt es auch in der Ansicht Erweitert nicht.

Das Ziel bearbeiten und testen

Klicke in der Zeile des Ziels auf Mehr …, dann Bearbeiten.

1. Name ist der Name des Ziels in Listen und Meldungen.
2. Das verbundene Konto ist die Adresse des Dropbox-Kontos, in dem die Backups liegen.
3. Speichern speichert Deine Änderungen.
4. Die Schaltfläche Neu mit Dropbox verbinden beginnt die Anmeldung für dieses Ziel neu.
5. Verbindung testen testet die Verbindung.

Klicke auf Verbindung testen. Der Verbindungstest schreibt eine kleine Datei in die Dropbox, liest sie zurück und löscht sie wieder. Dazu lädt er eine Testdatei in drei Abschnitten hoch, misst dabei die Upload-Rate und prüft, ob Dropbox nach einer verlorenen Antwort die richtige Stelle zum Fortsetzen nennt. Zum Schluss vergleicht er Größe und Prüfsumme. Auch diese Datei löscht er wieder.

1. Das Ergebnis des Tests: Die Verbindung funktioniert, eine Testdatei wurde geschrieben, zurückgelesen und gelöscht.
2. Das Upload-Verfahren und die gemessene Upload-Rate.

Zeile im Ergebnis	Bedeutung
Verbindung funktioniert: Eine Testdatei wurde geschrieben, zurückgelesen und gelöscht.	Schreiben, Zurücklesen und Löschen gehen.
Upload-Verfahren: in Abschnitten (upload session); ein Upload geht dort weiter, wo er aufgehört hat.	Das Plugin lädt jede Datei in Abschnitten hoch. Geht die Antwort auf einen Abschnitt verloren, kostet das nur diesen einen Abschnitt.
Gemessene Upload-Rate: … je Sekunde.	Nach der Rate wählt das Plugin die Größe der Abschnitte: so, dass ein Abschnitt und die Antwort von Dropbox in den Rest eines Schritts passen.

Warnung nach einem gelungenen Test

Eine Warnung steht in gelb unter dem Ergebnis. Das Ziel ist trotzdem benutzbar.

Warnung	Bedeutung
Der Dienst nennt zu der Datei keine Prüfsumme; nach einem Upload wird nur die Größe geprüft.	Das Plugin vergleicht nach einem Upload die Größe, nicht die Prüfsumme.

Wenn der Test scheitert

Ein gescheiterter Test nennt die Ursache, bei manchen Ursachen darunter den Grund genauer, und dann die Fehlermeldung des Dienstes in der Zeile Meldung des Servers: … Die Fehlermeldung ist nicht übersetzt. Die Adresse des Dropbox-Kontos ist darin durch <user> ersetzt.

1. Die Ursache im Klartext, hier: Der Server meldet, dass kein Platz mehr frei ist.
2. Die Fehlermeldung des Dienstes, nicht übersetzt.

Meldung	Was tun
Der Server meldet, dass kein Platz mehr frei ist.	Schaffe Platz in Deinem Dropbox-Konto und teste erneut.
Das Konto hat den Zugriff abgelehnt. Der Anbieter nimmt die gespeicherte Zustimmung nicht mehr an. Verbinde das Ziel neu.	Siehe den Abschnitt „Getrennt und neu verbinden“.
Das Konto hat den Zugriff abgelehnt. Der Anbieter hat den Zugang nicht angenommen. Bleibt es dabei, verbinde das Ziel neu.	Teste noch einmal. Bleibt die Meldung, verbinde das Ziel neu.
Das Konto lässt diese Anfrage nicht zu. Die gespeicherte Zustimmung deckt diese Anfrage nicht ab. Verbinde das Ziel neu.	Der Zustimmung fehlt eine Berechtigung. Öffne das Ziel zum Bearbeiten und klicke auf Neu mit Dropbox verbinden.
Das Konto lässt diese Anfrage nicht zu.	Steht darunter kein Grund, hat Dropbox die Anfrage abgelehnt, zum Beispiel wegen einer Regel des Kontos. Was Dropbox dazu sagt, nennt die Zeile Meldung des Servers: …
Der Anmeldedienst hat keinen neuen Zugang geliefert. Der Anmeldedienst ist nicht erreichbar.	Das Plugin konnte keinen neuen Zugang holen. Teste später noch einmal.
Der Server hat um eine Pause gebeten: Er ist ausgelastet oder hat zu viele Anfragen erhalten.	Teste später noch einmal. In einem Backup wartet das Plugin selbst so lange, wie Dropbox nennt, und versucht es dann erneut.
Ein Upload kam nicht an, bevor die Zeit eines Schritts abgelaufen war: Die Verbindung zum Ziel ist dafür zu langsam. Das Plugin sendet einen Upload an diesen Dienst in Abschnitten von mindestens 256 KiB, und ein solcher Abschnitt muss in einem Schritt ankommen.	Die Verbindung zwischen Deinem Webserver und Dropbox ist für den kleinsten Abschnitt zu langsam.

Getrennt und neu verbinden

Dropbox nimmt eine Zustimmung nicht mehr an, wenn Du die App in den Einstellungen Deines Dropbox-Kontos getrennt hast. Das Plugin vermerkt das Ziel dann sofort als getrennt. Backups lassen es aus, bis Du es neu verbindest.

1. Die Statuskachel nennt das getrennte Ziel, die Ursache und den nächsten Schritt.
2. Neu verbinden öffnet das Formular des getrennten Ziels.
3. Getrennt steht in der Liste am Ziel. Der Punkt davor ist gelb.

Als Ursache nennt die Statuskachel: Der Anbieter nimmt die gespeicherte Zustimmung nicht mehr an: Sie wurde widerrufen oder ist abgelaufen. Darunter steht der nächste Schritt: Nächster Schritt: „…“ neu verbinden. Bis dahin lassen die Backups dieses Ziel aus. Klicke auf Neu verbinden.

1. Das verbundene Konto ist die Adresse des Dropbox-Kontos, in dem die Backups liegen.
2. Die Ursache steht in gelb: Dropbox nimmt die gespeicherte Zustimmung nicht mehr an.
3. Die Schaltfläche Neu mit Dropbox verbinden beginnt die Anmeldung.

Klicke auf Neu mit Dropbox verbinden und stimme bei Dropbox zu wie beim Einrichten. Das Ziel, sein Name und seine Backups bleiben erhalten.

Mit dem neuen Verbinden widerruft das Plugin bei Dropbox den Zugang, den das Ziel bis dahin hatte. Das gilt auch, wenn Du ein Ziel neu verbindest, das nicht getrennt ist.

Gut zu wissen

• Das Ziel entfernen widerruft bei Dropbox den Zugang, den das Ziel hatte. Die Backups bleiben in Deiner Dropbox. Andere Websites, die Du mit demselben Dropbox-Konto verbunden hast, haben einen eigenen Zugang und bleiben verbunden. Ist Dropbox in diesem Moment nicht erreichbar, entfernt das Plugin das Ziel trotzdem. Der Zugang gilt dann bei Dropbox weiter, bis Du die App in Deinem Dropbox-Konto trennst.
• Freier Platz. Dropbox nennt den Platz des Kontos und was davon belegt ist. Passt ein Backup dort nicht hinein, lässt es dieses Ziel aus und geht an die anderen Ziele des Plans. Es endet „mit Warnungen“ und nennt das Ziel, den Bedarf und den freien Platz. Bleibt dem Backup dabei kein Ziel, endet der Job, bevor er etwas schreibt. Dropbox zählt einen Upload erst, wenn er abgeschlossen ist: Läuft das Konto zwischendurch voll, scheitert der Upload an seinem Ende.
• Uploads. Das Plugin wählt die Größe eines Abschnitts nach der gemessenen Upload-Rate, mindestens 256 KiB. Eine Datei erscheint in Dropbox erst mit dem Abschluss des Uploads, in einem Zug. Gibt es dort schon eine Datei mit diesem Namen, ersetzt der Abschluss sie; vorher wird nichts gelöscht. Jeder Abschnitt trägt eine Prüfsumme, und Dropbox lehnt einen Abschnitt ab, der verändert ankommt. Nach dem Upload vergleicht das Plugin Größe und Prüfsumme bei Dropbox mit der lokalen Datei.
• Kurze Schritte. Bleiben in einem Schritt, der schon gearbeitet hat, weniger als 6 Sekunden, beginnt er keine Anfrage mehr an Dropbox. Der nächste Schritt macht mit seiner vollen Zeit weiter.
• Grenzen von Dropbox. Eine Anfrage trägt höchstens 150 MiB; das Plugin bleibt weit darunter. Ein Upload, der nie abgeschlossen wird, verfällt bei Dropbox nach sieben Tagen.
• Einen Ordner entfernt das Plugin nur, wenn Dropbox ihn als leer auflistet. Sonst löscht es nur Dateien.
• Kein Download über das Plugin. Backups, die nur in Dropbox liegen, holst Du in Dropbox. Restore, Prüfung und Wiederfinden lesen direkt aus Dropbox.
• Einen Proxy aus der wp-config.php benutzt das Plugin auch für diese Ziel-Art. Einer Weiterleitung folgt es nie.
• Unter der Auswahl der Ziel-Arten steht der Hinweis: Namen & Logos von Drittanbietern befinden sich im Besitz ihrer jeweiligen Eigentümer. Dies impliziert keine Zugehörigkeit oder Partnerschaft.

Siehe auch

• Welches Ziel passt zu Dir?
• Die Seite „Ziele“
• Zugangsdaten eines Ziels erneuern
• Backups in Google Drive speichern
• Ein Ziel entfernen
• Backups an einem Ziel prüfen und Reste aufräumen

Auf der Kommandozeile

WP-CLI noch nicht eingerichtet? So installierst Du WP-CLI.

Ein Ziel der Art Dropbox legst Du im Browser an, auf der Seite Ziele: Die Zustimmung bei Dropbox gibst Du dort. Auch neu verbinden geht nur im Browser. Testen, prüfen und entfernen gehen auch mit WP-CLI:

# Ziele mit Kennung und Zustand zeigen
wp cloneworx-backup target list

# Die Verbindung testen
wp cloneworx-backup target test dropbox-1

# Die Backups an diesem Ziel prüfen
wp cloneworx-backup target check dropbox-1

# Das Ziel entfernen; die Backups in Dropbox bleiben
wp cloneworx-backup target remove dropbox-1