Per la maggior parte delle installazioni di Immich basate su Docker, una bridge definita dall’utente è la scelta predefinita più pulita; la rete host è una soluzione mirata, non un miglioramento universale delle prestazioni.
Immich ha soprattutto bisogno di percorsi affidabili tra client e server, tra server e database, tra server e Redis, per il machine learning e per il reverse proxy. Entrambe le modalità di rete possono garantirli. La scelta dovrebbe basarsi sulla riproduzione del problema reale o del requisito di accesso, sulla verifica di una modalità per volta e sul mantenimento della configurazione più facile da monitorare e ripristinare.
Parti dai percorsi di cui Immich ha davvero bisogno
Rappresenta lo stack come una serie di connessioni, non di container: i client raggiungono l’endpoint pubblico o locale di Immich; il proxy raggiunge il server Immich; l’applicazione raggiunge PostgreSQL e Redis; il server raggiunge il servizio di machine learning. Indica quali connessioni restano all’interno di Docker e quali attraversano il confine dell’host.
Una bridge definita dall’utente assegna ai container uno spazio dei nomi di rete dedicato, consentendo al contempo ai servizi sulla stessa rete di individuarsi tramite il nome del servizio. La panoramica di modalità di rete Docker è utile per comprendere questa distinzione: le porte pubblicate servono i client sull’host o esterni, mentre il DNS dei container gestisce il traffico tra servizi.
Se tutti i percorsi necessari funzionano già su una bridge, la rete host non ha risolto un problema dimostrato. Mantieni la bridge e documenta i nomi dei servizi, le reti e le porte pubblicate, così da poter verificare una futura modifica al proxy o a Compose rispetto a una topologia nota.
Preferisci una bridge definita dall’utente quando sono importanti l’isolamento e i nomi stabili dei servizi
La modalità bridge consente ai servizi di Immich di comunicare su una rete applicativa dedicata senza esporre tutte le porte dei container sull’host. È particolarmente utile quando un reverse proxy condivide la rete e può raggiungere direttamente il servizio Immich tramite il suo nome, riducendo la dipendenza da un indirizzo IP del container che potrebbe cambiare dopo la sua ricreazione.
L’analisi dei compromessi della rete host in un homelab osserva che rimuovere il NAT di Docker raramente comporta un guadagno significativo in termini di prestazioni per il normale traffico web di un homelab. Le differenze più importanti riguardano l’isolamento degli spazi dei nomi, la pubblicazione delle porte e il modo in cui i servizi si individuano tra loro.
La modalità bridge è inadeguata come scelta progettuale solo quando un percorso necessario non può essere configurato o rimane inaffidabile dopo aver corretto la rete, il DNS, il firewall e l’appartenenza ai proxy. Non cambiare modalità solo perché un client segnala «server irraggiungibile»: verifica prima che la richiesta si blocchi al confine di Docker.
Usa la modalità host solo per un requisito specifico e riproducibile
La modalità host colloca il container nello spazio dei nomi di rete dell'host, eliminando la traduzione delle porte di Docker e fornendo al servizio il contesto di rete dell'host. Questo può semplificare alcuni casi di rilevamento o di routing insolito, ma elimina anche il confine delle porte a livello di container e aumenta il rischio di conflitti con le porte dell'host.
Un confronto aggiornato tra le reti bridge e host inquadra la scelta in base a prestazioni, isolamento, esposizione dei servizi e debug. Applica questi criteri al percorso di Immich, anziché presumere che la modalità host sia intrinsecamente più affidabile.
Se la modalità host risolve un problema, ripeti il test due volte e spiegane il motivo. Per esempio, verifica che lo stesso nome host, account, proxy e client falliscano con bridge e funzionino con host, mentre i log dell'applicazione restano altrimenti regolari. Se il risultato non è ripetibile, il cambio di modalità potrebbe aver solo mascherato un problema di DNS o uno stato di rete obsoleto.
Mantieni il reverse proxy su un percorso esplicito e ripristinabile
Dopo il riavvio di uno dei container, il reverse proxy dovrebbe raggiungere Immich tramite una definizione stabile del server upstream. Con una bridge, preferisci una rete definita dall'utente condivisa e un server upstream basato sul nome del servizio, anziché un IP del container copiato manualmente. Con la modalità host, indirizza il proxy all'indirizzo e alla porta host previsti, verificando che non ci siano conflitti.
Lo schema di test host o bridge di ZimaSpace applica una regola condizionale analoga: la semplicità di rilevamento può giustificare la modalità host, mentre l'isolamento e l'integrazione esplicita del proxy favoriscono una bridge. Immich usa protocolli diversi, quindi riutilizza il metodo decisionale, non le ipotesi sulle porte specifiche di Plex.
Riavvia prima solo il proxy, poi solo Immich e infine l'intero stack. Una configurazione valida ripristina ogni volta gli stessi percorsi locali e remoti, senza modificare gli indirizzi IP. Una topologia che richiede di riconfigurare manualmente i collegamenti dopo la ricreazione dei container non è abbastanza stabile, indipendentemente dall'uso della rete host o bridge.
Scegli la modalità che supera lo stesso test di accettazione con meno rischi
Verifica l'accesso web locale, la connessione dell'app mobile, un piccolo caricamento, un caricamento di grandi dimensioni, l'accesso tramite reverse proxy, lo stato di salute delle comunicazioni tra servizi e un riavvio completo. Registra latenza ed errori, ma non dare troppo peso a differenze minime di velocità se entrambe le modalità restano ben al di sotto del limite della rete.
Scegli bridge quando tutte le funzioni superano i test e trai vantaggio dall'esposizione esplicita, dal DNS dei container e dall'isolamento. Scegli host quando un percorso necessario fallisce ripetutamente su una configurazione bridge corretta e la modalità host risolve il problema senza creare conflitti di porte o ampliare l'esposizione oltre i limiti che accetti.
Se entrambe le modalità falliscono allo stesso modo, smetti di cambiare le impostazioni di rete. La causa è più probabilmente da ricercare nel DNS, nel TLS, nelle intestazioni del proxy, nell'autenticazione, nel firewall, nello storage o nell'applicazione stessa. Conserva la richiesta che fallisce e i log, ripristina la topologia più semplice di cui sai che funziona e diagnostica il confine successivo.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



