Vai al contenuto
Localtonet Localtonet Dashboard

Raggiungere un virtual host tramite Localtonet

Aiuto su questa pagina
In questa pagina 10 sezioni
  1. Perché un virtual host richiede l'header Host corretto
  2. Prima di iniziare
  3. Crea il tunnel
  4. Apri la pagina HTTP
  5. Compila il modulo
  6. Avvia il tunnel
  7. Opzione 1: imposta l'header Host nel tunnel
  8. Opzione 2: aggiungi il nome del tunnel al virtual host
  9. Apache
  10. Nginx
  11. Opzione 3: usa un tuo dominio
  12. Più virtual host
  13. Mettilo in sicurezza
  14. Problemi comuni
  15. Pagine correlate

Metti online un sito di un server Apache o Nginx locale, comprese le configurazioni XAMPP, WampServer e MAMP con più siti: crea un tunnel HTTP e assicurati che il server web riceva un nome host che conosce.

Perché un virtual host richiede l'header Host corretto #

Con i virtual host basati sul nome, un unico server web risponde per più siti sulla stessa porta. Sceglie il sito in base all'header Host di ogni richiesta: una richiesta per mysite.test ottiene il sito la cui configurazione cita mysite.test.

Un tunnel HTTP passa al tuo server web l'header Host del visitatore senza modificarlo. Un visitatore che apre l'indirizzo del tunnel invia quindi il nome host del tunnel, ad esempio un nome che termina con .localto.net, e non mysite.test. Il tuo server web non conosce quel nome e risponde con il suo sito predefinito, che di solito è il primo nella configurazione, oppure la pagina iniziale di XAMPP o WampServer.

Ci sono tre modi per risolvere il problema. Scegline uno:

OpzioneCosa modifichiIdeale per
Imposta l'header Host nel tunnelUn header della richiesta nelle impostazioni del tunnel. Niente sul server web.Una rapida occhiata a un sito statico o semplice.
Aggiungi il nome del tunnel al virtual hostUna riga nella configurazione del server web.Applicazioni che costruiscono link e reindirizzamenti a partire dal nome host.
Usa un tuo dominioIl tunnel usa un dominio di tua proprietà e il virtual host prende il nome da esso.Un sito che deve mantenere un unico indirizzo.

Prima di iniziare #

  • Un account Localtonet e il client Localtonet connesso con il tuo AuthToken sul computer che esegue il server web. Vedi Avvio rapido.
  • Un virtual host che funziona in un browser su quel computer, ad esempio http://mysite.test.
  • La porta su cui il server web è in ascolto. XAMPP e WampServer usano 80. MAMP usa 8888 se non l'hai cambiata.

Crea il tunnel #

  1. Apri la pagina HTTP #

    Apri I miei tunnel › HTTP ed espandi Crea tunnel HTTP.

  2. Compila il modulo #

    CampoCosa inserire
    Tipo di URLSottodominio casuale per le opzioni 1 e 2. Per l'opzione 3, scegli Dominio personalizzato.
    Token del dispositivoIl token usato dal client Localtonet sul computer.
    Regione del serverScegli una regione vicina al tuo dispositivo per una latenza minore.
    Indirizzo IP locale127.0.0.1. Inserisci l'indirizzo, non il nome del virtual host: il nome viaggia nell'header Host.
    Porta localeLa porta del server web, ad esempio 80.

    Seleziona Crea tunnel.

  3. Avvia il tunnel #

    Il tunnel compare sotto I tuoi tunnel. Seleziona Avvia e prendi nota dell'indirizzo pubblico nella colonna URL. Se lo apri adesso, vedi il sito predefinito del server web. Il passaggio successivo risolve il problema.

Il modulo del tunnel è descritto per intero nella pagina HTTP / HTTPS.

Opzione 1: imposta l'header Host nel tunnel #

Il tunnel può sostituire l'header Host prima che una richiesta raggiunga il tuo server web. L'impostazione è un header della richiesta chiamato Host:

  1. Seleziona Impostazioni sulla riga del tunnel.
  2. Accanto a Header, seleziona Gestisci. Si apre la finestra Header HTTP su Header della richiesta.
  3. Seleziona Host sotto Suggerimenti, oppure seleziona Aggiungi un header della richiesta e digita Host come nome.
  4. Come valore, inserisci il nome del tuo virtual host, ad esempio mysite.test. Il suggerimento inserisce localhost; sostituiscilo. Inserisci solo il nome host, senza http:// e senza percorso.
  5. Seleziona Salva.

La dashboard descrive così l'header della richiesta Host: il tuo servizio riceve questo nome host invece dell'indirizzo del tunnel, utile quando un server web locale sceglie il sito in base al nome host. Senza un header della richiesta Host, il tuo servizio riceve il nome host usato dal visitatore.

Apri di nuovo l'indirizzo del tunnel. Il server web ora riceve Host: mysite.test e risponde con quel sito. Per tornare indietro, rimuovi l'header e salva.

Anche l'applicazione vede il nome locale. Il software che costruisce link e reindirizzamenti a partire dall'header Host, o da un indirizzo del sito configurato, ora manda i visitatori a mysite.test, che esiste solo sul tuo computer. Se le pagine si caricano senza stili o un login reindirizza al nome locale, usa l'opzione 2 o 3.

L'API ha la stessa impostazione dell'override dell'header Host di un tunnel HTTP. Vedi API. Gli altri header di richiesta e di risposta sono trattati in Header e riscritture.

Opzione 2: aggiungi il nome del tunnel al virtual host #

Indica al server web che il nome host del tunnel appartiene al tuo sito. Copia il nome host dall'URL del tunnel, senza https://, e aggiungilo come alias. Lascia vuoti gli Header del tunnel.

Apache #

In XAMPP i virtual host si trovano in apache\conf\extra\httpd-vhosts.conf. Aggiungi una riga ServerAlias:

httpd-vhosts.conf
<VirtualHost *:80>
    ServerName mysite.test
    ServerAlias <TUNNEL_HOST>
    DocumentRoot "C:/xampp/htdocs/mysite"
</VirtualHost>

Riavvia Apache.

Nginx #

Aggiungi il nome host del tunnel a server_name:

mysite.conf
server {
    listen 80;
    server_name mysite.test <TUNNEL_HOST>;
    root /var/www/mysite;
    index index.html index.php;
}

Controlla la configurazione e ricarica Nginx:

Terminale
sudo nginx -t && sudo nginx -s reload

Un tunnel HTTP mantiene il suo sottodominio finché non elimini il tunnel, quindi l'alias resta valido dopo i riavvii.

Opzione 3: usa un tuo dominio #

Quando il tunnel funziona su un dominio di tua proprietà, i visitatori inviano quel dominio nell'header Host e tu dai al virtual host il nome di quel dominio. Non servono né l'override dell'header né l'alias, e i link che l'applicazione costruisce sono corretti.

  1. Aggiungi il dominio al tuo account e crea il tunnel HTTP con Tipo di URL impostato su Dominio personalizzato. I passaggi sono nella pagina Domini personalizzati. I domini personalizzati richiedono Saldo.
  2. Imposta ServerName (Apache) o server_name (Nginx) del virtual host su quel dominio, come negli esempi sopra.

Sottodominio personalizzato funziona allo stesso modo, con un nome a tua scelta invece di uno casuale. Richiede anch'esso Saldo.

Più virtual host #

Un tunnel HTTP ha un solo indirizzo pubblico e raggiunge un solo sito. Per ogni virtual host aggiuntivo, crea un altro tunnel HTTP verso lo stesso Indirizzo IP locale e la stessa Porta locale e applica a esso una delle opzioni. Il Piano Gratuito consente un solo tunnel in totale. Vedi Piani e Saldo.

Mettilo in sicurezza #

Un sito di sviluppo spesso non è pronto per gli estranei. Un tunnel HTTP può chiedere ai visitatori di identificarsi prima che una richiesta raggiunga il tuo server web:

  • Autenticazione Basic? nelle Impostazioni del tunnel chiede ai visitatori un nome utente e una password.
  • Restrizione IP › Gestisci permette di connettersi solo agli indirizzi che elenchi. Richiede Saldo.
  • Provider SSO obbliga i visitatori ad accedere prima con un identity provider. Richiede Saldo.

Tutte e tre sono descritte in Controllo degli accessi. Per una demo, Data di scadenza ferma il tunnel a una data che imposti. Vedi Limiti e scadenza.

Problemi comuni #

Vedo la pagina iniziale di XAMPP o WampServer, oppure il sito sbagliato

Il server web non ha riconosciuto il nome host e ha servito il suo sito predefinito. Applica una delle tre opzioni. Con l'opzione 1, verifica che il nome dell'header sia Host e che il suo valore corrisponda a ServerName o server_name del sito. Con l'opzione 2, controlla che l'alias non contenga errori di battitura e riavvia il server web.

La pagina si carica senza stili, oppure i link portano a mysite.test

L'applicazione costruisce i propri indirizzi a partire dal nome locale. Usa l'opzione 2 o 3 in modo che l'applicazione veda il nome pubblico. Le applicazioni con un indirizzo del sito memorizzato richiedono di cambiare anche quell'indirizzo: per WordPress, aggiorna l'URL del sito con l'indirizzo del tunnel oppure usa un dominio personalizzato.

Il sito reindirizza a http:// e il browser mostra un avviso o un ciclo

I visitatori usano HTTPS sull'indirizzo del tunnel, mentre il tunnel comunica in HTTP semplice con il tuo server web. Un'applicazione che forza HTTPS da sola potrebbe non accorgersi che il visitatore è già su HTTPS. In Header, l'header della richiesta X-Forwarded-Proto dei Suggerimenti, con il valore https, indica a tale applicazione che i visitatori usano HTTPS.

I visitatori vedono prima una pagina di avviso di Localtonet

Sugli account senza Saldo, Localtonet mostra questa pagina una sola volta a ogni visitatore di un tunnel HTTP. Le richieste che contengono un header localtonet-skip-warning con un valore qualsiasi la saltano, e lo stesso vale per i tunnel su account con Saldo.

Il mio server web è in ascolto solo su HTTPS

Imposta la Porta locale del tunnel sulla porta HTTPS, di solito 443, e attiva SslStream attivo? nelle Impostazioni del tunnel. Questo interruttore è per i servizi locali che usano a loro volta HTTPS o TLS.

"Devi acquistare del saldo per usare questa funzione."

Sottodominio personalizzato, Dominio personalizzato, Restrizione IP e Provider SSO richiedono Saldo. Aggiungilo in Saldo.

Supporto