Zo stel je een WebDAV-server in als doel voor je back-ups, bijvoorbeeld Nextcloud, ownCloud of een NAS: van het formulier via de verbindingstest tot het opgeslagen doel.
Dit heb je nodig
- het adres van de map op de server, beginnend met https://,
- gebruikersnaam en wachtwoord; gebruikt het account tweefactorauthenticatie, dan een app-wachtwoord,
- een map die niemand zonder toestemming kan bereiken, ook niet via een deellink.
WebDAV is bestandstoegang via HTTP. De plugin gebruikt WebDAV via de PHP-extensie cURL en leest de antwoorden van de server met de PHP-extensie DOM.
Stap 1: doeltype kiezen
Open de pagina Doelen en klik op Doel toevoegen. Kies WebDAV.
- De doeltypen die er zijn. WebDAV heeft de wereldbol als symbool.
- Sluiten sluit de keuze.
Ontbreekt cURL of DOM op de webserver, dan is WebDAV grijs en heeft het label Niet beschikbaar op deze server. De reden staat onder de keuze.
Stap 2: formulier invullen
- Naam is vrij te kiezen. De plugin stelt “WebDAV 1” voor; elke naam die nog niet in gebruik is, is mogelijk.
- Adres van de map is het volledige WebDAV-adres. De plugin maakt ontbrekende mappen aan.
- Gebruikersnaam
- Wachtwoord is het wachtwoord van het account of een app-wachtwoord.
- Locatie geeft aan of het doel op dezelfde locatie staat als de website: niet opgegeven, Dezelfde locatie als de website of Andere locatie (ander datacenter of andere aanbieder). De opgave telt voor de 3-2-1-regel van de plannen.
- Verbinding testen controleert de ingevoerde waarden zonder op te slaan.
Velden met een rode ster zijn verplicht. Voor het adres geldt:
- Bij Nextcloud en ownCloud heeft het de vorm
https://<server>/remote.php/dav/files/<gebruiker>/<map>/. - Gebruikersnaam en wachtwoord horen in hun eigen velden, niet in het adres. Het formulier weigert een adres met inloggegevens, vraagteken of hekje: Deze waarde is niet geldig.
- De plugin accepteert ook een adres met http://. Wachtwoord en gegevens worden dan als leesbare tekst verzonden.
De map mag niet openbaar bereikbaar zijn
Zorg ervoor dat niemand zonder toestemming toegang tot de map heeft, bijvoorbeeld via een deellink. De plugin stuurt nooit proefverzoeken naar servers van derden. Hij kan je daarom niet vertellen of de map openbaar is.
Stap 3: verbinding testen
Klik op Verbinding testen. De test meldt zich aan bij de server, schrijft een klein bestand, vraagt de grootte ervan op, hernoemt het, leest het terug, geeft de map weer en verwijdert het bestand weer. Met een testbestand van 1 MiB meet hij de uploadsnelheid.
- Het resultaat van de test: de verbinding werkt, een testbestand is geschreven, teruggelezen en verwijderd.
- De uploadmethode die de test heeft vastgesteld, en de gemeten uploadsnelheid.
WebDAV zelf biedt geen manier om een onderbroken upload voort te zetten. De plugin ondersteunt drie methoden. De test stelt vast welke jouw server aanbiedt:
| Regel in het resultaat | Betekenis |
|---|---|
| Uploadmethode: de server zet een onderbroken upload voort waar die stopte. | De server neemt een deel van een bestand op een bepaalde positie aan, bijvoorbeeld Apache met mod_dav. De methode heet range. |
| Uploadmethode: in secties, zoals Nextcloud en ownCloud die aanbieden. | De secties worden naar een uploadmap van de server geüpload, die ze aan het einde samenvoegt. Dat werkt alleen met een adres van de vorm …/remote.php/dav/files/<gebruiker>/…. De methode heet chunks. |
| Uploadmethode: elk bestand in één verzoek, omdat de server een upload niet kan voortzetten. | Voor servers die geen van beide andere aanbieden. De methode heet whole. Daaronder staat hoe groot de delen van een back-up hoogstens worden. |
De laatste regel toont de snelheid: Gemeten uploadsnelheid: … per seconde.
Stap 4: opslaan
Klik op Opslaan. De plugin slaat het doel op, test de verbinding nog een keer en meldt het resultaat: “…” opgeslagen en verbonden. Plannen en back-ups gebruiken een doel pas na een geslaagde verbindingstest.
- Alle doelen zijn verbonden.
- De melding vermeldt het doel: opgeslagen en verbonden.
- Het nieuwe doel staat in de lijst. De groene stip betekent: verbonden. Vóór een doel van het type WebDAV staat de wereldbol.
Na het opslaan en de geslaagde verbindingstest kijkt de plugin op de locatie van het doel. Vindt hij daar de map van een andere installatie, dan verschijnt de tegel Back-ups gevonden op „…”. De plugin voegt back-ups in de map van deze installatie die in de lijst van de back-ups op dit doel ontbreken, vanzelf aan de lijst toe, of dezelfde tegel biedt aan ze toe te voegen. Meer daarover: Back-ups terugvinden na een nieuwe installatie.
Stap 5: het doel in het back-upplan kiezen
- Je eerste doel: de plugin maakt het plan “Dagelijkse back-up” aan: dagelijks op een willekeurig tijdstip, alles, dit doel, Max. back-ups 7. Het plan is gepauzeerd tot je het inschakelt.
- Nog een doel: kies het op de pagina Back-up in de tegel Back-upplannen in een plan. De gratis versie staat één doel per plan toe.
Meer daarover: Back-ups automatisch inplannen.
De velden van de weergave Uitgebreid
- Tijdslimiet voor de verbinding (seconden) accepteert 3 tot 60; de standaard is 10.
-
Uploadmethode mag leeg blijven: dan wordt gebruikt wat de verbindingstest heeft vastgesteld. Mogelijke waarden zijn
range,chunksenwhole. - Uploadsnelheid (bytes per seconde) mag leeg blijven: dan wordt gebruikt wat de verbindingstest heeft gemeten.
-
Grootste aanvraag (bytes) geldt alleen bij de methode
wholeen mag leeg blijven: dan wordt gebruikt wat een back-up heeft geleerd toen de server een verzoek als te groot weigerde. Waarden van 1048576 tot 268435456 zijn toegestaan. - Geaccepteerde sleutel van de server wordt ingevuld door Dit certificaat accepteren. Leeg betekent: de plugin controleert het certificaat aan de hand van de lijst met vertrouwde instanties.
In een leeg veld waarvan de test de waarde vaststelt, staat automatisch. Elke verbindingstest stelt methode en snelheid opnieuw vast. De back-ups houden beide bij: een lagere snelheid geldt meteen, een hogere voor de helft. Wat je zelf invult, heeft altijd voorrang.
Versleuteling en certificaat
https:// is het normale geval. Met http:// bevat het resultaat van de verbindingstest een waarschuwing: De verbinding is niet versleuteld: wachtwoord en gegevens kunnen onderweg worden meegelezen.
Met https:// controleert de plugin het certificaat van de server aan de hand van de lijst met vertrouwde instanties die WordPress meebrengt, inclusief de naam van de server. Mislukt de controle, dan mislukt de test en toont hij het certificaat.
- De reden: niet uitgegeven voor deze servernaam, zelfondertekend, van een onbekende instantie of verlopen.
- De gegevens van het certificaat: voor wie het is uitgegeven, door wie, tot wanneer het geldig is, en de vingerafdruk.
- Dit certificaat accepteren vult de sleutel van het certificaat in het formulier in en test nog een keer.
Boven de reden 1 staat in de afbeelding de regel Melding van de client met de oorspronkelijke foutmelding van cURL.
Alleen accepteren als de vingerafdruk klopt
Na het accepteren vertrouwt de plugin precies deze sleutel en controleert hij niet meer wie het certificaat heeft uitgegeven. Niemand heeft bevestigd dat dit de juiste server is: vergelijk de vingerafdruk met de vingerafdruk die jouw aanbieder opgeeft.
Na het accepteren staat in het resultaat van een geslaagde test de waarschuwing: Het certificaat wordt niet gecontroleerd aan de hand van de lijst met vertrouwde instanties; de plugin vertrouwt de sleutel die je hebt geaccepteerd.
De controle wordt nooit uitgeschakeld. Toont de server later een andere sleutel, dan doorstaat het doel zijn test niet meer: De server toont een andere sleutel dan de sleutel die je hebt geaccepteerd. Hij heeft misschien een nieuw certificaat, of iemand zit ertussen. Accepteer het nieuwe certificaat alleen als je weet waarom het is veranderd.
Als de test mislukt
Mislukt de test, dan staat het resultaat onder de velden van het formulier. In de afbeelding heeft de server de aanmelding geweigerd.
- De oorzaak in gewone taal. De link aan het einde, Globaal logboek tonen, opent het globale logboek. Daar staan de details van de test.
- Melding van het doel is de oorspronkelijke foutmelding van de WebDAV-server.
Heeft ook cURL iets gemeld, dan staat daaronder Melding van de client. De foutmeldingen in beide regels zijn niet vertaald; inloggegevens, mappen en servernamen zijn erin onleesbaar gemaakt.
| Melding | Wat je kunt doen |
|---|---|
| Het doel is niet bereikbaar. Controleer de servernaam en de poort; de hoster van deze website blokkeert de poort misschien. | Controleer het Adres van de map: de naam van de server en, als het adres er een bevat, de poort. |
| Het doel heeft de aanmelding geweigerd. Controleer gebruikersnaam en wachtwoord. | Voer de inloggegevens opnieuw in. Gebruikt het account tweefactorauthenticatie, maak daar dan een app-wachtwoord aan en vul het in. |
| Het certificaat van het doel heeft de controle niet doorstaan. | Zie de paragraaf “Versleuteling en certificaat”. |
| Het doel verwijst door naar een ander adres. De plugin volgt geen doorverwijzing; test de verbinding van het doel om het nieuwe adres te zien. | Zie de volgende paragraaf. |
| Het doel staat niet alles toe wat de plugin nodig heeft. | Onder de melding staat wat ontbreekt, bijvoorbeeld het hernoemen of het lezen vanaf een positie. De plugin heeft dat nodig om back-ups te controleren, voort te zetten en op te ruimen. Zonder die mogelijkheid is het doel niet bruikbaar. |
| Het doel vroeg om een pauze: het is bezet of kreeg te veel verzoeken. | Test de verbinding later opnieuw. |
| Het doel meldt dat er geen ruimte meer is. | Maak ruimte vrij op de server, of kies een map met meer ruimte. |
| Het doel heeft het verzoek geweigerd, of de overdracht is mislukt. | Kent de plugin de reden, dan staat die onder de melding: Het doel weigert uploads van deze grootte. De grens is bij het doel ingesteld. Of: Een ander programma heeft dit bestand op de server gereserveerd (WebDAV-lock). Anders helpt de regel Melding van het doel verder. |
Als de server doorverwijst
De plugin volgt geen doorverwijzing, omdat het wachtwoord anders naar een adres zou worden gestuurd dat je niet hebt ingevuld. De test mislukt, en onder de melding staat het nieuwe adres. Er is één uitzondering: verwijst de server een map door naar hetzelfde adres met een schuine streep aan het einde, dan herhaalt de plugin het verzoek één keer met de schuine streep.
- De melding: het doel verwijst door naar een ander adres.
- Het nieuwe adres waarnaar de server doorverwijst.
Vul het nieuwe adres in als Adres van de map, als het het juiste is.
Als een upload te langzaam is
De plugin werkt in korte stappen. Bij de methode whole moet elk bestand binnen één stap aankomen. Daarom splitst de plugin een back-up naar zo’n doel in kleinere delen: hij rekent met de uploadsnelheid van het doel en de maximale duur van een stap en kiest een grootte tussen 1 MiB en 256 MiB. Het resultaat van de verbindingstest toont die: Een back-up die naar dit doel gaat, wordt daarom in delen van hoogstens … gesplitst, op elk doel van die back-up.
- Het resultaat van de test: de verbinding werkt.
- De uploadmethode die de test heeft vastgesteld: elk bestand in één verzoek.
- De maximale grootte van de delen van een back-up die naar dit doel wordt overgedragen.
Veel servers begrenzen de grootte van een verzoek. Weigert de server een deel als te groot (antwoord 413), dan mislukt dit doel voor deze back-up, en de plugin onthoudt de helft van de geweigerde grootte als Grootste aanvraag (bytes). De volgende back-up maakt geen grotere delen. Heb je de grens op de server verhoogd, verhoog dan de waarde of voer het maximum in; een verbindingstest zet haar niet terug. Bij nginx heet de grens van de server client_max_body_size.
Komt een bestand toch niet op tijd aan, dan geldt het doel in deze back-up na drie pogingen als mislukt. De melding daarbij: Een upload kwam niet aan voordat de tijd van een stap om was: de verbinding met het doel is daarvoor te langzaam. De plugin onthoudt daarna een lagere snelheid, en de volgende back-up krijgt kleinere delen. Test de verbinding van het doel opnieuw om de snelheid opnieuw te meten. Hoe lang een stap hoogstens duurt, bepaalt de instelling Maximale duur per stap: De plugin aanpassen aan je server.
Goed om te weten
- De back-ups staan op de server onder
<Adresse>/cloneworx-backup-<code>/<back-up>/. De map van de plugin hoef je niet aan te maken. - In zijn mappen plaatst de plugin de beschermingsbestanden
index.phpenindex.html, maar geen.htaccessen geenweb.config: een WebDAV-server leest de bestanden die bij hem staan. Op een WebDAV-doel beschermt de aanmelding bij de server de map. - Vraagt de server tijdens een back-up om een pauze, dan wacht de plugin zo lang als de server aangeeft, hoogstens vijf minuten, en probeert het daarna opnieuw.
- De plugin verwijdert bestanden een voor een. Hij verwijdert een map alleen als de server die als leeg weergeeft.
- Back-ups die alleen op een WebDAV-doel staan, download je niet via de plugin, maar met je WebDAV-programma of in de webinterface van de server. Herstel, controle en terugvinden lezen rechtstreeks van de server.
- Geeft de server de vrije ruimte door, dan controleert de plugin vóór het schrijven van een back-up of die voldoende is. De tegel Doelen en ruimte in de weergave Uitgebreid toont de vrije ruimte alleen bij lokale mappen; bij een WebDAV-doel staat daar een streepje.
- De plugin gebruikt een proxy uit de
wp-config.phpook voor WebDAV. De constanten hetenWP_PROXY_HOST,WP_PROXY_PORT,WP_PROXY_USERNAME,WP_PROXY_PASSWORDenWP_PROXY_BYPASS_HOSTS.
Zie ook
- Welk doel past bij jou?
- De pagina “Doelen”
- De toegangsgegevens van een doel vernieuwen
- Back-ups op een doel controleren en resten opruimen
- Als een back-up mislukt of eindigt met waarschuwingen
Op de opdrachtregel
WP-CLI nog niet ingesteld? Zo installeer je WP-CLI.
De opdrachtregel accepteert het wachtwoord niet; daarom stel je een WebDAV-doel in op de pagina Doelen. Al het overige is ook mogelijk met WP-CLI:
# Doelen met kenmerk en status tonen wp cloneworx-backup target list # De verbinding testen wp cloneworx-backup target test webdav-1 # Een plan aanmaken dat naar dit doel back-upt wp cloneworx-backup plan add --target=webdav-1 --rhythm=daily --time=03:15 --name="Nachts" # De back-ups op dit doel controleren wp cloneworx-backup target check webdav-1 # Resten tonen (--dry-run) en opruimen wp cloneworx-backup target cleanup webdav-1 --dry-run wp cloneworx-backup target cleanup webdav-1