Come adattare i timeout del reverse proxy ai caricamenti di foto e video di grandi dimensioni

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Imposta i timeout del proxy in base al caricamento legittimo più lento che intendi accettare, lasciando un margine, e configura l'applicazione e gli eventuali proxy upstream in modo che siano almeno altrettanto permissivi. Non risolvere ogni errore di caricamento impostando un timeout illimitato.

Una foto o un video di grandi dimensioni può non caricarsi anche se la stessa app funziona normalmente, perché il corpo della richiesta, l'elaborazione upstream o la risposta supera un limite diverso. Rileva prima il codice di stato, il tempo trascorso, la dimensione del file e il log del proxy. Queste informazioni permettono di distinguere il rifiuto dovuto alla dimensione del corpo da un timeout per inattività, un timeout del backend o una disconnessione del client.

Individua la fase in cui si interrompe il caricamento

Ripeti la prova con un file noto e annota se l'errore si verifica durante il trasferimento, dopo che la barra di avanzamento raggiunge il 100 percento o mentre il server elabora i contenuti multimediali. Ogni fase corrisponde a una connessione e a un timeout diversi.

Un errore che si verifica sempre allo stesso numero di byte suggerisce un limite alla dimensione del corpo; un errore dopo lo stesso intervallo di inattività suggerisce un timeout. Un errore del gateway dopo il completamento del caricamento indica un possibile problema di attesa tra il proxy e l'applicazione o un limite di elaborazione dell'applicazione.

Esamina i log di accesso ed errori del proxy insieme a quelli dell'applicazione. Se è stato il client a chiudere per primo la connessione, aumentare solo il timeout del proxy non servirà; verifica il comportamento in background sui dispositivi mobili, la stabilità della VPN e il percorso della richiesta nel browser.

Stima un budget di timeout giustificabile

Dividi la dimensione del file più grande accettato per la velocità minima supportata del server upstream per stimare il tempo di trasferimento, poi aggiungi un margine per TLS, buffering e variazioni della velocità. Usa questo valore come limite massimo per le operazioni legittime, non come garanzia che ogni connessione lenta debba restare aperta per sempre.

Distingui la durata totale dal tempo di inattività. Ad esempio, NGINX documenta direttive separate per i timeout del proxy, e alcune misurano l'intervallo tra operazioni successive anziché la durata dell'intera risposta.

Tieni presente il rischio di attacchi denial-of-service. Limita gli endpoint di caricamento con autenticazione e controlli di frequenza prima di estendere notevolmente la durata delle connessioni e non esporre l'interfaccia di amministrazione del proxy.

Allinea ogni livello senza esagerare

Imposta la dimensione del corpo della richiesta sul valore massimo supportato dall'applicazione o su uno superiore. Poi imposta i timeout per la lettura del corpo dal client, la connessione al server upstream, la lettura della risposta upstream e l'invio upstream in base alla fase in cui si verifica l'errore.

Verifica la presenza di una CDN esterna, un tunnel, un bilanciatore del carico o un secondo proxy inverso con un limite più breve e non modificabile. Il limite effettivo è il più basso della catena, quindi modificare solo il proxy interno potrebbe non produrre alcun risultato osservabile.

Documenta gli URL dell'applicazione e le route del proxy. La guida di ZimaSpace per Immich su una condivisione di rete aiuta a distinguere gli errori del percorso di caricamento dalla latenza e dalle interruzioni del montaggio dello spazio di archiviazione.

Ripeti il test con caricamenti lenti, voluminosi e interrotti

Carica il file originale che causava l'errore, nella posizione e alla velocità di rete originali. Il test è superato solo se il caricamento viene completato, l'applicazione indicizza il file e il contenuto è riproducibile o visualizzabile: non basta un codice HTTP di esito positivo.

Limita la velocità della connessione di prova al minimo supportato e ripeti il test. Poi interrompi deliberatamente un caricamento; i file temporanei e i record incompleti nel database dovrebbero essere rimossi secondo il comportamento dell'applicazione.

Smetti di aumentare i timeout quando i log mostrano un arresto anomalo del backend, un errore di archiviazione o un limite fisso del provider esterno. Ripristina valori non eccessivi, correggi il livello che causa il problema e mantieni il timeout più breve che copre in modo costante il carico di lavoro misurato.

FAQ

Tutti i timeout del proxy dovrebbero avere lo stesso valore? No. La creazione della connessione, la lettura del corpo della richiesta dal client, l'attesa della risposta del server upstream e l'invio al client proteggono fasi diverse.

Perché una foto di piccole dimensioni si carica, mentre un video non riesce? Il video potrebbe superare un limite di dimensione del corpo della richiesta, richiedere più tempo del limite di inattività o attivare un'elaborazione più lunga sul server; i log e il momento in cui si verifica l'errore permettono di capire quale sia la causa.

Assistenza e consigli

Altre letture

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.