Installasjon av Nginx Proxy Manager - 2-minutters oppsettveiledning

Hva du trenger før du starter

Tre ting må eksistere før Nginx Proxy Manager (NPM) kan fungere. For det første, en Linux-server eller PC med Docker og Docker Compose allerede installert og fungerer - NPM kjører som en container, ikke som et normalt program. For det andre, et domenenavn hvis DNS du kan redigere, fordi hver tjeneste får sitt eget underdomene. For det tredje må ruteren eller skybrannmuren din kunne videresende portene 80 og 443 til denne maskinen.

Pek domene-DNS-en til serveren først

NPM ruter trafikk etter navn, og Lets Encrypt utsteder sertifikater kun for navn som beviselig peker på maskinen din - så navnet må løses før du bygger noe på det. Hos registraren eller DNS-verten din, legg til en A-post: Navnet er kun underdomeneordet (for eksempel app) og verdien er serverens offentlige IP-adresse. Hver tjeneste får sin egen rekord, og de kan alle peke på samme IP - NPM skiller tjenestene senere, etter navn. Still inn en kort TTL, for eksempel 300 sekunder, mens du tester, slik at feil forsvinner i løpet av minutter i stedet for timer.

Bevis det før du fortsetter: sjekk at navnet løses til din offentlige IP fra et eksternt nettverk (for eksempel fra telefonen din med Wi-Fi av). Å be om et sertifikat mot ødelagt DNS-avfall lar deg kryptere forsøk, og gjentatte feil kan begrense deg i timevis. Rekkefølgen er viktig: DNS først, proxy-vert nummer to, sertifikat tredje.

Opprett mappen og skrivfilen

Lag en mappe for NPM på serveren og lagre filen under i den som docker-compose.yml. Denne enkeltfilen er den komplette installasjonen. Bildenavnet er det offisielle fellesskapsbildet. Portene 80 og 443 er de offentlige dørene, port 81 er administrasjonspanelet, og de to volumene er der hele oppsettet ditt bor: ./data inneholder databasen med alle proxy-vertene dine, og ./letsencrypt har sertifikatene dine. Mister de to mappene og du mister hele oppsettet - sikkerhetskopier dem når ting kjører.

services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'
      - '443:443'
      - '81:81'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt

restart: unless-stopped-linjen bringer NPM tilbake automatisk etter en omstart.

Start Nginx Proxy Manager

Kjør startkommandoen fra den mappen. Docker laster ned bildet og starter beholderen i bakgrunnen.

docker compose up -d

Sjekk at den kjører:

docker ps

Du bør se beholderen oppført med portene 80, 443 og 81. På en liten server tar den første starten et minutt eller to mens databasen opprettes. Hvis beholderen fortsetter å starte på nytt, viser loggene årsaken på vanlig språk:

docker compose logs

Ni av ti ganger er en omstartsløkke en port som allerede brukes av noe annet på verten - vanligvis en gammel webserver som fortsatt kjører.

Første pålogging - Sikre administratorkontoen umiddelbart

Åpne administrasjonspanelet i en nettleser på ditt eget nettverk:

http://your-server-ip:81

Gjør dette i det første minuttet. Avhengig av bygget, ber NPM deg enten erstatte de velkjente administratoropplysningene for første pålogging med din egen e-post og et sterkt passord, eller - på nyere bygg uten standardkonto - oppretter den første personen som åpner admin-siden administratoren. Uansett er regelen den samme: Sett opp din egen adminkonto i det øyeblikket containeren starter, før du oppretter noe annet, og bruk en ekte postboks - NPM-e-poster som tar for seg sertifikatproblemer.

Opprett din første proxy-vert

I NPM åpner du Hosts → Proxy Hosts → Add Proxy Host og fyller ut skjemaet som én setning - "dette navnet går til den interne tjenesten":

Domenenavn: app.yourdomain.com – det eksakte offentlige navnet fra trinn 2, som allerede må løses til serveren din.
Skjema: http for de fleste hjemme- og kontorapper. Skjema beskriver sammenhengen mellom NPM og interntjenesten, ikke hva besøkende bruker - NPM håndterer den offentlige krypteringen ved døren. Velg https her bare når den interne appen selv tjener HTTPS.
Videresend vertsnavn / IP: den interne adressen til tjenesten, for eksempel 192.168.1.50.
Forward Port: porten tjenesten faktisk lytter på, for eksempel 8080 - ikke 80 eller 443; det er NPMs dører, ikke tjenestens.

Slå på Block Common Exploits, og deretter Lagre. Test umiddelbart ved å åpne navnet i en nettleser - ideelt sett fra telefonen din med Wi-Fi av, slik at du tester den virkelige offentlige banen.

Få Free Lets Encrypt HTTPS-sertifikatet

Gjør dette først etter at den vanlige verten fra trinn 6 allerede fungerer - HTTPS på en ødelagt vert gir deg en ødelagt vert med et sertifikat, og to ganger så mange steder å lete etter feilen. Åpne den samme proxy-verten, gå til SSL-fanen, sett SSL-sertifikat til Be om et nytt SSL-sertifikat, aktiver Force SSL og HTTP/2 Support, godta Lets Encrypt Servicevilkår og lagre. Last inn siden på nytt - nettleseren skal nå vise hengelåsen på https.

Slik fungerer det: Lets Encrypt beviser at du kontrollerer navnet ved å be serveren din, over det offentlige internett på port 80, om å vise et engangstoken (HTTP-01-utfordringen). Det er grunnen til at DNS som peker på deg og en tilgjengelig port 80 ikke er omsettelige - mislykkes enten en og forespørselen mislykkes, og feilen er i oppsettet, aldri i Lets Encrypt. Force SSL omdirigerer hver http-besøkende til https automatisk; uten den forblir den ukrypterte døren åpen ved siden av den krypterte.