So stimmen Sie Reverse-Proxy-Timeouts auf große Foto- und Video-Uploads ab

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Legen Sie Proxy-Timeouts anhand des langsamsten legitimen Uploads fest, den Sie akzeptieren möchten, und planen Sie einen Puffer ein. Achten Sie darauf, dass die Anwendung und jeder vorgeschaltete Proxy mindestens ebenso großzügig konfiguriert sind. Beheben Sie nicht jeden fehlgeschlagenen Upload, indem Sie ein unbegrenztes Timeout festlegen.

Ein großes Foto oder Video kann fehlschlagen, obwohl dieselbe App normal funktioniert, weil der Request-Body, die Upstream-Verarbeitung oder die Antwort eine andere Grenze überschreitet. Erfassen Sie zuerst den Statuscode, die verstrichene Zeit, die Dateigröße und das Proxy-Protokoll. Anhand dieser Beobachtungen lässt sich eine Ablehnung wegen der Größe des Request-Bodys von einem Leerlauf-Timeout, einem Backend-Timeout oder einem Verbindungsabbruch durch den Client unterscheiden.

Ermitteln, an welcher Stelle der Upload abgebrochen wird

Wiederholen Sie den Vorgang mit einer bekannten Datei und halten Sie fest, ob der Fehler während der Übertragung, nach Erreichen von 100 Prozent in der Fortschrittsanzeige oder während der Medienverarbeitung auf dem Server auftritt. Jede Phase entspricht einer anderen Verbindung und einem anderen Timeout.

Ein gleichbleibender Fehler bei derselben Byteanzahl deutet auf eine Größenbeschränkung für den Request-Body hin; ein Fehler nach derselben Leerlaufzeit deutet auf ein Timeout hin. Ein Gateway-Fehler nach Abschluss des Uploads weist auf die Wartezeit zwischen Proxy und Anwendung oder auf die Verarbeitungsgrenze der Anwendung hin.

Lesen Sie die Proxy-Zugriffs- und Fehlerprotokolle zusammen mit den Anwendungsprotokollen. Wenn der Client die Verbindung zuerst geschlossen hat, hilft es nicht, nur das Proxy-Timeout zu erhöhen. Überprüfen Sie das Verhalten der App im Hintergrund auf Mobilgeräten, die VPN-Stabilität und den Anfragepfad des Browsers.

Ein realistisches Timeout-Budget ermitteln

Teilen Sie die größte akzeptierte Datei durch die langsamste unterstützte Upstream-Datenrate, um die Übertragungszeit abzuschätzen. Planen Sie zusätzlich Zeit für TLS, Pufferung und schwankenden Durchsatz ein. Nutzen Sie diesen Wert als Obergrenze für legitime Vorgänge, nicht als Versprechen, dass jede langsame Verbindung für immer offen bleibt.

Unterscheiden Sie zwischen der Gesamtdauer und der Leerlaufdauer. NGINX dokumentiert beispielsweise separate Proxy-Timeout-Direktiven, von denen einige die Zeitspanne zwischen aufeinanderfolgenden Vorgängen statt der Dauer der gesamten Antwort messen.

Behalten Sie das Risiko von Denial-of-Service-Angriffen im Blick. Beschränken Sie Upload-Endpunkte durch Authentifizierung und Ratenbegrenzungen, bevor Sie Verbindungen wesentlich länger offen halten, und machen Sie die Administrationsoberfläche des Proxys nicht öffentlich zugänglich.

Alle Ebenen aufeinander abstimmen, ohne über das Ziel hinauszuschießen

Legen Sie die maximale Größe des Request-Bodys auf mindestens den von der Anwendung unterstützten Höchstwert fest. Stimmen Sie anschließend die Timeouts für das Lesen des Client-Bodys, den Upstream-Verbindungsaufbau, das Lesen der Upstream-Antwort und das Senden an den Upstream auf die beobachtete Fehlerphase ab.

Prüfen Sie, ob ein vorgeschaltetes CDN, ein Tunnel, ein Load Balancer oder ein zweiter Reverse-Proxy ein kürzeres, unveränderliches Limit vorgibt. Maßgeblich ist das kleinste Limit in der gesamten Kette. Eine Änderung am inneren Proxy allein kann daher ohne sichtbare Wirkung bleiben.

Dokumentieren Sie die Anwendungs-URLs und Proxy-Routen. Die ZimaSpace-Anleitung zu Immich auf einer Netzwerkfreigabe hilft dabei, Fehler beim Upload-Pfad von Verzögerungen und Ausfällen bei der Speichereinbindung zu unterscheiden.

Single board computer zimaboard2

Langsame, große und unterbrochene Uploads erneut testen

Laden Sie die ursprünglich fehlerhafte Datei am ursprünglichen Speicherort und mit der ursprünglichen Netzwerkgeschwindigkeit hoch. Der Test gilt erst dann als bestanden, wenn der Upload abgeschlossen ist, die Anwendung die Datei indexiert hat und sie abgespielt oder angezeigt werden kann – ein HTTP-Erfolgscode allein reicht nicht.

Drosseln Sie eine Testverbindung auf die niedrigste unterstützte Rate und wiederholen Sie den Test. Unterbrechen Sie anschließend absichtlich einen Upload; temporäre Dateien und unvollständige Datenbankeinträge sollten entsprechend dem Anwendungsverhalten bereinigt werden.

Erhöhen Sie die Timeouts nicht weiter, wenn die Protokolle einen Backend-Absturz, einen Speicherfehler oder ein festes Limit des vorgeschalteten Anbieters anzeigen. Setzen Sie überhöhte Werte zurück, beheben Sie den Fehler in der betroffenen Ebene und behalten Sie den kleinsten Timeout bei, der die gemessene Last zuverlässig abdeckt.

FAQ

Sollten alle Proxy-Timeouts denselben Wert haben? Nein. Verbindungsaufbau, Lesen des Client-Bodys, Warten auf die Antwort des Upstreams und Senden an den Client sichern unterschiedliche Phasen ab.

Warum funktioniert ein kleines Foto, während ein Video fehlschlägt? Das Video überschreitet möglicherweise eine Größenbeschränkung, dauert länger als ein Leerlauflimit oder erfordert eine längere Verarbeitung auf dem Server; Protokolle und der Zeitpunkt des Fehlers zeigen, woran es liegt.

Support und Tipps

Mehr zum Lesen

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.