Handleiding voor probleemoplossing bij uploads van grote foto's en video's via een reverse proxy

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

De veilige aanpak is om een gecontroleerde test van bestandsgrootte en tijdsduur die de falende laag aanwijst, uit te voeren vóór je limieten, buffering of netwerkinstellingen wijzigt. Behandel dit als een reeks waarneembare controlemomenten, niet als één opdracht.

Bij een zelfgehoste foto- of media-applicatie achter een of meer proxy's bestaat het praktische risico erin dat kleine uploads lukken, maar grote foto's of video's via de reverseproxy mislukken, worden gereset of een time-out geven. Noteer de huidige identiteit en het herstelpunt, begin met de minst ingrijpende manier om onderscheid te maken, beoordeel de resultaten van geslaagde en mislukte tests voordat je een andere variabele wijzigt, en stop zodra de opslag instabiel wordt of de enige herstelbare kopie blootgesteld zou worden. Doorloop de stappen hieronder tot de oorspronkelijke werklast slaagt of het bewijs aanleiding geeft tot escalatie.

Reproduceer één upload met een reeks bestandsgroottes

Gebruik één client, account, netwerk, hostnaam en bestandstype. Upload een klein controlebestand en test vervolgens stapsgewijs grotere bestanden. Noteer het exacte aantal bytes, de duur, de browserfout, de HTTP-status, de tijdstempels in de toegangs- en foutenlogboeken van de proxy, de applicatielogboeken en of er een gedeeltelijk object verschijnt.

Test hetzelfde grootste bestand indien mogelijk via een vertrouwd, rechtstreeks applicatie-eindpunt. Lukt het rechtstreeks wel en via de proxy niet, dan is het proxypad de vermoedelijke oorzaak; mislukken beide bij dezelfde grootte of in dezelfde fase, onderzoek dan het gedrag van de applicatie, opslag of client voordat je de proxyconfiguratie wijzigt.

Verhoog niet alle limieten voor bestandsgrootte en time-outs tegelijk. Bewaar de huidige configuratie en metingen van de vrije ruimte, en stop als tests het gegevensvolume van de applicatie vullen of een onbeveiligd backend-eindpunt blootleggen.

Maak onderscheid tussen afwijzing vanwege de bestandsgrootte en uitval vanwege de verstreken tijd

Een onmiddellijke 413-fout of afwijzing bij een herhaalbare bytegrens wijst op een beleid voor de maximale bodygrootte in de eerste laag die die status teruggeeft. Een 408, 499, 502, 504 of verbindingsreset na een herhaalbare tijdsduur wijst eerder op een time-out bij de client, proxy, upstream, tunnel of applicatie.

Een casus uit de Traefik-community over time-out bij grote uploads laat zien waarom zowel de duur als het volledige pad van proxy naar app van belang zijn: een grote upload kan via een tunnel mislukken, ook als gewone foto's en browsen wel werken. Beschouw deze casus als een diagnostische indicatie, niet als een universele time-outwaarde.

Breng alle hops in kaart die limieten kunnen afdwingen: CDN of tunnel, edgeproxy, authenticatieproxy, applicatieproxy, appserver, runtime en uploadendpoint. De eerste laag die de fout registreert of retourneert, bepaalt de volgende test.

Controleer buffering, tijdelijke opslag en transport

Houd tijdens het uploaden van het testbestand de tijdelijke mappen van de proxy, de beschrijfbare containerlagen, de uploadpaden van de applicatie, de capaciteit van het bestandssysteem, de beschikbaarheid van inodes en het geheugen in de gaten. Buffering kan schijf- of geheugenruimte verbruiken voordat de applicatie de body ontvangt. Een ruime opslagruimte voor de uiteindelijke bibliotheek bewijst dus niet dat de proxy voldoende werkruimte heeft.

Een melding over Nextcloud en Traefik rond het mislukken van grote uploads op meerdere lagen laat zien hoe hetzelfde probleem met grote bestanden kan optreden op web-, applicatie- en proxylagen. Pas de les over meerdere lagen toe, maar stem je wijziging af op de status, het tijdstempel in het logboek en de resource die daadwerkelijk uitvalt.

Als de fouten variëren in plaats van een vaste grens voor grootte of tijd te volgen, vergelijk dan Ethernet-, wifi-, VPN- en directe LAN-routes. Behoud één stabiele route en test MTU, pakketverlies en tunnelgedrag afzonderlijk, in plaats van applicatielimieten te verhogen om verbindingsonderbrekingen op transportniveau te maskeren.

Pas één gerichte oplossing toe en herhaal de oorspronkelijke upload

Wijzig alleen de bevestigde grens: een specifiek ingestelde limiet voor de bodygrootte, de betreffende time-out voor verzoeken of antwoorden, de buffermodus of de toewijzing van tijdelijke opslag. Laat authenticatie, TLS en niet-gerelateerde virtuele hosts ongewijzigd, laad vervolgens de proxy opnieuw en controleer de actieve configuratie.

De ZimaSpace-workflow voor een test van het directe pad versus het proxypad laat zien hoe een vergelijking tussen direct en via de proxy na een herstart de proxyroute isoleert. Pas hier dezelfde grens toe, herhaal het exacte grote bestand vervolgens twee keer en controleer de uiteindelijke grootte, de checksum indien beschikbaar, de metadataverwerking en het opruimen van tijdelijke bestanden.

Start de proxy één keer opnieuw op en herhaal de upload vanaf het oorspronkelijke externe pad. Sluit het incident pas wanneer zowel kleine als grote bestanden zonder nieuwe blootstelling of opslagdruk slagen; draai de wijziging terug als de limietaanpassing gevolgen heeft voor andere hosts, en escaleer met bewijs van status, timing, laag en resources wanneer geen reproduceerbare grens kan worden vastgesteld.

Ondersteuning en tips

Meer om te lezen

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.