Nginx Proxy Manager con Docker: come gestire domini, sottodomini e certificati SSL HTTPS in locale e da remoto

Quando iniziamo a ospitare più servizi in locale sul nostro server domestico o Mini PC — come Home Assistant, Open WebUI, Immich, Paperless-ngx o n8n — ci troviamo presto a dover ricordare decine di indirizzi IP e numeri di porta diversi (192.168.1.X:8123, :3000, :5678) e a fare i conti con connessioni non crittografate (HTTP).

La soluzione più elegante, sicura e semplice da gestire è Nginx Proxy Manager (NPM): un reverse proxy dotato di un’interfaccia web intuitiva che permette di associare nomi di dominio puliti ai propri container Docker e di generare automaticamente certificati SSL/HTTPS gratuiti tramite Let’s Encrypt.

Cos’è un Reverse Proxy e perché usare Nginx Proxy Manager

Un reverse proxy agisce come unico punto di ingresso per il traffico web diretto verso la tua rete domestica: riceve le richieste dall’esterno (sulle porte standard 80 e 443) e, in base al nome di dominio richiesto, le smista in sicurezza verso il giusto servizio interno senza dover aprire decine di porte diverse sul router.

Nginx Proxy Manager rende tutto questo accessibile senza dover modificare manualmente complessi file di configurazione:

  • Interfaccia grafica chiara: gestisci tutti gli host, i reindirizzamenti e gli accessi direttamente dal browser.
  • Certificati SSL Let’s Encrypt con un clic: genera e rinnova automaticamente i certificati HTTPS per eliminare gli avvisi di “connessione non sicura”.
  • Riduzione della superficie d’attacco: sul router di casa dovrai aprire (port forwarding) esclusivamente le porte 80 e 443 verso il server di Nginx Proxy Manager.
  • Access List (Controllo accessi): puoi proteggere i servizi che non hanno un sistema di login nativo aggiungendo una schermata di autenticazione con username e password o limitando l’accesso a specifici indirizzi IP.

Requisiti preliminari

  • Docker e Docker Compose installati sul tuo server o PC.
  • Un dominio o sottodominio (anche gratuito): puoi usare un dominio personale (es. tuodominio.it su Cloudflare, Aruba, Namecheap) oppure un servizio DDNS gratuito come DuckDNS.
  • Port Forwarding sul router: inoltro delle porte esterne 80 (HTTP) e 443 (HTTPS) verso l’indirizzo IP locale della macchina su cui gira Docker.

Passo 1: Installare Nginx Proxy Manager con Docker

Crea una cartella dedicata sul tuo sistema (ad esempio nginx-proxy-manager) e al suo interno un file chiamato docker-compose.yml con questa configurazione:

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

Apri il terminale nella cartella appena creata e avvia il container con:

docker compose up -d

Una volta avviato, apri il browser all’indirizzo http://localhost:81 (oppure http://192.168.1.X:81). Le credenziali predefinite per il primo accesso sono:

  • Email: admin@example.com
  • Password: changeme

Subito dopo il primo login, il sistema ti chiederà di impostare il tuo indirizzo email reale e una nuova password sicura.

Passo 2: Creare il primo Proxy Host con certificato SSL

Supponiamo di voler raggiungere Open WebUI (in esecuzione sulla porta locale 3000) tramite l’indirizzo ai.tuodominio.it (dopo aver fatto puntare il record DNS del sottodominio al tuo IP pubblico):

  1. Nella dashboard di Nginx Proxy Manager, vai su Hosts > Proxy Hosts e clicca su Add Proxy Host.
  2. Nella scheda Details compila i campi:
    • Domain Names: inserisci ai.tuodominio.it e premi Invio.
    • Scheme: lascia http (è il protocollo interno tra NPM e il container).
    • Forward Hostname / IP: inserisci l’indirizzo IP locale del tuo server (es. 192.168.1.100).
    • Forward Port: inserisci la porta interna del servizio (es. 3000).
    • Attiva le opzioni Block Common Exploits e Websockets Support (fondamentale per servizi moderni come Home Assistant, Open WebUI e Immich).
  3. Spostati nella scheda SSL:
    • Dal menu a tendina SSL Certificate, seleziona Request a new SSL Certificate.
    • Attiva Force SSL e HTTP/2 Support.
    • Inserisci il tuo indirizzo email, accetta i termini di servizio di Let’s Encrypt e clicca su Save.

In pochi secondi Nginx Proxy Manager verificherà il dominio, rilascerà il certificato HTTPS e renderà il tuo servizio raggiungibile in modo sicuro e crittografato da qualsiasi dispositivo.

Consigli di sicurezza per la rete domestica

  • Non esporre mai la porta 81 all’esterno: la porta amministrativa di Nginx Proxy Manager (81) deve restare accessibile solo dalla rete locale o tramite la tua VPN WireGuard.
  • Combina Reverse Proxy e VPN: esponi su internet tramite Nginx Proxy Manager solo i servizi che ti servono davvero in mobilità (come Home Assistant o Immich), mantenendo gli strumenti amministrativi raggiungibili esclusivamente tramite VPN.