Nginx Proxy Manager installeren - Installatiehandleiding van 2 minuten

Wat u nodig heeft voordat u begint

Er moeten drie dingen bestaan voordat Nginx Proxy Manager (NPM) kan werken. Ten eerste een Linux-server of pc waarop Docker en Docker Compose al zijn geïnstalleerd en werken - NPM draait als een container, niet als een normaal programma. Ten tweede een domeinnaam waarvan je de DNS kunt aanpassen, omdat elke dienst zijn eigen subdomein krijgt. Ten derde moet uw router of cloudfirewall poort 80 en 443 naar deze machine kunnen doorsturen.

Verwijs eerst uw domein-DNS naar de server

NPM routeert verkeer op naam, en Lets Encrypt geeft alleen certificaten uit voor namen die aantoonbaar naar uw machine verwijzen - dus de naam moet worden omgezet voordat u er iets op kunt bouwen. Voeg bij uw registrar of DNS-host een A-record toe: de Naam is alleen het subdomeinwoord (bijvoorbeeld app) en de Waarde is het openbare IP-adres van uw server. Elke service krijgt zijn eigen record en ze kunnen allemaal naar hetzelfde IP-adres verwijzen. NPM scheidt de services later op naam. Stel tijdens het testen een korte TTL in, bijvoorbeeld 300 seconden, zodat fouten binnen enkele minuten verdwijnen in plaats van uren.

Bewijs het voordat u verdergaat: controleer of de naam wordt omgezet naar uw openbare IP vanaf een extern netwerk (bijvoorbeeld vanaf uw telefoon terwijl Wi-Fi is uitgeschakeld). Een certificaat aanvragen tegen kapotte DNS-verspilling Lets Encrypt-pogingen en herhaalde mislukkingen kunnen u urenlang beperken. De volgorde is van belang: DNS eerst, proxyhost als tweede, certificaat als derde.

Maak de map en het bestand opstellen

Maak een map voor NPM op de server en sla het onderstaande bestand daarin op als docker-compose.yml. Dit enkele bestand is de volledige installatie. De afbeeldingsnaam is de officiële communityafbeelding. Poorten 80 en 443 zijn de openbare deuren, poort 81 is het beheerderspaneel en de twee volumes zijn waar uw hele installatie zich bevindt: ./data bevat de database met al uw proxyhosts, en ./letsencrypt bevat uw certificaten. Als u deze twee mappen kwijtraakt, raakt u de hele installatie kwijt. Maak er een back-up van zodra alles draait.

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

De regel restart: tenzij-stopped brengt NPM automatisch terug na een herstart.

Start Nginx Proxy Manager

Voer vanuit die map de startopdracht uit. Docker downloadt de afbeelding en start de container op de achtergrond.

docker compose up -d

Controleer of het werkt:

docker ps

U zou de container moeten zien staan met poorten 80, 443 en 81. Op een kleine server duurt de eerste start een minuut of twee terwijl de database is gemaakt. Als de container steeds opnieuw opstart, tonen de logboeken de reden in duidelijke taal:

docker compose logs

Negen van de tien keer is een herstartlus een poort die al door iets anders op de host wordt gebruikt - meestal een oude webserver die nog draait.

Eerste aanmelding - Beveilig het beheerdersaccount onmiddellijk

Open het beheerderspaneel in een browser op uw eigen netwerk:

http://your-server-ip:81

Doe dit in de eerste minuut. Afhankelijk van de build vraagt ​​NPM u om de bekende beheerdersgegevens voor de eerste aanmelding te vervangen door uw eigen e-mailadres en een sterk wachtwoord, of - bij nieuwere builds zonder standaardaccount - maakt de eerste persoon die de beheerderspagina opent de beheerder aan. Hoe dan ook, de regel is hetzelfde: stel uw eigen beheerdersaccount in op het moment dat de container start, voordat u iets anders aanmaakt, en gebruik een echte mailbox - NPM-e-mails die over certificaatproblemen gaan.

Maak uw eerste proxyhost

Open in NPM Hosts → Proxyhosts → Proxyhost toevoegen en vul het formulier als één zin in - "deze naam gaat naar die interne service":

Domeinnamen: app.uwdomein.com - de exacte openbare naam uit stap 2, die al moet worden omgezet naar uw server.
Schema: http voor de meeste thuis- en kantoorapps. Schema beschrijft de verbinding tussen NPM en de interne dienst, niet wat bezoekers gebruiken - NPM regelt de publieke encryptie aan de deur. Kies hier alleen https als de interne app zelf HTTPS bedient.
Hostnaam/IP doorsturen: het interne adres van de service, bijvoorbeeld 192.168.1.50.
Poort doorsturen: de poort waarop de service daadwerkelijk luistert, bijvoorbeeld 8080 - niet 80 of 443; dat zijn de deuren van NPM, niet die van de dienst.

Schakel Algemene exploits blokkeren in en vervolgens Opslaan. Test onmiddellijk door de naam in een browser te openen - idealiter vanaf uw telefoon met Wi-Fi uitgeschakeld, zodat u het echte openbare pad test.

Ontvang het gratis Lets Encrypt HTTPS-certificaat

Doe dit alleen nadat de gewone host uit stap 6 al werkt - HTTPS op een kapotte host geeft je een kapotte host met een certificaat en twee keer zoveel plaatsen om naar de fout te zoeken. Open dezelfde proxyhost, ga naar het tabblad SSL, stel SSL-certificaat in op Een nieuw SSL-certificaat aanvragen, schakel SSL forceren en HTTP/2-ondersteuning in, ga akkoord met de servicevoorwaarden van Lets Encrypt en sla op. Laad de site opnieuw - de browser zou nu het hangslot op https moeten tonen.

Hoe het werkt: Lets Encrypt bewijst dat u de naam beheert door uw server, via het openbare internet op poort 80, te vragen een eenmalig token weer te geven (de HTTP-01-uitdaging). Dat is de reden waarom DNS die naar jou verwijst en een bereikbare poort 80 niet onderhandelbaar is: als je één van beide niet onderhandelt, mislukt het verzoek, en de fout zit in de installatie, nooit in Lets Encrypt. SSL forceren stuurt elke http-bezoeker automatisch door naar https; zonder dit blijft de niet-gecodeerde deur open naast de gecodeerde deur.