Vai al contenuto
Localtonet Localtonet Dashboard

Crea un tunnel HTTP

Aiuto su questa pagina
In questa pagina 10 sezioni
  1. Prima di iniziare
  2. Passaggi
  3. Apri la pagina HTTP
  4. Scegli il tipo di URL
  5. Scegli il dispositivo e la regione
  6. Inserisci l'indirizzo locale
  7. Avvia il tunnel
  8. Il tuo indirizzo pubblico
  9. HTTPS e certificati
  10. L'header Host
  11. Impostazioni di un tunnel HTTP
  12. Esempi
  13. Condividere un'app web
  14. Ricevere webhook
  15. La pagina di avviso con il piano Gratuito
  16. Risoluzione dei problemi
  17. Pagine correlate

Un tunnel HTTP assegna a un'app web, a un'API o a un ricevitore di webhook sul tuo dispositivo un indirizzo HTTPS pubblico. Localtonet fornisce il certificato, quindi il tuo servizio locale può restare su semplice HTTP.

Prima di iniziare #

  • Il client Localtonet è installato sul dispositivo e connesso con un AuthToken. Se non lo è, segui la Guida rapida.
  • Il tuo servizio web è in esecuzione e ne conosci la porta, ad esempio 3000.
  • Per Sottodominio personalizzato o Dominio personalizzato: Saldo sul tuo account. Per Dominio personalizzato serve anche un dominio che hai aggiunto in Gestore DNS. Vedi Domini personalizzati.

Passaggi #

  1. Apri la pagina HTTP #

    Apri I miei tunnel › HTTP e seleziona Crea tunnel HTTP per aprire il modulo.

  2. Scegli il tipo di URL #

    Tipo di URLIndirizzo che ottieniRequisiti
    Sottodominio casualeUn nome generato sul dominio selezionato, ad esempio https://<RANDOM_NAME>.localto.net.Nessun requisito aggiuntivo
    Sottodominio personalizzatoIl nome che digiti in Sottodominio, ad esempio https://myapp.localto.net. Sono consentiti lettere, cifre e trattini.Saldo
    Dominio personalizzatoUn dominio tuo, selezionato in Dominio.Saldo e un dominio nel Gestore DNS
  3. Scegli il dispositivo e la regione #

    In Token del dispositivo seleziona il token usato dall'app Localtonet sul tuo dispositivo. In Regione del server scegli una regione vicina al tuo dispositivo per una latenza più bassa.

  4. Inserisci l'indirizzo locale #

    CampoCosa inserire
    Dominiolocalto.net oppure uno dei tuoi domini. Per Dominio personalizzato l'elenco contiene solo i tuoi domini.
    SottodominioSolo per Sottodominio personalizzato: il nome davanti al dominio.
    Indirizzo IP localeIndirizzo del servizio sul tuo dispositivo. Usa 127.0.0.1 per questo dispositivo. Il modulo accetta un indirizzo IPv4 o IPv6 oppure localhost.
    Porta localeLa porta su cui è in ascolto il tuo servizio locale, da 1 a 65535.

    Seleziona Crea tunnel. Il tunnel compare sotto I tuoi tunnel come Tunnel # seguito dal suo ID.

  5. Avvia il tunnel #

    Seleziona il pulsante di avvio nella colonna Azioni. Quando il tunnel è in esecuzione, il suo indirizzo nella colonna URL diventa un link. Aprilo in un browser. Le richieste a quell'indirizzo ora raggiungono il servizio sul tuo dispositivo.

    Se l'app Localtonet di quel token è offline, una finestra di dialogo te lo segnala. Avvia l'app, oppure seleziona Avvia comunque e il tunnel va online quando l'app si connette.

Il tuo indirizzo pubblico #

  • L'indirizzo è https:// seguito dal nome host nella colonna URL.
  • Un tunnel HTTP mantiene il suo sottodominio finché non lo elimini. Fermarlo e riavviarlo non lo cambia.
  • L'indirizzo non ha un numero di porta. I visitatori lo aprono come qualsiasi altro sito web.
  • Le connessioni WebSocket passano attraverso un tunnel HTTP.

HTTPS e certificati #

I visitatori raggiungono un tunnel HTTP tramite HTTPS con un certificato che Localtonet fornisce e rinnova. Il TLS termina sul server Localtonet. Da lì la richiesta viaggia attraverso il tunnel fino al tuo dispositivo e l'app Localtonet la passa al tuo servizio.

ImpostazioneCosa faQuando usarla
Solo HTTPS?Serve l'URL pubblico solo tramite HTTPS. Una richiesta a http:// viene reindirizzata allo stesso indirizzo su https://. Quando è disattivata, l'indirizzo risponde su entrambi.Attivala per tutto ciò che gestisce accessi o dati privati.
HTTP/3 attivo?Permette ai client di raggiungere l'URL pubblico tramite HTTP/3. Un nuovo tunnel ce l'ha attivato.Disattivala solo se un client ha problemi con HTTP/3.
SslStream attivo?Indica all'app Localtonet di connettersi al tuo servizio locale con TLS. L'app accetta il certificato del servizio locale così com'è, quindi funziona anche un certificato autofirmato.Attivala quando il tuo servizio locale usa a sua volta HTTPS, ad esempio un server di sviluppo su https://localhost:5001.
Connessione legacy?Collega il tunnel con il metodo legacy invece di quello normale.Prova questa opzione se il tunnel non riesce a connettersi con il metodo normale.

Trovi questi interruttori sotto Impostazioni nel pannello Impostazioni del tunnel. Modificare SslStream attivo? o Connessione legacy? su un tunnel in esecuzione lo riavvia, quindi l'app Localtonet deve essere connessa.

Ti serve la cifratura fino al tuo servizio? Con un tunnel HTTP, Localtonet decifra il traffico sul proprio server. Usa un tunnel TLS quando il tuo servizio deve presentare un proprio certificato.

L'header Host #

Il tuo servizio riceve il nome host usato dal visitatore, cioè l'indirizzo del tunnel. Alcuni server web locali scelgono il sito in base al nome host e rispondono con il sito sbagliato o con un errore. In tal caso apri Header nelle impostazioni del tunnel e aggiungi un header di richiesta chiamato Host con il nome che il tuo server si aspetta. Il tuo servizio riceverà allora questo nome host al posto dell'indirizzo del tunnel. Vedi Header e riscritture e Host virtuali.

Impostazioni di un tunnel HTTP #

Seleziona il pulsante delle impostazioni nella colonna Azioni per aprire il pannello Impostazioni del tunnel. Sotto Dettagli del tunnel puoi rinominare il tunnel e modificare l'indirizzo IP locale e la porta locale. La tabella elenca cos'altro offre un tunnel HTTP e dove è spiegato.

ImpostazioneCosa faApprofondisci
Bilanciamento del caricoDistribuisci il traffico tra più dispositivi o usa una destinazione di riserva.Bilanciamento del carico
Mostra comando SSHAvvia questo tunnel con il semplice SSH, senza installare l'app Localtonet.SSH senza installazione
Solo HTTPS?, HTTP/3 attivo?, SslStream attivo?, Connessione legacy?Come si connettono i visitatori e il tuo servizio.Questa pagina, sopra
Riscrittura del percorso?Modifica il percorso della richiesta prima che raggiunga il tuo servizio locale.Header e riscritture
HeaderGestisci gli header HTTP personalizzati di richiesta e risposta per questo tunnel.Header e riscritture
Timeout HTTPImposta quanto a lungo il server attende una risposta dalla tua applicazione locale, da 1 a 600 secondi.Header e riscritture
Autenticazione Basic?Chiedi ai visitatori un nome utente e una password.Controllo degli accessi
Restrizione IPControlla quali indirizzi IP dei client possono accedere a questo tunnel.Controllo degli accessi
Provider SSOI visitatori accedono con uno dei tuoi provider di identità prima di poter aprire il tunnel. Il pulsante SSO in cima alla pagina gestisce i provider.Single Sign-On
Pulsante WAF nella colonna AzioniApre Impostazione WAF. Il pulsante mostra se il Web Application Firewall non è configurato, attivo o inattivo.Web Application Firewall
Data di scadenza, Limiti di velocità, Limite di banda, Utilizzo di banda, Traffico di bandaFerma il tunnel a una certa data, limita la sua velocità, limita i suoi dati, azzera il contatore dei dati e consulta il traffico nel tempo.Limiti e scadenza
Registro richieste, Registro attività, Salute del tunnelIspeziona le richieste, rivedi avvii, arresti e modifiche alle impostazioni e consulta i controlli di integrità.Log e ispezione
ArgomentiInstrada questo tunnel attraverso una rete specifica del tuo dispositivo.Selezione della rete
Porta in uscitaUsa porte in uscita fisse per la connessione dell'app Localtonet al server, utile con firewall rigidi.Porte
Nota del tunnelSalva una nota privata che ti aiuta a riconoscere questo tunnel.Riferimento delle impostazioni

Provider SSO non viene mostrato per un tunnel che appartiene a un team.

Esempi #

Condividere un'app web #

La tua app è in esecuzione sullo stesso computer del client Localtonet e ascolta sulla porta 3000.

CampoValore
Tipo di URLSottodominio casuale
Dominiolocalto.net
Indirizzo IP locale127.0.0.1
Porta locale3000

Crea il tunnel, avvialo e invia l'indirizzo della colonna URL alle persone che devono vedere l'app. Per chiedere prima una password, attiva Autenticazione Basic?.

Se l'app è in esecuzione su un'altra macchina della tua rete, inserisci l'indirizzo di quella macchina in Indirizzo IP locale, ad esempio 192.168.1.20. Il dispositivo che esegue il client Localtonet deve poterla raggiungere.

Ricevere webhook #

Un provider di webhook ha bisogno di un indirizzo HTTPS pubblico a cui inviare gli eventi. Crea un tunnel HTTP verso la porta del tuo ricevitore, avvialo e inserisci presso il provider l'indirizzo del tunnel più il percorso del tuo endpoint:

URL del webhook
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Provalo da qualsiasi computer:

Terminale
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
  -H "Content-Type: application/json" \
  -d '{"event":"test"}'

Per vedere cosa è arrivato, seleziona l'icona nella colonna Webhook del tunnel (Visualizza i log di richieste e risposte). Prima il tunnel deve essere avviato. Vedi Log e ispezione.

Con il piano Gratuito, aggiungi Saldo prima di affidarti ai webhook. Le richieste a un tunnel HTTP di un account Gratuito ricevono prima una pagina di avviso, e un provider di webhook non può superarla con un clic. Vedi la sezione successiva.

La pagina di avviso con il piano Gratuito #

Quando un account non ha Saldo, un visitatore che arriva per la prima volta al suo tunnel HTTP vede una pagina Localtonet intitolata "You are about to navigate to:" con i pulsanti Cancel e Visit Site. La pagina serve a scoraggiare gli abusi. Visit Site salva un cookie nel browser del visitatore e apre il tuo sito. Finché il browser conserva quel cookie, la richiesta non viene ripetuta.

La pagina stessa indica i due modi per eliminarla:

  • Invia un header di richiesta chiamato localtonet-skip-warning con un valore qualsiasi. Va bene per i tuoi script e client API.
  • Aggiungi Saldo al tuo account. Vedi Piani e Saldo.
Terminale
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/

Risoluzione dei problemi #

La finestra dice che il token è offline, oppure ricevo "L'app Localtonet per l'AuthToken … non è connessa."

Il client Localtonet che usa il token di questo tunnel non è in esecuzione o non riesce a raggiungere Localtonet. Avvia il client sul dispositivo con lo stesso token. La finestra di dialogo avvia il tunnel da sola non appena l'app si connette. Con Avvia comunque il tunnel viene attivato e va online più tardi.

"Avvia o aggiorna l'app Localtonet."

Non è stato possibile avviare il tunnel sul dispositivo. Verifica che il client sia in esecuzione e, se è vecchio, installa la versione attuale dalla pagina Download.

Il browser mostra "Tunnel Recently Started or Stopped"

La richiesta ha raggiunto Localtonet, ma il tunnel non sta accettando connessioni. Il tunnel è stato appena avviato o è fermo. Verifica che sia avviato e che la colonna Connessione mostri ON, poi ricarica la pagina.

Il browser mostra una pagina di errore di Localtonet che nomina il mio indirizzo locale

La pagina dice che il traffico è stato inoltrato all'agent Localtonet, ma l'agent non è riuscito a connettersi al servizio upstream all'IP e alla porta locali indicati. Il titolo è l'errore, ad esempio ConnectionRefused. Nessuno è in ascolto a quell'indirizzo. Avvia il tuo servizio, poi controlla l'indirizzo IP locale e la porta locale sotto Dettagli del tunnel. Puoi provare il servizio sul dispositivo stesso aprendo l'indirizzo locale in un browser.

"Devi acquistare del saldo per usare questa funzione."

Sottodominio personalizzato e Dominio personalizzato richiedono Saldo. Usa Sottodominio casuale, oppure aggiungi Saldo in Saldo.

"Ti serve un saldo totale di … per creare un altro tunnel di questo tipo."

Il tuo Saldo non copre un altro tunnel. Con il piano Gratuito puoi creare un solo tunnel in totale, indipendentemente dal tipo. Elimina il tunnel esistente prima di crearne un altro, oppure aggiungi Saldo.

"… esiste già." o "… non è consentito."

Un altro tunnel usa quel sottodominio, oppure il nome è riservato da Localtonet. Scegli un sottodominio diverso.

"ATTENZIONE! Non hai alcun dominio!"

Hai scelto Dominio personalizzato ma non hai ancora aggiunto un dominio. Aggiungilo prima in Gestore DNS. Se vedi "… è già usato da un altro tunnel.", quel dominio appartiene già a uno dei tuoi tunnel. Un dominio personalizzato può servire un solo tunnel.

"Aggiorna il limite di banda o azzera il consumo di banda." o "Aggiorna la data di scadenza."

Il tunnel ha raggiunto il proprio limite di banda o la data di scadenza e non può avviarsi. Modifica il limite o la data nelle impostazioni del tunnel, oppure azzera il contatore con Utilizzo di banda. Vedi Limiti e scadenza.

"Controlla la connessione del dispositivo."

Hai modificato un'impostazione che riavvia un tunnel in esecuzione mentre l'app Localtonet era offline. Connetti l'app e salva di nuovo l'impostazione, oppure ferma prima il tunnel.

La mia app risponde con il sito sbagliato, oppure genera link e reindirizzamenti http://

La tua app decide in base al nome host o allo schema che riceve. Sotto Header aggiungi un header di richiesta Host se l'app si aspetta un nome host fisso. Aggiungi un header di richiesta X-Forwarded-Proto con il valore https per indicare all'app che i visitatori usano HTTPS, così genera link e reindirizzamenti https://.

Supporto