Varför ger Immich tillfälliga fel vid import av stora mobilbibliotek?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Intermittenta fel i Immich under en stor mobilimport innebär vanligtvis att ett lager fallerar när flera saker sker samtidigt, inte att hela biblioteket eller alla uppladdade filer är skadade.

Stora importer kombinerar mobilens beteende i bakgrunden, långa begäranden, begränsningar i omvänd proxy eller tunnel, databasskrivningar, lagrings-I/O, arbete med miniatyrbilder och video samt köer för maskininlärning. Börja med att fånga in en liten grupp misslyckade filer och tidsstämplar. Ta sedan reda på om felet börjar i telefonen, på nätverksvägen, på applikationsservern eller i ett överbelastat beroende.

Klassificera felgruppen innan du försöker igen med allt

Gruppera felen efter medietyp, filstorlek, källenhet, nätverksväg och tidpunkt. Om bara stora videor misslyckas bör du undersöka hur länge begärandena pågår och vilka uppladdningsbegränsningar som finns innan du tittar på processorn. Om slumpmässigt utvalda foton och videor misslyckas vid samma perioder med hög belastning blir delade serverresurser eller instabilt nätverk mer sannolika orsaker.

En användarrapport från 2026 om Immich som beskriver många fel vid mobiluppladdningar är användbar eftersom den visar hur en stor kö på en telefon kan leda till upprepade fel som behöver diagnostiseras per fil och nätverksväg. Den fastslår inte att det finns ett universellt fel i mobilklienten.

Välj inte ”försök igen med alla” som första felsökningsåtgärd. Spara namnen eller ID:na för tio misslyckade filer, en lyckad kontrollfil och motsvarande tidsperiod i klient- och serverloggarna. En liten, känd grupp gör att du kan testa ändringar utan att skapa en ny våg som döljer de ursprungliga ledtrådarna.

Jämför lokala uppladdningar med den vanliga fjärrvägen

Ladda upp samma små och stora testfiler via stabilt lokalt Wi-Fi direkt till den betrodda lokala slutpunkten och upprepa sedan via det vanliga fjärrvärdnamnet, VPN:et, tunneln eller omvända proxyn. Använd samma konto och fil så att nätverksvägen är den huvudsakliga variabeln.

En rapport om fel vid säkerhetskopiering av stora filer visar varför begränsningar för begäranden i en proxy eller tunnel hör hemma här. Den rapporterade tjänsten och tröskelvärdena är specifika för driftsättningen; det allmänna testet är om en direkt lokal överföring fungerar medan fjärrvägen konsekvent misslyckas.

Om båda vägarna misslyckas med samma filer bör du följa ledtrådar från servern och lagringen. Om bara fjärrvägen misslyckas bör du kontrollera maximal storlek på begärandekroppen, buffring av begäranden, tidsgränser för inaktivitet och läsning, TLS-terminering, övergångar mellan mobilnät och omsändningar. Att ändra parallelliteten för miniatyrbilder löser inte en begäran som aldrig når Immich i sin helhet.

Koppla fel till växande köer och resursbelastning

Stora importer kan fortsätta ta emot uppladdningar samtidigt som bakgrundsjobb samlas på hög. Övervaka processoranvändning, minnesbelastning, svarstid för block-I/O, databassvar, omstarter av containrar och slutförda jobb under felperioden. Hög belastning i sig är inget bevis; mätvärdet måste förändras samtidigt som felen uppstår.

Artikeln om övervakning av Docker-resurser och CPU-, minnes-, nätverks- och diskstatistik för containrar visar värdet av att jämföra containrar i stället för att läsa av ett enda genomsnitt för hela värddatorn. I Linux kombinerar du containerstatistik med uppgifter om värddatorns lagring och minnestryck för samma tidsstämplar.

Om minnestryck leder till att containrar avslutas, lagringsfördröjningen ökar samtidigt med uppladdningsfelen eller databassvarstiden skjuter i höjden samtidigt som kön slutar gå framåt, ska du endast minska belastningen eller samtidigheten för det ansvariga arbetsflödet och upprepa testet med den fasta gruppen. Om resursgraferna är lugna fortsätter du med programloggar och felsökning av nätverksvägen.

Se felfrekvens och svarstid i den långsamma svansen som belastningssignaler

Ett system kan verka friskt utifrån den genomsnittliga svarstiden, samtidigt som en liten andel förfrågningar får tidsgränsöverskridanden vid belastningstoppar. Registrera antalet försökta uppladdningar, fel, medianens svarstid och de långsammaste förfrågningarna under ett kontrollerat tidsfönster. Då blir ”intermittent” mätbart i stället för anekdotiskt.

Testramverket för belastning i analysen av fel och svarstider rekommenderar att statusklasser, anslutningsproblem, fördelningar och tidsseriekorrelationer analyseras. Du behöver inte belastningstesta familjens bibliotek aggressivt; använd samma analysmetod för den verkliga importraten.

Om en kraftig minskning av ankomsttakten tydligt sänker antalet fel, samtidigt som varje enskild fil lyckas, saknar den nuvarande stacken kapacitet för importbelastningen. Om samma filer misslyckas även en i taget är problemet filspecifikt, sökvägsspecifikt eller ett deterministiskt programfel snarare än generell överbelastning.

Minska en belastningskälla och testa samma importmönster igen

Välj den säkraste ändringen som stöds av underlaget: minska en bakgrundsprocess samtidighet, pausa en annan tung container, använd den lokala anslutningsvägen, flytta importen så att den inte sammanfaller med ett säkerhetskopieringsfönster eller justera en proxytidsgräns. Ändra inte CPU-gränser, lagring, proxyregler och appversioner samtidigt.

Arbetsflödet i ZimaSpace för avbrott i säkerhetskopieringen av mobilbilder visar vad som kan gå fel på mobilen: schemaläggning i bakgrunden, original som bara finns i molnet och förändrade nätverksförhållanden kan avbryta uppladdningar även när servern fungerar som den ska.

Gå vidare när den fasta gruppen lyckas och samma större import körs med en stabil felfrekvens, köerna fortsätter framåt och den interaktiva prestandan är acceptabel. Eskalera när felen kvarstår vid låg belastning eller upprepas för samma filer. Bifoga klientloggar, serverloggar, proxystatus, resursgrafer, filtyp och storlek samt den första misslyckade begäran.

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.