En aquest tema, explorarem alguns dels problemes més comuns que es poden trobar quan es treballa amb NGINX i les seves solucions. Aquesta secció està dissenyada per ajudar-te a identificar i resoldre problemes de manera eficient.
- Error 502 Bad Gateway
Descripció
Aquest error indica que NGINX no pot comunicar-se amb el servidor backend.
Causes comunes
- El servidor backend està caigut.
- El servidor backend està saturat.
- Configuració incorrecta del proxy.
Solució
-
Verifica que el servidor backend estigui actiu:
systemctl status backend-service
-
Revisa la configuració del proxy en el fitxer de configuració de NGINX:
server { location / { proxy_pass http://backend_server; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }
-
Augmenta el temps d'espera del proxy si el backend és lent:
proxy_read_timeout 90; proxy_connect_timeout 90; proxy_send_timeout 90;
- Error 504 Gateway Timeout
Descripció
Aquest error indica que NGINX ha esperat massa temps per obtenir una resposta del servidor backend.
Causes comunes
- El servidor backend està processant una sol·licitud molt lenta.
- Configuració de temps d'espera massa curta.
Solució
-
Augmenta els temps d'espera del proxy:
proxy_read_timeout 120; proxy_connect_timeout 120; proxy_send_timeout 120;
-
Optimitza el rendiment del servidor backend per assegurar-te que les sol·licituds es processen més ràpidament.
- Error 413 Request Entity Too Large
Descripció
Aquest error es produeix quan una sol·licitud supera la mida màxima permesa per NGINX.
Causes comunes
- La mida de la sol·licitud és massa gran.
Solució
- Augmenta la mida màxima de la sol·licitud en el fitxer de configuració de NGINX:
server { client_max_body_size 50M; }
- Error 403 Forbidden
Descripció
Aquest error indica que l'accés a la pàgina o recurs sol·licitat està prohibit.
Causes comunes
- Permisos de fitxers o directoris incorrectes.
- Configuració de seguretat de NGINX.
Solució
-
Verifica els permisos dels fitxers i directoris:
sudo chown -R www-data:www-data /path/to/your/webroot sudo chmod -R 755 /path/to/your/webroot
-
Revisa la configuració de NGINX per assegurar-te que no hi ha restriccions innecessàries:
server { location / { allow all; # O altres configuracions de seguretat adequades } }
- Error 404 Not Found
Descripció
Aquest error indica que el recurs sol·licitat no es troba al servidor.
Causes comunes
- El fitxer o directori no existeix.
- Configuració incorrecta de les rutes.
Solució
-
Verifica que el fitxer o directori existeixi en el camí especificat.
-
Revisa la configuració de les rutes en el fitxer de configuració de NGINX:
server { location / { root /path/to/your/webroot; try_files $uri $uri/ =404; } }
- Error 500 Internal Server Error
Descripció
Aquest error indica que hi ha un problema intern al servidor.
Causes comunes
- Errors en el codi del servidor backend.
- Configuració incorrecta de NGINX.
Solució
-
Revisa els registres d'errors de NGINX per obtenir més informació:
tail -f /var/log/nginx/error.log
-
Verifica la configuració de NGINX per assegurar-te que no hi ha errors de sintaxi:
sudo nginx -t
-
Revisa el codi del servidor backend per detectar possibles errors.
Conclusió
En aquesta secció, hem revisat alguns dels problemes més comuns que es poden trobar quan es treballa amb NGINX i les seves solucions. Identificar i resoldre aquests problemes de manera eficient és crucial per mantenir el teu servidor en funcionament òptim. En el següent tema, explorarem tècniques d'optimització del rendiment per assegurar-nos que NGINX funcioni de manera eficient sota càrrega.
Curs de NGINX
Mòdul 1: Introducció a NGINX
Mòdul 2: NGINX com a servidor web
- Servint contingut estàtic
- Llistats de directoris
- Pàgines d'error personalitzades
- Registre i formats de registre