{"canonical_url":"https://engineer.company/nb/glossary/nginx/","content_markdown":"# nginx\n\n## Hva det er\n\nnginx er et program med åpen kildekode som tar imot HTTP-forbindelser og, for hver\nforespørsel, enten svarer med filer fra disken eller sender forespørselen videre til en\nannen server og leverer svaret tilbake. Navnet uttales «engine x», og prosjektets egne\nsider skriver det også NGINX. Igor Sysoev skrev programmet, og den første offentlige\nversjonen, 0.1.0, kom 4. oktober 2004. Det er gratis å bruke under en BSD-lisens med to\nklausuler, og F5, Inc. selger bedriftsdistribusjoner, support og opplæring.\n\nProsjektet lister opp seks roller: HTTP-server, omvendt proxy, innholdscache,\nlastbalanserer, proxy for TCP og UDP, og e-postproxy. På en webvert har nginx som regel\nén av to jobber, eller begge: å levere statiske filer fra disken, og å stå foran en\napplikasjonsserver, der det terminerer TLS og sender hver forespørsel videre innover.\n\nNår nginx starter, kjører det én hovedprosess (master) og flere arbeidsprosesser\n(workers). Hovedprosessen leser og kontrollerer konfigurasjonen og passer på\narbeidsprosessene. Arbeidsprosessene kjører som en bruker uten privilegier og gjør alt\narbeidet med forespørslene. Hver av dem bruker en hendelsesbasert løkke, bygd på epoll i\nLinux og kqueue i FreeBSD, og derfor kan en håndfull arbeidsprosesser holde tusenvis av\nforbindelser åpne samtidig. Direktivet worker_processes bestemmer hvor mange det er,\nenten som et fast tall eller som auto for én per prosessorkjerne, og ifølge prosjektets\nfunksjonsliste bruker 10 000 inaktive keep-alive-forbindelser ca. 2,5 MB minne.\n\nKonfigurasjonen er en tekstfil med direktiver. Et enkelt direktiv er et navn med\nparametere og slutter med semikolon. Et blokkdirektiv rammer inn andre direktiver i\nkrøllparenteser, og en blokk som kan inneholde direktiver, kalles en kontekst.\nKontekstene events og http ligger på øverste nivå. Inne i http beskriver hver\nserver-blokk én virtuell server, som velges først ut fra adressen og nettverksporten den\nlytter på, og deretter ut fra vertsnavnet klienten spurte etter. Inne i en server-blokk\nsier hver location-blokk hva som skal skje med en familie av forespørselsstier.\n\n## Hvorfor det er viktig\n\nWebserveren er det ene programmet alle besøkende er innom, så oppførselen under\nbelastning og standardverdiene rammer alle. To egenskaper taler for nginx.\n\nDen første er hvor billig nginx bærer trege forbindelser. Bufring av svar fra serveren\nbak proxyen er slått på som standard: nginx tar imot svaret fra backenden så fort\nbackenden klarer å lage det, skriver det over i en midlertidig fil når det blir for\nstort for minnet, og gir det deretter videre til klienten i det tempoet klienten klarer.\nApplikasjonsserveren er ledig for neste forespørsel mens en mobil med svakt signal\nfremdeles laster ned den forrige.\n\nDen andre er at endringer i konfigurasjonen rulles ut uten at forespørsler faller bort.\nEn endret konfigurasjon virker først etter en omlasting (reload) eller en omstart. Ved\nen omlasting kontrollerer hovedprosessen den nye konfigurasjonen og prøver å ta den i\nbruk. Går det, starter nye arbeidsprosesser med den, mens de gamle slutter å ta imot\nforbindelser, gjør ferdig forespørslene de har, og avslutter. Går det ikke, ruller\nhovedprosessen tilbake og fortsetter med konfigurasjonen den allerede hadde. Prosjektet\noppgir også at selve binærfilen kan oppgraderes uten at klientene blir avbrutt.\n\nPrisen betales i konfigurasjonsspråket, der reglene for prioritet og arv er kilden til\nde fleste overraskelsene. For en sti finner nginx først den lengste prefiks-location som\npasser, og husker den. Så prøver det location-blokkene med regulære uttrykk i den\nrekkefølgen de står i filen, og tar den første som passer. Det huskede prefikset brukes\nbare når alle de regulære uttrykkene bommer. En location merket `=` matcher stien eksakt\nog avslutter søket med en gang, og `^~` på det lengste prefikset ber nginx hoppe over de\nregulære uttrykkene. Noen direktiver, bl.a. add_header og proxy_set_header, arves fra\nnivået utenfor bare hvis det gjeldende nivået ikke definerer noen egne.\n\nSertifikater kom lenge fra en ACME-klient som kjørte ved siden av nginx. Prosjektet\ntilbyr nå også ngx_http_acme_module, som leveres separat fra kjernebygget.\n\n## Slik ser det ut i praksis\n\nTo hostingoppgaver fra grunnleggerens tidligere roller involverer nginx, og i begge delte det\nserverne med Apache i stedet for å erstatte det.\n\nDen første var\n[førti kundenettsteder som måtte være raske og alltid tilgjengelige](/nb/portfolio/administered-40-websites-on-apache-and-nginx/),\nsom kjørte på servere med Ubuntu Linux der både Apache og nginx var i bruk. Jobben var å\nskrive konfigurasjonen, justere dem for fart og holde dem ved like mens ekte besøkende\nbrukte dem, og alle førti holdt høy tilgjengelighet. To webservere i én flåte betyr at\nhver regel finnes på to dialekter: en virtuell vert i Apache er en server-blokk i nginx,\nog en løsning dere finner for den ene, må oversettes til den andre.\n\nDen andre gikk fra 2015 til 2022.\n[En ACME-arbeidsflyt overtok sertifikatene for hundre Docker-applikasjoner](/nb/portfolio/automated-ssl-tls-certs-for-100-docker-apps/),\nutstedte hvert av dem, fornyet det før det gikk ut og installerte det på vertene med\nUbuntu uten en person i løkken, og også der var både Apache og nginx i bruk. På\nnginx-siden er en fornyet fil på disken bare halve endringen. Et sertifikat oppgitt med\nen vanlig sti leses når nginx laster konfigurasjonen, og dokumentasjonen påpeker at bare\net filnavn bygd av variabler får nginx til å laste sertifikatet på nytt ved hvert\nTLS-håndtrykk. En fornyelse som skriver nye filer, når derfor de besøkende først etter\nen omlasting, og enhver automatisk fornyelse for nginx må avslutte med en.\n\n## Hvor det går galt\n\n**En header satt for hele nettstedet forsvinner på én sti.** En location som har så mye\nsom én add_header selv, arver ingen fra server- eller http-nivået, så én cache-header\nlagt til i en enkelt location fjerner i det stille alle sikkerhetsheaderne over den.\nproxy_set_header følger samme regel. add_header gjelder dessuten bare for vellykkede\nsvar og omdirigeringer, som 200, 301 og 304, med mindre den får `always`, så feilsider\ngår ut uten. Hold felles headere i én fil som hentes inn med include på hvert nivå som\nsetter egne, eller sett `add_header_inherit merge;` fra 1.29.3, legg til `always` der\nfeilsvar trenger headerne, og sjekk hver sti med `curl -sI`.\n\n**Forespørsler til ett nettsted besvares av et annet.** nginx matcher adressen og\nnettverksporten først, og deretter Host-headeren mot server_name. Når navnet er ukjent\nfor alle server-blokkene på den nettverksporten, går forespørselen til standardserveren,\nsom er den første i listen med mindre en annen er merket default_server. En skrivefeil i\nserver_name for et nytt nettsted serverer dermed i det stille sidene til en gammel nabo.\nDefiner en eksplisitt standardserver som svarer ukjente navn med `return 444`, som\nlukker forbindelsen, så en tabbe viser seg som en feil og ikke som feil nettsted.\n\n**Opplastinger feiler med 413 Request Entity Too Large.** client_max_body_size er 1 MB\nsom standard, og nginx avviser en større forespørselskropp før applikasjonen får se den.\nHev grensen i den location-blokken som tar imot opplastinger, ikke for hele serveren, og\nhold den i takt med applikasjonens egen grense.\n\n**Backenden lager lenker til feil vert eller får feil sti.** Med mindre noe annet er\nsatt, sender nginx serveren bak proxyen en Host-header laget av adressen i proxy_pass,\nf.eks. `127.0.0.1:8080`, og applikasjonen lager da omdirigeringer og absolutte lenker\ntil den adressen. Sett `proxy_set_header Host $host;` i location-blokken som\nvideresender. Stiene endrer seg med formen på proxy_pass: skrevet med en URI, selv bare\n`/`, erstatter den delen av stien som matchet location, mens skrevet uten sender den\nstien videre uendret. Test derfor en nøstet sti etter hver endring.\n\n**Klientene får fortsatt den gamle konfigurasjonen eller det gamle sertifikatet.** En\nredigert fil, eller et sertifikat som ble fornyet i løpet av natten, har ingen virkning\npå en kjørende nginx før en omlasting, og en omlasting av en ødelagt konfigurasjon lar\nden gamle bli stående. Test før hver omlasting, les så feilloggen og sjekk hva klientene\nfaktisk får:\n\n```sh\nnginx -t \u0026\u0026 nginx -s reload\nopenssl s_client -connect example.com:443 \\\n  -servername example.com \u003c/dev/null |\n  openssl x509 -noout -enddate\n```\n\n## Les mer\n\n- [nginx documentation](https://nginx.org/en/docs/) — prosjektets oversikt over\n  veiledninger og direktivreferanser for hver modul.\n- [Beginner's Guide](https://nginx.org/en/docs/beginners_guide.html) — hovedprosess og\n  arbeidsprosesser, omlasting og hvordan konfigurasjonen er bygd opp.\n- [How nginx processes a request](https://nginx.org/en/docs/http/request_processing.html)\n  — hvordan en server-blokk velges ut fra adresse, nettverksport og Host-header.\n- [Module ngx_http_core_module](https://nginx.org/en/docs/http/ngx_http_core_module.html)\n  — rekkefølgen location-blokker matches i, server_name og client_max_body_size.\n- [Module ngx_http_proxy_module](https://nginx.org/en/docs/http/ngx_http_proxy_module.html)\n  — proxy_pass, standardheadere, tidsavbrudd og bufring av svar.\n- [Module ngx_http_headers_module](https://nginx.org/en/docs/http/ngx_http_headers_module.html)\n  — add_header, hvilke svarkoder den gjelder for, og arveregelen.\n\n\u003chttps://engineer.company/nb/glossary/nginx/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"nginx for dere som drifter webservere: hoved- og arbeidsprosesser, rekkefølgen location-blokker velges i, og fellene som gir feil nettsted.","formats":{"gemtext":"https://engineer.company/nb/glossary/nginx/index.gmi","gopher":"https://engineer.company/nb/glossary/nginx/gophermap","html":"https://engineer.company/nb/glossary/nginx/","json":"https://engineer.company/nb/glossary/nginx/index.json","markdown":"https://engineer.company/nb/glossary/nginx/index.md","pdf":"https://engineer.company/nb/glossary/nginx/index.pdf"},"kind":"page","language":"nb","title":"Hva er nginx?","url":"https://engineer.company/nb/glossary/nginx/","version":1}