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 hat 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.
- Name ist frei wählbar. Das Plugin schlägt „Dropbox 1“ vor; jeder Name ist möglich, der noch nicht vergeben ist.
- Der Hinweis zur Anmeldung erklärt, dass Du zu Dropbox weitergeleitet wirst und danach auf diese Seite zurückkommst, und dass der Dienst auth.cloneworx.de die Anmeldung vermittelt.
- Der Hinweis der Ziel-Art erklärt, 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.
- 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:
- Melde Dich bei Dropbox an und stimme zu.
- Danach zeigt der Dienst auth.cloneworx.de eine Seite, die die Website nennt, an die der Zugang übergeben wird. Fahre nur fort, wenn das Deine Website ist.
- 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.
- Alle Ziele sind verbunden.
- Die Meldung nennt das Ziel: gespeichert und verbunden.
- Das neue Ziel steht in der Liste. Der grüne Punkt bedeutet: verbunden.
- 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.
Nach der Rückkehr von der Anmeldung und dem gelungenen Verbindungstest sieht das Plugin am Ort des Ziels nach. Findet es dort den Ordner einer anderen Installation, erscheint die Kachel Backups gefunden an „…“. Backups im Ordner dieser Installation, die in der Liste der Backups an diesem Ziel fehlen, nimmt es von selbst in die Liste auf, oder dieselbe Kachel bietet an, sie aufzunehmen. Mehr dazu: Backups nach einer Neuinstallation 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 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.
- Die Meldung besagt: Dropbox meldet, dass der Zugriff nicht erlaubt wurde. Es wurde nichts verbunden.
- Das Formular ist wieder offen, mit Deinen Angaben.
- 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. Für die Entwicklung gelten localhost, 127.0.0.1 und Namen, die auf .test oder .localhost enden, auch ohne https. |
| 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 Globales Protokoll anzeigen zum globalen 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 Globales Protokoll anzeigen zum globalen 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
- Zeitgrenze für den Verbindungsaufbau (Sekunden) akzeptiert 3 bis 60, der Standardwert ist 10.
- 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.
- Name ist der Name des Ziels in Listen und Meldungen.
- Das verbundene Konto ist die Adresse des Dropbox-Kontos, in dem die Backups liegen.
- Speichern speichert Deine Änderungen.
- Die Schaltfläche Neu mit Dropbox verbinden beginnt die Anmeldung für dieses Ziel neu.
- 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 angibt. Zum Schluss vergleicht er Größe und Prüfsumme. Auch diese Datei löscht er wieder.
- Das Ergebnis des Tests: Die Verbindung funktioniert, eine Testdatei wurde geschrieben, zurückgelesen und gelöscht.
- 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 funktionieren. |
| 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 von Dropbox in der Zeile Meldung des Ziels: … Die Fehlermeldung ist nicht übersetzt. Die Adresse des Dropbox-Kontos ist darin durch <user> ersetzt.
- Die Ursache im Klartext, hier: Das Ziel meldet, dass kein Platz mehr frei ist.
- Die Fehlermeldung von Dropbox, nicht übersetzt.
| Meldung | Was tun |
|---|---|
| Das Ziel 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. |
Dropbox hat den Zugang abgelehnt, zum Beispiel weil er abgelaufen ist. 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, lässt Dropbox die Anfrage nicht zu, zum Beispiel weil Dropbox das Konto gesperrt hat oder eine Regel des Kontos sie verbietet. Das Ziel gilt dabei nicht als getrennt, und neu verbinden hilft nicht. Kläre die Ursache in Deinem Dropbox-Konto oder mit Dropbox. Was Dropbox dazu sagt, zeigt die Zeile Meldung des Ziels: … |
|
Der Anmeldedienst hat keinen neuen Zugang geliefert. Der Anmeldedienst ist nicht erreichbar. |
Das Plugin konnte keinen neuen Zugang holen. Teste später noch einmal. |
| Das Ziel hat um eine Pause gebeten: Es ist ausgelastet oder hat zu viele Anfragen erhalten. | Teste später noch einmal. In einem Backup wartet das Plugin selbst so lange, wie Dropbox vorgibt, 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.
- Die Statuskachel nennt das getrennte Ziel, die Ursache und den nächsten Schritt.
- Neu verbinden öffnet das Formular des getrennten Ziels.
- 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, weil sie widerrufen wurde oder abgelaufen ist. Darunter steht der nächste Schritt: Nächster Schritt: „…“ neu verbinden. Bis dahin lassen die Backups dieses Ziel aus. Klicke auf Neu verbinden.
- Das verbundene Konto ist die Adresse des Dropbox-Kontos, in dem die Backups liegen.
- Die Ursache steht in gelb: Dropbox nimmt die gespeicherte Zustimmung nicht mehr an.
- Die Schaltfläche Neu mit Dropbox verbinden beginnt die Anmeldung.
Klicke auf Neu mit Dropbox verbinden und stimme bei Dropbox zu wie beim Einrichten. Verbindest Du dasselbe Konto, bleiben das Ziel, sein Name und seine Backups erhalten. Bei einem anderen Konto fragt das Plugin nach: Zugangsdaten eines Ziels erneuern.
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. Mehr dazu im nächsten Abschnitt.
Wann das Plugin den Zugang bei Dropbox widerruft
Das Plugin bittet Dropbox, den Zugang zu widerrufen, den ein Ziel hat:
- wenn Du das Ziel entfernst, auf der Seite Ziele oder mit WP-CLI,
- wenn Du das Ziel neu verbindest: dann den Zugang, den das Ziel bis dahin hatte, nie den neuen,
- wenn Du das Plugin in WordPress löschst und der Schalter in der Kachel Deinstallation auf der Seite Einstellungen an ist. Dann widerruft das Plugin zuerst den Zugang jedes Ziels der Art Dropbox und entfernt danach Einstellungen, Ziele und Protokolle. Ist der Schalter aus, widerruft das Plugin nichts: Die Ziele bleiben für eine neue Installation in der Datenbank.
Die Backups bleiben in jedem Fall in Deiner Dropbox. Andere Websites, die Du mit demselben Dropbox-Konto verbunden hast, haben einen eigenen Zugang und bleiben verbunden.
Der Widerruf gelingt nicht immer:
- Das Plugin kann ihn nicht senden, wenn es die gespeicherten Zugangsdaten nicht mehr lesen kann, zum Beispiel nach geänderten Sicherheitsschlüsseln in der wp-config.php, wenn das Ziel schon entfernt war oder wenn cURL fehlt.
- Er kann scheitern, zum Beispiel wenn Dropbox oder der Anmeldedienst in diesem Moment nicht erreichbar ist. Den Anmeldedienst braucht das Plugin, wenn der Zugang abgelaufen ist: Dann holt es vorher einen neuen.
- Beim Löschen des Plugins beginnt ein Widerruf nur, solange seit dem ersten keine zehn Sekunden vergangen sind. Ein Ziel, das danach noch an der Reihe wäre, behält seinen Zugang.
Das Ziel wird trotzdem entfernt oder neu verbunden, und das Löschen des Plugins läuft weiter. Der Zugang bleibt dann bei Dropbox gültig, bis Du die App in Deinem Dropbox-Konto trennst.
Gut zu wissen
Gelöschte Backups bleiben in Dropbox eine Zeit lang wiederherstellbar
Ein Backup, das das Plugin in Dropbox löscht, lässt sich in Dropbox noch eine Zeit lang wiederherstellen: 30 Tage oder länger, je nach Tarif Deines Kontos. Das Plugin löscht in Dropbox nicht endgültig.
- Das Ziel entfernen widerruft bei Dropbox den Zugang, den das Ziel hatte. Die Backups bleiben in Deiner Dropbox. Wann der Widerruf ausbleibt oder scheitert, steht im Abschnitt „Wann das Plugin den Zugang bei Dropbox widerruft“.
- Freier Platz. Dropbox gibt den Platz des Kontos an und was davon belegt ist. Passt ein Backup dort nicht hinein, lässt es dieses Ziel aus und wird an die anderen Ziele des Plans übertragen. 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 hat 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 umfasst 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.
- Das Plugin benutzt einen Proxy aus der
wp-config.phpauch für diese Ziel-Art. Es folgt nie einer Weiterleitung. Die Konstanten heißenWP_PROXY_HOST,WP_PROXY_PORT,WP_PROXY_USERNAME,WP_PROXY_PASSWORDundWP_PROXY_BYPASS_HOSTS. - 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
- Das Plugin deinstallieren
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 ist nur im Browser möglich. Testen, prüfen und entfernen funktionieren 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