Perché un reverse proxy funziona con il nome di dominio ma non con l’IP locale?

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Un proxy inverso funziona tramite dominio perché le sue regole di instradamento e TLS spesso dipendono dal nome host richiesto, non solo dall’IP di destinazione.

Quando un client domestico apre https://app.example.com, il DNS fornisce un IP, ma il browser invia comunque il dominio durante l’handshake TLS e nell’intestazione Host HTTP. Aprendo https://192.168.1.20 questi identificatori cambiano, quindi il proxy potrebbe selezionare un sito predefinito, rifiutare il certificato, non trovare la route dell’applicazione o reindirizzare all’URL pubblico configurato. Il test corretto mantiene il nome host previsto e modifica solo la destinazione di rete.

Confronta la richiesta con nome host con quella all’IP diretto

Invia una richiesta al dominio e una all’IP locale, quindi confronta il codice di stato, il certificato, le intestazioni della risposta, la destinazione del reindirizzamento e il log di accesso del proxy inverso. Non dare per scontato che le due richieste siano equivalenti solo perché raggiungono la stessa interfaccia Ethernet.

Una guida ai proxy inversi per homelab spiega che il proxy esamina l’intestazione Host HTTP per instradare diversi servizi tramite un unico IP e una sola porta.

Se la richiesta al dominio corrisponde a una route dell’applicazione mentre quella all’IP restituisce una pagina predefinita o un 404, il proxy funziona come configurato. Occorre quindi decidere se sia davvero necessario l’accesso diretto tramite IP o se il DNS locale debba mantenere il dominio.

Verifica l’IP locale mantenendo l’intestazione Host prevista

Usa uno strumento client che si connetta all’IP locale del proxy inviando il dominio dell’applicazione come intestazione Host. Per HTTPS, mantieni il dominio anche come nome del server TLS, anziché sostituirlo con l’IP.

Server Fault spiega come un proxy inverso HTTP possa usare l’intestazione Host per scegliere la route, proprio come i virtual host basati sul nome.

Se la richiesta con host forzato riesce, la route del proxy e il backend funzionano correttamente; il fallimento con IP diretto è dovuto a una mancata corrispondenza dell’identità. Se il problema persiste, controlla il listener, il firewall locale, l’entry point del proxy e la priorità delle route prima di modificare il DNS.

Verifica SNI TLS e corrispondenza del certificato

HTTPS introduce una scelta del nome host prima della richiesta HTTP. Di solito il client invia l’indicazione Server Name Indication durante l’handshake TLS, così il proxy può selezionare il certificato corretto e l’host virtuale sicuro.

Una nota sull’implementazione di un proxy inverso SNI spiega che i backend HTTPS vengono selezionati usando il nome host SNI del client prima che sia possibile esaminare le normali intestazioni HTTP.

L'accesso diretto tramite IP può mostrare un certificato predefinito o non superare la convalida del nome host, anche quando il proxy è raggiungibile. Usa il dominio con il DNS locale oppure installa un certificato gestito appositamente che includa l'IP solo se l'uso di HTTPS con accesso diretto tramite IP è una reale esigenza operativa.

Esamina il sito predefinito e la priorità delle route

Controlla quale host virtuale gestisce le richieste che non corrispondono a un dominio configurato. Un sito predefinito può mostrare una dashboard, reindirizzare a un altro nome host, chiudere la connessione o esporre un errore generico.

Una discussione su Caddy mostra che una richiesta può raggiungere l'IP corretto del proxy, mentre l'header Host e il nome TLS determinano comunque se viene scelto l'upstream previsto.

Mantieni esplicita e sicura la route predefinita. Non aggiungere un proxy catch-all generico diretto a un singolo backend solo per consentire l'accesso tramite IP: potrebbe instradare nomi host sconosciuti o traffico di scansione verso un'applicazione prevista solo per un dominio specifico.

Verifica se l'applicazione reindirizza al proprio URL canonico

Anche quando il proxy accetta la richiesta tramite IP, il backend potrebbe applicare un URL di base pubblico configurato e reindirizzare il browser al dominio. Anche i cookie di autenticazione, i callback OAuth, le origini WebSocket e i controlli CSRF possono dipendere dall'host canonico.

Confronta il log del proxy con quello dell'applicazione e controlla l'header Location. Un reindirizzamento al dominio non indica un errore di instradamento: dimostra che l'applicazione si aspetta un'unica identità pubblica.

Correggi gli header dell'host e del protocollo inoltrati quando l'app genera un URL esterno errato. Non sostituire il dominio canonico con un IP privato solo per aggirare il reindirizzamento, perché potresti compromettere i certificati e l'accesso remoto.

Usa il DNS locale quando il dominio è l'interfaccia prevista

Crea un record DNS interno che risolva il dominio dell'applicazione nell'indirizzo locale del proxy inverso. Il browser utilizzerà così il percorso LAN più efficiente, mantenendo invariati l'header Host, il nome SNI, il certificato, i cookie e l'URL dell'applicazione.

Il confronto di ZimaSpace tra proxy inversi e modalità di accesso privato aiuta a decidere se il dominio debba rimanere un punto di accesso locale e pubblico o restare dietro una rete privata.

Il problema è risolto quando il dominio funziona sia all'interno sia all'esterno grazie a risposte DNS intenzionali, mentre l'IP diretto raggiunge un sito predefinito documentato oppure viene rifiutato deliberatamente. Un proxy instradato tramite dominio non deve comportarsi come un server con un solo sito accessibile tramite indirizzo IP.

Assistenza e consigli

Altre letture

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.