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.

  1. 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ó

  1. Verifica que el servidor backend estigui actiu:

    systemctl status backend-service
    
  2. 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;
        }
    }
    
  3. Augmenta el temps d'espera del proxy si el backend és lent:

    proxy_read_timeout 90;
    proxy_connect_timeout 90;
    proxy_send_timeout 90;
    

  1. 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ó

  1. Augmenta els temps d'espera del proxy:

    proxy_read_timeout 120;
    proxy_connect_timeout 120;
    proxy_send_timeout 120;
    
  2. Optimitza el rendiment del servidor backend per assegurar-te que les sol·licituds es processen més ràpidament.

  1. 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ó

  1. Augmenta la mida màxima de la sol·licitud en el fitxer de configuració de NGINX:
    server {
        client_max_body_size 50M;
    }
    

  1. 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ó

  1. 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
    
  2. 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
        }
    }
    

  1. 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ó

  1. Verifica que el fitxer o directori existeixi en el camí especificat.

  2. 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;
        }
    }
    

  1. 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ó

  1. Revisa els registres d'errors de NGINX per obtenir més informació:

    tail -f /var/log/nginx/error.log
    
  2. Verifica la configuració de NGINX per assegurar-te que no hi ha errors de sintaxi:

    sudo nginx -t
    
  3. 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.

© Copyright 2024. Tots els drets reservats