Cheatsheets

Cheatsheet: Nginx

Nginx beheren: de configuratie testen, de dienst herladen en de handigste blokken voor je configuratie.

Beheer

De configuratie controleren (altijd eerst!) sudo nginx -t
De volledige samengestelde configuratie tonen sudo nginx -T
Herladen zonder onderbreking sudo systemctl reload nginx
Herstarten sudo systemctl restart nginx
De status tonen systemctl status nginx
De versie en de opties waarmee hij is gebouwd nginx -V

Logboeken

Toegangslogboek meelezen sudo tail -f /var/log/nginx/access.log
Foutenlogboek meelezen sudo tail -f /var/log/nginx/error.log
De laatste 50 fouten sudo tail -n 50 /var/log/nginx/error.log

Een site activeren (Debian en Ubuntu)

Een site inschakelen sudo ln -s /etc/nginx/sites-available/mijnsite /etc/nginx/sites-enabled/
Een site uitschakelen sudo rm /etc/nginx/sites-enabled/mijnsite
Plaats van de hoofdconfiguratie /etc/nginx/nginx.conf

Certificaten (certbot)

Een certificaat aanvragen en instellen sudo certbot --nginx -d voorbeeld.nl -d www.voorbeeld.nl
Vernieuwen testen sudo certbot renew --dry-run
Controleer het resultaat curl -I https://voorbeeld.nl

Testen

Een site testen zonder DNS (andere hostnaam) curl -I -H "Host: voorbeeld.nl" http://127.0.0.1
De headers van een pagina curl -sI https://voorbeeld.nl

Goed om te weten

  • Een statische site: server { listen 80; server_name voorbeeld.nl; root /var/www/voorbeeld; index index.html; }
  • Doorsturen naar een app (reverse proxy): binnen een location / { } zet je proxy_pass http://127.0.0.1:3000; en de regels proxy_set_header Host $host; en proxy_set_header X-Forwarded-For $remote_addr;.
  • Van http naar https: in een server op poort 80: return 301 https://$host$request_uri;
  • Test altijd met nginx -t voor je herlaadt: een fout in de configuratie kan de hele site onderuit halen.
  • Meer over https en proxy’s: Reverse proxy met https, en controleer het resultaat met onze SSL-check en HTTP-headers-tool.

Bronnen en bronvermelding

Dit overzicht is in eigen woorden samengesteld. Commando’s en opties veranderen per versie: controleer bij twijfel de officiële documentatie.