Alla artiklar

Nginx serverblock statisk sajt spa: bygg ett komplett serverblock

För robotar
17 november 2026
Nginx serverblock statisk sajt spa: bygg ett komplett serverblock

Ett nginx serverblock statisk sajt spa kräver att flera delar samspelar: TLS, gzip-komprimering, asset-cache med Cache-Control, säkerhetsheaders och rate limit. Den här artikeln går igenom hur du bygger ett sådant serverblock steg för steg, oavsett om du serverar en ren statisk sajt eller ett en-sidig webbprogram.

Vad ett nginx serverblock är

Ett serverblock i nginx är den konfiguration som avgör hur webbservern svarar på förfrågningar till ett visst domännamn. Nginx är en öppen källkods-webbserver och omvänd proxy som ursprungligen skrevs av Igor Sysoev och släpptes 2004, enligt sv.wikipedia.org. Ett serverblock definieras med direktivet server och kan innehålla flera location-block som hanterar olika sökvägar på sajten.

När en besökare begär en sida letar nginx efter det serverblock som matchar domänen och porten. Inom det blocket matchas sedan varje begäran mot ett location-block. För en statisk sajt eller ett SPA innebär det att filerna finns på disk och att nginx skickar dem direkt till besökaren utan att köra något server-sidigt program.

Förberedelser innan du börjar

Innan du skriver konfigurationen behöver du tre saker på plats:

  1. Ett domännamn som pekar till serverns IP-adress.
  2. En mapp på servern där sajtens filer ligger, till exempel /var/www/namn.se.
  3. Ett TLS-certifikat för HTTPS, till exempel från Let's Encrypt.

Utan dessa tre på plats fungerar inte resten av konfigurationen. Kontrollera också att användaren som kör nginx-processen har läsrättigheter till filsökvägen där sajten finns.

Serverblocket för en statisk sajt

Ett grundläggande serverblock för en statisk sajt ser ut så här:

server { listen 80; server_name exempel.se www.exempel.se; root /var/www/exempel.se; index index.html;

location / {
    try_files $uri $uri/ =404;
}

}

Direktiven innebär:

  • listen 80 tar emot okrypterad HTTP-trafik på port 80.
  • server_name anger vilka domännamn blocket ska svara för.
  • root pekar ut mappen där sajtens filer finns.
  • index anger vilken fil som skickas när besökaren begär en katalog.
  • try_files i location / letar efter den begärda filen och returnerar 404 om den inte finns.

Lägg till TLS och HTTPS

För att tvinga HTTPS skapar du ett andra serverblock som lyssnar på port 443 med ssl aktiverat, samt ett omdirigeringsblock på port 80 som skickar all trafik till HTTPS:

server { listen 80; server_name exempel.se www.exempel.se; return 301 https://$host$request_uri; }

server { listen 443 ssl http2; server_name exempel.se www.exempel.se;

ssl_certificate /etc/letsencrypt/live/exempel.se/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/exempel.se/privkey.pem;

root /var/www/exempel.se;
index index.html;

location / {
    try_files $uri $uri/ =404;
}

}

Direktiven ssl_certificate och ssl_certificate_key pekar ut certifikatet och den privata nyckeln. http2 gör att flera resurser kan laddas parallellt över samma anslutning, vilket snabbar på sidladdningen.

SPA-specifika inställningar

Ett en-sidigt webbprogram (SPA) fungerar annorlunda än en statisk sajt med flera HTML-filer. Alla sidor i ett SPA renderas i webbläsaren med JavaScript, och servern behöver bara skicka samma index.html oavsett vilken sökväg besökaren anger. Annars får besökaren ett 404-fel vid sidladdning eller när han uppdaterar sidan.

Lösningen är att skriva om alla begäranden som inte matchar en riktig fil till index.html:

location / { try_files $uri $uri/ /index.html; }

Den sista delen, /index.html, är fallbacket. När nginx inte hittar filen eller katalogen skickar den istället index.html, och SPA:t tar över routningen i webbläsaren.

gzip-komprimering

gzip minskar storleken på textbaserade filer som HTML, CSS och JavaScript innan de skickas till besökaren. Det sparar bandbredd och gör att sidan laddar snabbare. Aktivera det i http-blocket eller i serverblocket:

gzip on; gzip_types text/plain text/css text/xml application/javascript application/json; gzip_min_length 1000; gzip_comp_level 5;

Direktivet gzip_types anger vilka filtyper som ska komprimeras. gzip_min_length ser till att mycket små filer inte komprimeras, eftersom det då kan ta längre tid än att skicka filen som den är. Bilder och andra redan komprimerade filer ska inte ingå i gzip_types.

Asset-cache med Cache-Control

Statiska tillgångar som bilder, typsnitt, CSS- och JavaScript-filer kan lagras i besökarens webbläsare under lång tid. Med Cache-Control anger du hur länge en fil får sparas innan den ska hämtas på nytt:

location ~* .(jpg|jpeg|png|gif|ico|svg|css|js|woff|woff2|ttf|eot)$ { expires 1y; add_header Cache-Control "public, immutable"; }

expires 1y sätter utgångstiden till ett år framåt. add_header Cache-Control med public, immutable berättar för webbläsaren att filen kan lagras av både webbläsaren och eventuella mellanlager, och att den inte kommer att ändras. För HTML-filer bör du inte använda lång cache, eftersom du då riskerar att besökare får se en gammal version av sajten.

Säkerhetsheaders

Säkerhetsheaders är HTTP-huvuden som berättar för webbläsaren hur den ska hantera sajten säkert. Lägg till dem i serverblocket eller i location /:

add_header X-Frame-Options "DENY" always; add_header X-Content-Type-Options "nosniff" always; add_header Referrer-Policy "no-referrer-when-downgrade" always; add_header Content-Security-Policy "default-src 'self'" always;

  • X-Frame-Options DENY förhindrar att din sajt visas inuti en iframe på en annan webbplats.
  • X-Content-Type-Options nosniff hindrar webbläsaren från att gissa filtypen, vilket skyddar mot vissa attacker.
  • Referrer-Policy anger vilken information som skickas när besökaren klickar vidare till en annan sajt.
  • Content-Security-Policy begränsar var resurser som skript och bilder får laddas från. default-src 'self' tillåter bara resurser från din egen domän.

Observera att Content-Security-Policy kan blockera inbettade skript och tredjepartstjänster om du inte anpassar den. Testa noggrant innan du sätter den i produktion.

Rate limit

Rate limit begränsar hur många begäranden en enskild besökare får göra per tidsenhet. Det skyddar servern mot överbelastning och enkla attacker. Konfigurera det i http-blocket:

limit_req_zone $binary_remote_addr zone=mylimit:10m rate=10r/s;

Sedan aktiverar du det i serverblocket eller location:

location / { limit_req zone=mylimit burst=20 nodelay; try_files $uri $uri/ /index.html; }

rate=10r/s tillåter i genomsnitt tio begäranden per sekund. burst=20 ger en tillfällig marginal för korta trafiktoppar, och nodelay innebär att begäranden inom burst hanteras utan kö. Justera värdena efter hur mycket trafik din sajt vanligtvis får.

Sammanfattning: ett komplett serverblock

Här är hur alla delar kan se ihop i ett serverblock för ett SPA:

server { listen 443 ssl http2; server_name exempel.se www.exempel.se;

ssl_certificate /etc/letsencrypt/live/exempel.se/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/exempel.se/privkey.pem;

root /var/www/exempel.se;
index index.html;

gzip on;
gzip_types text/plain text/css application/javascript application/json;
gzip_min_length 1000;

add_header X-Frame-Options "DENY" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "no-referrer-when-downgrade" always;

location / {
    limit_req zone=mylimit burst=20 nodelay;
    try_files $uri $uri/ /index.html;
}

location ~* \.(jpg|jpeg|png|gif|ico|svg|css|js|woff|woff2|ttf|eot)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

}

Med det här blocket får du TLS, gzip, lång cache för statiska tillgångar, säkerhetsheaders och rate limit i ett och samma serverblock. Kom ihåg att testa konfigurationen med nginx -t innan du laddar om nginx med systemctl reload nginx.

Vanliga misstag att undvika

  • Att glömma fallbacket /index.html för SPA, vilket leder till 404 vid sidladdning.
  • Att sätta lång cache på HTML-filer, så att besökare inte ser uppdateringar.
  • Att lägga bilder och redan komprimerade filer i gzip_types, vilket inte ger någon nytta.
  • Att använda en för strikt Content-Security-Policy utan att testa, vilket kan bryta sidan.
  • Att köra om konfigurationen utan att först köra nginx -t, vilket kan stoppa servern om det finns ett fel.

Att bygga ett komplett nginx-serverblock handlar om att få alla delar att samspela. Med TLS, gzip, asset-cache, säkerhetsheaders och rate limit på plats är din statiska sajt eller ditt SPA både snabbare och säkrare för besökarna.

Relaterade artiklar