Guide de dépannage du téléversement de photos et de vidéos volumineuses via un proxy inverse

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

L’approche sûre consiste à traiter un test contrôlé de taille et de durée, visant à identifier la couche défaillante avant de modifier les limites, la mise en mémoire tampon ou les paramètres réseau, comme une série d’étapes vérifiables plutôt que comme une seule commande.

Avec une application photo ou multimédia auto-hébergée derrière un ou plusieurs proxys, le risque concret est que les petits envois réussissent, mais que les photos ou vidéos volumineuses échouent, que la connexion soit réinitialisée ou que le délai d’attente soit dépassé via le proxy inverse. Notez l’identité actuelle et le point de récupération, commencez par le test le moins intrusif, interprétez les résultats de réussite et d’échec avant de modifier une autre variable, et arrêtez si le stockage devient instable ou si la seule copie récupérable risque d’être exposée. Le processus ci-dessous ne s’achève que lorsque la charge de travail initiale fonctionne ou que les éléments recueillis imposent une escalade.

Reproduire un envoi avec une série de fichiers de tailles croissantes

Utilisez le même client, compte, réseau, nom d’hôte et type de fichier. Envoyez un petit fichier témoin, puis des fichiers de test progressivement plus volumineux, en notant le nombre exact d’octets, la durée, l’erreur du navigateur, le statut HTTP, les horodatages des journaux d’accès et d’erreurs du proxy, les journaux de l’application et l’éventuelle apparition d’un objet partiel.

Testez le même fichier le plus volumineux via un point de terminaison direct et fiable de l’application, s’il est disponible. Si l’envoi direct réussit et que l’envoi via le proxy échoue, le chemin du proxy est en cause ; si les deux échouent à la même taille ou à la même étape, examinez le comportement de l’application, du stockage ou du client avant de modifier la configuration du proxy.

N’augmentez pas toutes les limites de taille et de délai d’attente en même temps. Conservez la configuration actuelle et les relevés d’espace libre, et arrêtez si les tests saturent le volume de données de l’application ou exposent un point de terminaison non protégé du serveur en amont.

Distinguer un rejet pour la taille d’un échec dû à la durée écoulée

Une erreur 413 ou un rejet immédiat à partir d’un seuil d’octets reproductible indique qu’une règle de taille du corps de la requête renvoie ce statut au premier niveau. Une erreur 408, 499, 502 ou 504, ou une réinitialisation de la connexion après une durée reproductible, indique plutôt un délai d’attente côté client, proxy, serveur en amont, tunnel ou application.

Un cas signalé dans la communauté Traefik impliquant un dépassement du délai lors de l’envoi de fichiers volumineux montre pourquoi la durée et l’ensemble du chemin entre le proxy et l’application comptent : l’envoi d’un fichier volumineux peut échouer via un tunnel alors que l’envoi de photos ordinaires et la navigation fonctionnent. Considérez ce cas comme un indice de diagnostic, et non comme une valeur de délai universelle.

Cartographiez chaque étape susceptible d’imposer des limites : CDN ou tunnel, proxy périphérique, proxy d’authentification, proxy applicatif, serveur d’application, environnement d’exécution et point de terminaison d’envoi. La première couche qui consigne ou renvoie l’échec détermine le test suivant.

Vérifiez la mise en mémoire tampon, le stockage temporaire et le transport

Surveillez les répertoires temporaires du proxy, les couches inscriptibles des conteneurs, les chemins d’envoi de l’application, la capacité du système de fichiers, la disponibilité des inodes et la mémoire pendant l’envoi du fichier de test. La mise en mémoire tampon peut consommer du disque ou de la mémoire avant que l’application ne reçoive le corps de la requête ; un volume de bibliothèque final généreux ne prouve donc pas que le proxy dispose d’un espace de travail.

Un rapport sur Nextcloud et Traefik concernant les échecs d’envoi de gros fichiers à plusieurs niveaux montre qu’un même symptôme avec un gros fichier peut toucher les couches Web, applicative et proxy. Tenez compte de cette leçon sur les différentes couches, tout en reliant votre modification au statut, à l’horodatage du journal et à la ressource réellement défaillante.

Si les échecs varient au lieu de se produire à une limite de taille ou de durée déterminée, comparez les connexions Ethernet, Wi-Fi, VPN et LAN directes. Conservez une route stable et testez séparément le MTU, la perte de paquets et le comportement du tunnel, au lieu d’augmenter les limites de l’application pour masquer les réinitialisations de connexion.

Appliquez une seule correction adaptée et relancez l’envoi d’origine

Ne modifiez que la limite confirmée : une limite de taille du corps de requête propre au périmètre concerné, le délai d’expiration spécifique de la requête ou de la réponse, le mode de mise en mémoire tampon ou l’allocation de stockage temporaire. Ne touchez pas à l’authentification, au TLS ni aux hôtes virtuels sans rapport, puis rechargez le proxy et vérifiez la configuration effective.

La procédure ZimaSpace de test du chemin direct par rapport au chemin via proxy montre comment une comparaison entre les deux chemins permet d’isoler le proxy après un redémarrage. Appliquez ici la même limite, puis renvoyez deux fois le même gros fichier et vérifiez sa taille finale, son checksum si disponible, le traitement des métadonnées et la suppression des fichiers temporaires.

Redémarrez le proxy une fois et relancez l’envoi depuis le chemin distant d’origine. Ne clôturez l’incident que lorsque les petits et les gros fichiers sont transférés avec succès sans nouvelle exposition ni pression sur le stockage ; annulez la modification si le changement de limite affecte d’autres hôtes et, si aucune limite n’est reproductible, transmettez le statut, le moment, la couche et les données sur les ressources.

Assistance et conseils

À lire aussi

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.