Varför slutar Immich att visa sökbara privata foton efter en omstart?

Eva Wong är Teknisk skribent och den boende fixaren på ZimaSpace. En livslång nörd med en passion för hemma-labb och öppen källkod, hon specialiserar sig på att översätta komplexa tekniska koncept till tillgängliga, praktiska guider. Eva tror att självhosting ska vara roligt, inte skrämmande. Genom sina handledningar ger hon gemenskapen verktyg att avmystifiera hårdvaruinstallationer, från att bygga sin första NAS till att bemästra Docker-containrar.

Immich slutar vanligtvis att returnera sökbara privata foton efter en omstart eftersom Smart Search har förlorat sin maskininlärningssökväg, inte har hunnit värma upp sin modell eller inte kan slutföra jobben och läsa den lagring som bygger sökvektorer.

Om tidslinjen fortfarande visar originalen saknas fotona troligen inte; söklagret är ofullständigt. Behandla ett tomt resultat som ett problem med tjänstesökvägen i första hand, bevara databasen och uppladdningsbiblioteket och skilj sedan mellan en otillgänglig maskininlärningscontainer, fördröjda jobb, en felaktig slutpunkt eller ett behörighetsfel i den beständiga sökvägen innan du bygger om något.

Skilj mellan saknade sökresultat och saknade foton

Öppna flera kända objekt direkt från tidslinjen, albumen och ett privat bibliotek innan du testar sökningen. Godkänt innebär att databasen kan hitta posterna och att Immich kan läsa filerna; misslyckat innebär att detta är en bredare biblioteks- eller lagringsincident, så avbryt sökspecifika ändringar och skydda de berörda sökvägarna.

Gör tre upprepningsbara sökningar: ett begrepp som fungerade tidigare, ett visuellt uppenbart begrepp och ett nyligen uppladdat objekt efter att bakgrundsarbetet borde ha slutförts. Anteckna om resultaten är tomma, inaktuella eller begränsade till äldre foton. Dessa utfall skiljer ett totalt fel på slutpunkten från en eftersläpning i indexeringen.

En felsökningstråd i communityt samlar kontroller av Smart Search efter omstarter, bland annat nåbarhet för slutpunkten och körning av jobb igen. Använd dess diagnostiksekvens för söklagret som fallunderlag, inte som skäl att ta bort databasen eller generera om varje objekt.

Kontrollera maskininlärningssökvägen efter omstart

Kontrollera hälsan hos servern och maskininlärningscontainern och testa sedan den konfigurerade maskininlärnings-URL:en från det nätverksnamnrymd som anropar den. En nåbar slutpunkt med lyckade modellförfrågningar godkänner denna gren; anslutningsvägran, namnupplösningsfel eller en ohälsosam container pekar ut den tjänstesökväg som måste repareras.

Jämför det driftsatta tjänstenamnet, porten, miljövärdet, image-versionen och nätverksmedlemskapet med den senast fungerande Compose-definitionen. Återskapa endast den berörda containern efter att du har korrigerat en avvikelse. En ren omstart ersätter inte inaktuell containermiljö, så bekräfta det effektiva värdet i den återskapade arbetsbelastningen.

Ett rapporterat fall i Immich v2.6.1 kopplade misslyckad Smart Search till en ohälsosam maskininlärningscontainer. Felrapporten för den specifika versionen stöder kontroll av hälsa och loggar; den bevisar inte att varje fel efter en omstart beror på just den regressionen.

Kontrollera modellens beredskap, jobb och beständiga sökvägar

Följ maskininlärningsloggarna medan du skickar en känd sökning. Den första förfrågningen kan läsa in eller hämta en modell och tillfälligt använda mer minne; framsteg följt av ett lyckat svar godkänner grenen. Upprepade bortträngningar, avslut på grund av slut på minne eller misslyckade hämtningar pekar på problem med minne, beständig cache eller nätverk.

Kontrollera antalet Smart Search-jobb och de senaste felen utan att rensa dem. Om slutpunkten är frisk men jobben fortfarande är misslyckade eller köade, försök igen med en liten kontrollerad batch och se om antalet minskar. Om ett objekt lyckas, åtgärda arbetarnas samtidighet eller det misslyckade beroendet innan du schemalägger en fullständig omindexering.

Bekräfta att databasen, uppladdningsbiblioteket och modellcachen monteras på avsedda beständiga sökvägar med förväntad identitet. Den relaterade ZimaSpace-guiden om Immichs igenkänningsbeteende hjälper till att skilja åtkomst och indexeringsomfattning från ett saknat original.

Tillämpa den matchade åtgärden och testa efter två omstarter

Korrigera endast den bekräftade orsaken: återställ slutpunktens namn, återskapa containern med rätt miljö, gör modellcachen beständig, minska den uppmätta samtidigheten, reparera ägarskapet eller försök köra misslyckade Smart Search-jobb igen. Behåll den tidigare Compose-filen och en säkerhetskopia av databasen tillgängliga; radera inte inbäddningar som första åtgärd.

Testa samma tre frågor igen, ett gammalt objekt och en ny uppladdning. Godkänt kräver användbara resultat, köer med minskande antal jobb, läsbara original och stabil maskininlärningshälsa. Starta om stacken i dess normala beroendeordning och upprepa sedan; starta därefter om värden en gång för att bevisa att monteringar och namnupplösning överlever uppstart.

Rulla tillbaka om resultaten minskar, originalen blir oläsbara eller databasen rapporterar konsistensfel. Eskalera med Immich-version, effektiv slutpunkt, containerhälsa, relevanta loggar, jobbantal, modellnamn och monteringsmappningar om samma fel återkommer efter två omstarter; håll den gamla sökbara instansen isolerad men möjlig att återställa.

Support och tips

Mer att läsa

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.