Analyse des journaux d'erreurs Nginx pour le dépannage des erreurs « Connection Refused »
Apprenez les meilleures pratiques pour interpréter les journaux d'erreurs Nginx afin d'identifier la cause profonde des problèmes de « connexion refusée », en abordant les paramètres de socket et les vérifications des serveurs amont (upstream).
Lorsque vous rencontrez une erreur « connection refused » avec Nginx, cela signifie généralement que le client a tenté de se connecter à un port, mais qu'aucun processus n'écoute sur ce port spécifique.
1. Localiser les journaux d'erreurs
Par défaut, Nginx enregistre les erreurs dans /var/log/nginx/error.log. Utilisez la commande suivante pour surveiller les erreurs en temps réel :
tail -f /var/log/nginx/error.log
2. Causes courantes
- Le service amont est arrêté : Vérifiez si votre application (ex: Node.js, PHP-FPM, Python) est en cours d'exécution.
- Mauvaise configuration du port : Vérifiez que votre bloc
upstreampointe vers le bon port. - Problèmes de pare-feu : Assurez-vous que les règles
iptablesouufwautorisent le trafic sur le port concerné.
3. Vérification des sockets
Utilisez netstat ou ss pour confirmer qu'un processus écoute bien sur le port attendu :
sudo ss -tulpn | grep :<port>
En suivant ces étapes, vous pourrez isoler rapidement si le problème provient de la configuration de Nginx ou de l'état de votre service backend.