Welke back-upmethode houdt een draaiende databasecontainer consistent op een thuis-NAS?

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Voor de meeste gebruikers van een thuis-NAS of een zelfgehoste server is een database-eigen logische back-up die wordt gemaakt terwijl de database actief is de veiligste standaard. Maak daarna een gewone back-up van die dump, samen met de containerconfiguratie en applicatiebestanden. Gebruik een korte kopie van een gestopte container wanneer downtime acceptabel is, en gebruik een gecoördineerde bestandssysteemsnapshot alleen wanneer de database voor de snapshot is leeggemaakt, vergrendeld, gecontroleerd met een checkpoint of op een andere manier voorbereid. Een gewone kopie van een actief databasevolume is geen consistente back-upmethode.

Definieer ‘consistent’ als een back-up die de database accepteert

Een consistente back-up is niet zomaar een complete mappenstructuur. Na het terugzetten moet de database-engine opstarten, transacties correct herstellen, integriteitscontroles doorstaan en een toestand op een bepaald tijdstip presenteren die de applicatie kan gebruiken. Op een homeserver met Immich, Nextcloud, Paperless-ngx, Home Assistant of een andere zelfgehoste app betekent dit dat de database, uploads, configuratie en geheimen op elkaar moeten aansluiten.

Containerpersistentie geeft alleen aan waar de bestanden staan. Hierdoor wordt het niet veilig om een actieve database te kopiëren. Een database kan actieve transacties, pagina's in de cache, write-aheadlogs, tijdelijke bestanden of metadata bevatten die verandert terwijl NAS-back-upsoftware het volume uitleest.

Methode 1: Gebruik een database-eigen logische dump als standaard voor een thuis-NAS

Bij een logische dump exporteert de database-engine een consistente weergave van schema's en records. Voor een bescheiden PostgreSQL- of MariaDB-container op een gezins-NAS is dit meestal de eenvoudigste methode om te plannen, te inspecteren, extern te kopiëren en terug te zetten naar een schone vervangende container. Een actuele Docker-back-upgids laat dit patroon zien door database-eigen dumps uit te voeren vanuit een geplande back-upcontainer.

Schrijf de dump naar een aparte back-upmap buiten het actieve datavolume. Laat de NAS-back-uptaak vervolgens de dump, het Compose-bestand, de omgevingssjabloon, de applicatieconfiguratie en de geüploade gegevens beveiligen. Vermeld productiewachtwoorden niet in de bestandsnaam van de dump en sla ze niet onbeschermd op in logbestanden.

Database Standaard voor een homeserver Wat de back-uptaak moet verzamelen
PostgreSQL Native logische dump of database-eigen fysieke tool Dump, rollen of globale instellingen indien nodig, Compose, omgevingswaarden, appbestanden
MariaDB/MySQL Native logische dump met consistente transactieopties SQL-dump, gebruikers of rechten indien nodig, Compose, geheimen, appbestanden
SQLite Back-up van de applicatie, online back-up van SQLite of een schone kopie nadat de app is gestopt Consistente databasekopie plus appconfiguratie en bijlagen

Methode 2: Stop de database kort voordat je het volume kopieert

Een kopie van een gestopte container is eenvoudig en fysiek volledig. Stop eerst de processen die naar de database schrijven, stop de database op de juiste manier, controleer of het proces is beëindigd, kopieer het volledige persistente volume of de database map die aan de host is gekoppeld en start daarna de stack opnieuw. Een handleiding voor Docker en MariaDB beschrijft fysieke volumekopieën als snel, maar afhankelijk van de versie en doorgaans gekoppeld aan downtime.

Deze methode werkt goed voor een kleine thuis-NAS waarop enkele minuten onderhoud acceptabel zijn en bij het herstellen een compatibele databaseversie wordt gebruikt. De methode is minder overdraagbaar dan een logische dump en kan de downtime verlengen wanneer het volume groot is. Bewaar de tag van de database-image en de opslagindeling bij de back-up, zodat je geen fysieke bestanden herstelt in een incompatibele engineversie.

Methode 3: Stem een snelle snapshot af op de database

Snapshotsystemen voor ZFS, Btrfs, LVM en NAS kunnen snel een groot databasevolume vastleggen, maar de snapshot moet worden afgestemd op de database. Voor MariaDB of MySQL kan dat een korte vergrendelings- of flushperiode betekenen; voor PostgreSQL kan het gaan om het ondersteunde back-up- of checkpointproces van de database; voor een database die door de toepassing wordt beheerd, kan het een hook vóór het maken van de snapshot betekenen.

In een bespreking van databasesnapshots wordt uitgelegd dat een live kopie op schijf intern inconsistent kan zijn, tenzij de database wordt bevroren of de snapshot atomair wordt gemaakt. De vergrendelings- of stilstandperiode moet kort zijn: bereid de database voor, maak de snapshot, geef schrijfbewerkingen weer vrij en kopieer de snapshot later.

Deze methode is handig wanneer de database te groot is voor frequente logische dumps of wanneer je een korter herstelpuntinterval nodig hebt. Er is zorgvuldiger scriptwerk en meer hersteltests voor nodig dan bij een eenvoudige dumpworkflow voor een homeserver.

Behandel het exporteren van Docker-images of containers niet als een databaseback-up

De containerimage bevat de runtime van de toepassing, maar niet noodzakelijkerwijs de live persistente gegevens. Bij het exporteren of vastleggen van de container kunnen benoemde volumes ontbreken, en de database wordt niet gevraagd een consistent herstelpunt te maken. Een back-upaccount voor PostgreSQL-containers concludeert dat Docker save en commit geen vervanging zijn voor back-uptechnieken die specifiek voor PostgreSQL zijn bedoeld.

Houd voor een ZimaOS- of Docker-thuisserver de implementatiedefinitie en het gegevensbeschermingsplan gescheiden: bewaar Compose-bestanden en image-tags zodat de service opnieuw kan worden opgebouwd, en beveilig de database met een databaseconsistente methode zodat de status kan worden hersteld.

Kopieer nooit zomaar een actief beschreven databasevolume

NAS-back-upsoftware kan verschillende databasebestanden op verschillende momenten uitlezen. Het resulterende archief kan een gegevensbestand uit de ene transactiestatus bevatten, een logboek uit een andere en metagegevens uit een derde. Een overzicht van opensourceback-upmethoden voor SQL waarschuwt dat een database die in gebruik is op een inconsistent moment kan worden vastgelegd, terwijl belangrijke status nog in het geheugen staat.

Crashherstel kan sommige atomair gemaakte snapshots herstellen, maar een gewone recursieve bestandskopie is niet atomair. Als de app geen downtime kan verdragen, gebruik dan een logische dump, een ondersteunde fysieke back-uptool of een gecoördineerde snapshot.

Behandel SQLite-containers als databases, niet als gewone bestanden

Veel apps voor thuisservers gebruiken SQLite omdat het compact en eenvoudig te implementeren is. Het risico is dat beheerders één .db-bestand zien en aannemen dat ze het kunnen kopiëren terwijl de app ernaar schrijft. In de WAL-modus kunnen recente vastgelegde wijzigingen nog buiten het hoofdbestand staan. Een praktisch artikel over SQLite-herstel raadt aan het online back-upmechanisme te gebruiken of een schone kopie te maken nadat de database is gesloten, in plaats van een live databasebestand te kopiëren.

Gebruik de ingebouwde back-upfunctie van de applicatie als die er is. Gebruik anders de online back-upfunctie van SQLite of stop de applicatie op de juiste manier voordat je de hele databasemap kopieert. Kopieer niet alleen het hoofddatabasebestand terwijl het journal of de WAL-status achterblijft.

Kies de methode op basis van downtime, databasegrootte en herstelbaarheid

Voorwaarden voor een thuis-NAS Beste startmethode Belangrijkste afweging
Kleine database, dagelijkse back-up, eenvoudige migratie Logische dump Langere dumptijd naarmate de database groeit
Kleine database, onderhoudsvenster beschikbaar Netjes stoppen en fysiek volume kopiëren Vereist downtime en versiecompatibiliteit
Grote database, kort back-upvenster Gecoördineerde databasesnapshot of native fysieke back-up Complexere hooks, bewaartermijnen en hersteltests
SQLite-app met ingebouwde exportfunctie Applicatie-export of online back-up van SQLite Mogelijk is applicatiespecifieke automatisering nodig
Media- of documentapp met database en uploads Databaseconsistente back-up plus gesynchroniseerde bestandsback-up De tijdstempels van de database en bestanden moeten binnen hetzelfde herstelvenster vallen

Maak een back-up van de hele zelfgehoste applicatie, niet alleen van de database

Een bruikbaar herstelpakket moet de databaseback-up, het Docker Compose-bestand, de imageversies, omgevingsvariabelen of een herstelbaar pakket met geheimen, reverse-proxy-instellingen, app-configuratie, geüploade bestanden en eventuele versleutelingssleutels bevatten. Alleen de SQL-dump back-uppen kan records herstellen, maar laat de app mogelijk zonder toegang tot foto's, documenten, miniaturen, certificaten of opslagpaden achter.

Voor herstelplanning voor thuisservers legt de gids van ZimaSpace over bind mounts en benoemde volumes uit waarom zichtbare opslagpaden het herstel vergemakkelijken, maar een databaseback-up die consistent is met de app niet vervangen.

Bewijs dat de methode werkt door te herstellen naar een nieuwe container

Maak een geïsoleerde teststack met een nieuwe projectnaam, andere hostpoorten en een tijdelijke gegevensmap. Herstel de dump of snapshot, start de database, voer de integriteits- of consistentiecontroles uit en verbind vervolgens een testkopie van de app. Controleer of gebruikers, records, bijlagen en recente transacties aanwezig zijn.

Meet zowel het herstelpunt als de hersteltijd. Als een logische dump consistent is, maar het herstel te lang duurt, behoud die dan als draagbare hersteloptie en voeg een snellere, gecoördineerde snapshot toe. Als een kopie van een gestopt volume snel kan worden hersteld, maar alleen naar dezelfde databaseversie, bewaar dan een logische dump als terugvaloptie voor migraties.

Veelgestelde vragen

Is het voldoende om een databasecontainer te pauzeren voordat ik het volume kopieer?

Niet als algemene regel. Pauzeren bevriest het proces, maar bewijst niet dat de database de juiste status heeft weggeschreven voor een overdraagbare back-up. Gebruik een database-eigen dump, een schone afsluiting of een gedocumenteerde procedure om de database te pauzeren en een snapshot te maken.

Is een NAS-snapshot op zichzelf voldoende voor PostgreSQL of MariaDB?

Alleen als de snapshot atomair is en wordt gecoördineerd met het ondersteunde consistentieproces van de database. Een niet-gecoördineerde snapshot is mogelijk alleen crashconsistent, en een niet-atomische bestandskopie kan nog slechter zijn.

Wat moet ik back-uppen voor een app op een thuisserver die SQLite gebruikt?

Gebruik de exportfunctie van de app of de online back-upfunctie van SQLite als die beschikbaar is. Bewaar ook de app-configuratie, het Compose-bestand, geheimen, bijlagen en de map met de database. Ga er niet van uit dat het belangrijkste .db-bestand de hele app is.

Eindaanbeveling

Gebruik geplande logische dumps als standaard voor de meeste PostgreSQL- en MariaDB-containers op een thuis-NAS. Gebruik een schone kopie van het gestopte volume als korte downtime acceptabel is, en gebruik gecoördineerde snapshots of database-eigen fysieke tools als de database groot is of het herstelpuntvenster krap is. Welke methode je ook kiest, herstel de back-up in een nieuwe container voordat je erop vertrouwt.

Ondersteuning en tips

Meer om te lezen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.