Waarom verliest Immich na het opnieuw aanmaken van de stack de toegang tot permanente gegevens?

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.

Als Immich er leeg uitziet of de bibliotheek niet kan lezen nadat de stack opnieuw is aangemaakt, ga er dan van uit dat de oude persistente gegevens niet gekoppeld of niet leesbaar zijn voordat u aanneemt dat ze zijn verwijderd.

Het opnieuw aanmaken van containers kan de Compose-projectidentiteit, de bron van een bindkoppeling, de koppeling van een benoemd volume, de timing van een netwerkschijf of de UID/GID die de gegevens leest veranderen. Stop de instantie die er net uitziet voordat deze veel nieuwe gegevens schrijft, lokaliseer de oude database- en mediapaden op de host en vergelijk de opnieuw aangemaakte stack met de laatst bekende goede koppeling. Het doel is om eerst de bestaande gegevens opnieuw te koppelen; herstel vanaf een back-up is pas aan de orde nadat u hebt vastgesteld dat die gegevens daadwerkelijk ontbreken of beschadigd zijn.

Stop de nieuwe instantie en controleer of de oude gegevens er nog zijn

Een installatiewizard, lege tijdlijn of ontbrekende externe bibliotheek vlak na het opnieuw aanmaken is een waarschuwing voor problemen met persistentie. Stop Immich en inspecteer de database- en medialocaties op de host voordat u nieuwe bestanden uploadt of een nieuwe, lege configuratie accepteert. Nieuwe schrijfbewerkingen kunnen latere padvergelijkingen lastiger maken.

Controleer de oude mappen op verwachte aantallen bestanden, wijzigingsdatums, databasebestanden of dumps en representatieve originele afbeeldingen. Als de gegevens op de host aanwezig zijn, gaat het om toegang of koppeling en niet om verdwijning. Maak een alleen-lezen momentopname of back-up van die gegevens voordat u het eigenaarschap wijzigt of mappen verplaatst.

Als de oude gegevens niet op de verwachte paden te vinden zijn, doorzoek dan de opslagpool en de Docker-volume-inventaris voordat u iets verwijdert. De keuze is binair: de bestaande gegevens worden gevonden en beschermd, of ze zijn daadwerkelijk niet beschikbaar en het herstel verloopt via een bekende goede back-up in plaats van herstel van de koppelingen.

Vergelijk de opnieuw aangemaakte koppelingen met de vorige stack

Inspecteer de effectieve koppelingen van de opnieuw aangemaakte Immich-server- en databasecontainers, niet alleen de Compose-tekst die u zich herinnert te hebben bewerkt. Een relatief bindpad kan worden opgelost vanuit een andere projectmap, en een hernoemd Compose-project kan een nieuw benoemd volume koppelen terwijl het oude intact maar ongebruikt blijft.

Een mislukte, gewijzigde of ontbrekende aankoppeling kan in een container een lege map opleveren, terwijl de verwachte gegevens elders op de host nog bestaan. Gebruik controles voor het aankoppelen van Docker-volumes om voor elk persistent Immich-pad de Source, Destination, het aankoppelingstype en de identiteit van het benoemde volume te vergelijken. Een afwijking hier verklaart rechtstreeks waarom de instantie er weer als nieuw uitziet.

Corrigeer alleen de onjuiste aankoppeling en maak of start daarna de container zonder volumes te verwijderen. Als de verwachte bestanden na de wijziging op hetzelfde containerpad verschijnen, laat de gegevens dan staan. Als de aankoppellijst klopt maar de toegang nog steeds mislukt, behoud dan de koppeling en controleer de beschikbaarheid van de hostopslag en de machtigingen in plaats van een ander volume aan te maken.

Controleer of de externe opslag was aangekoppeld voordat Immich startte

Als de gegevens van Immich op een HDD-pool, NAS-share, samenvoeglaag of andere externe opslagkoppeling staan, controleer dan of die opslag daadwerkelijk op de host is aangekoppeld voordat Docker de stack start. Een pad zoals /mnt/photos kan nog steeds bestaan als gewone lokale map wanneer het echte apparaat ontbreekt.

Docker-gegevens blijven alleen behouden wanneer een container wordt vervangen als het bedoelde volume of de bind mount opnieuw correct wordt gekoppeld. Het onderliggende model voor gegevenspersistentie van Docker-volumes zorgt er niet voor dat een ontbrekende hostschijf of netwerkshare automatisch beschikbaar wordt. Controleer dus op de host of het opslagapparaat beschikbaar is en of een bekend bestand erop staat voordat je hetzelfde pad in Immich test.

Als je ontdekt dat er reservebestanden naar het lege aankoppelpunt zijn geschreven terwijl de echte opslag niet beschikbaar was, stop dan Immich voordat je het apparaat op die plek aankoppelt. Verwerk die bestanden afzonderlijk, voeg een opstartafhankelijkheid of statuscontrole voor de opslagkoppeling toe en start daarna pas de stack opnieuw. Als de hostopslag stabiel is maar het containerpad nog steeds niet leesbaar is, ga dan verder met de machtigingen.

Single board computer zimaboard2

Controleer UID, GID en mapmachtigingen zonder alles opnieuw in te richten

Een opnieuw aangemaakte stack kan een service uitvoeren met een andere numerieke identiteit, gebruikersnaamruimte of beveiligingscontext dan voorheen. Dit ziet er anders uit dan een ontbrekende mount: het pad bestaat en bestanden zijn zichtbaar vanaf de host, maar de logboeken van Immich tonen machtigingsfouten of de service kan de verwachte bestanden niet aanmaken.

Vergelijk het numerieke eigenaarschap en de rechtenbits van de betrokken hostmappen met de gebruikersidentiteit in de opnieuw aangemaakte container. Test eerst een onschadelijke leesbewerking en daarna een omkeerbare schrijfbewerking op een tijdelijke locatie onder dezelfde mount. Wijzig niet recursief het eigenaarschap van het hele fotoarchief voordat je weet welke service schrijftoegang nodig heeft en welke oorspronkelijke bestanden ongewijzigd moeten blijven.

Los de kleinste afwijking in de mapstructuur of identiteit op die het probleem verklaart, start de service één keer opnieuw en controleer de logboeken opnieuw. Blijft de toegang mislukken terwijl de mounts en machtigingen overeenkomen, stop dan met wijzigingen aan het bestandssysteem en controleer de databaseverbinding, variabelevervanging of beveiligingslaag die bij het opnieuw aanmaken is veranderd.

Koppel de oorspronkelijke toestand opnieuw en controleer een volgende keer dat de stack opnieuw wordt aangemaakt

Zodra de oude database- en mediapaden zijn gekoppeld en leesbaar zijn, start je Immich en controleer je of de oude gebruikers, albums, personen en enkele representatieve bestanden zichtbaar zijn. Beschouw de reparatie niet als voltooid zodra de startpagina laadt; controleer of de applicatie de oorspronkelijke toestand leest en niet een nieuw geïnitialiseerde database ernaast.

Het belangrijkste onderscheid is dat containers wegwerpbaar kunnen zijn, terwijl de applicatiegegevens op stabiele opslag buiten de levenscyclus van de container moeten blijven staan. Documenteer de gecorrigeerde mountnamen en hostpaden en gebruik persistente opslagrollen voor de bestandsserver, zodat de volgende keer dat je de stack opnieuw aanmaakt, deze aan dezelfde gegevens gekoppeld blijft.

Maak de stack tot slot onder gecontroleerde omstandigheden nog een keer opnieuw aan en herhaal de oorspronkelijke controles. De oplossing is pas bewezen als dezelfde database en media na het opnieuw aanmaken én na een herstart van de host weer verschijnen. Als de oude toestand opnieuw verdwijnt, of als de database corruptie meldt in plaats van toegangsproblemen, zet dan de beveiligde kopie terug en kies voor herstel van de database of back-up in plaats van verder te experimenteren met mounts.

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.