Riferimento delle impostazioni del tunnel
In questa pagina 15 sezioni
- Apri le impostazioni di un tunnel
- Apri la pagina del tipo di tunnel
- Seleziona Impostazioni nella riga del tunnel
- Modifica un'impostazione
- Come vengono applicate le modifiche
- Quale tipo di tunnel ha quale impostazione
- Cosa fa ogni impostazione
- Dettagli del tunnel
- Nota del tunnel
- SslStream attivo?
- PROXY protocol?
- Connessione legacy?
- IP del server locale
- IP del tunnel
- Impostazioni nell'elenco dei tunnel
- Cambia il server
- Cambia l'AuthToken
- Web Application Firewall
- Le stesse impostazioni tramite l'API
- Risoluzione dei problemi
- Pagine correlate
Ogni tunnel ha un pannello delle impostazioni nella dashboard. Questa pagina mostra dove aprirlo, elenca ogni impostazione, indica quali tipi di tunnel la prevedono e rimanda alla pagina che la spiega nel dettaglio.
Apri le impostazioni di un tunnel #
-
Apri la pagina del tipo di tunnel #
Nel menu della dashboard apri I miei tunnel e scegli il tipo: I miei tunnel › HTTP, TCP - UDP, TLS, File server, Server proxy, Proxy a rotazione o Gateway MCP.
-
Seleziona Impostazioni nella riga del tunnel #
Trova il tunnel sotto I tuoi tunnel e seleziona Impostazioni nella colonna Azioni. Il pannello Impostazioni del tunnel si apre a lato della pagina.
-
Modifica un'impostazione #
Il pannello è composto da queste parti:
- Dettagli del tunnel: dettagli come l'indirizzo del tunnel, la data di creazione e il nome dell'AuthToken, più i valori che puoi modificare selezionandoli: il titolo su ogni tipo di tunnel e, sui tunnel HTTP, TCP - UDP e TLS, anche l'indirizzo locale e la porta locale.
- Le destinazioni di bilanciamento del carico del tunnel, sui tipi di tunnel che le supportano. Vedi Bilanciamento del carico.
- Mostra comando SSH, sui tipi di tunnel che si possono avviare con SSH semplice. Vedi SSH senza installazione.
- Impostazioni: una riga per ogni impostazione. Una riga ha un interruttore Sì / No oppure un pulsante (Gestisci, Cambia, Mostra o Cancella) che apre una finestra di dialogo. L'icona informativa accanto a un'etichetta spiega l'impostazione in una frase.
La maggior parte degli interruttori ti chiede una conferma prima di cambiare qualcosa, ad esempio Attivare Solo HTTPS? con i pulsanti Attiva e Annulla. Attivando Autenticazione Basic? o Riscrittura del percorso? si apre invece una finestra di dialogo, mentre attivando Porta riservata? su un tunnel in esecuzione la porta viene riservata senza chiedere nulla.
Come vengono applicate le modifiche #
Alcune impostazioni vengono applicate a un tunnel in esecuzione senza interromperlo. Altre fermano il tunnel e lo riavviano con il nuovo valore: ci vuole un attimo e le connessioni aperte vengono chiuse.
| Applicate senza riavvio | Riavviano un tunnel in esecuzione |
|---|---|
| Solo HTTPS?, Riscrittura del percorso?, HTTP/3 attivo?, Porta riservata?, Header, Timeout HTTP, Nota del tunnel, Restrizione IP, Data di scadenza, Porta in uscita, Limite di banda, Utilizzo di banda, l'interruttore WAF | Il titolo, l'indirizzo locale e la porta locale in Dettagli del tunnel, Autenticazione Basic?, SslStream attivo?, PROXY protocol?, Connessione legacy?, Porta del server, Argomenti, IP del server locale, Limiti di velocità, il cambio del server, il cambio dell'AuthToken |
Un'impostazione che riavvia il tunnel può essere salvata su un tunnel in esecuzione solo mentre l'app Localtonet del suo dispositivo è connessa. Altrimenti la dashboard risponde "Controlla la connessione del dispositivo." e mantiene il valore precedente. Su un tunnel fermo il valore viene salvato e usato al prossimo avvio.
Quale tipo di tunnel ha quale impostazione #
Le etichette sono quelle mostrate nella sezione Impostazioni. "Sì" significa che il tipo di tunnel ha la riga.
| Impostazione | HTTP | TCP - UDP | TLS | File server | Server proxy | Proxy a rotazione | Gateway MCP |
|---|---|---|---|---|---|---|---|
| Solo HTTPS? | Sì | – | – | – | – | – | Sì |
| Riscrittura del percorso? | Sì | – | – | – | – | – | – |
| Autenticazione Basic? | Sì | – | – | Sì, tipo Default | – | – | Sì |
| SslStream attivo? | Sì | Sì, non per UDP | Sì | – | – | – | – |
| HTTP/3 attivo? | Sì | – | – | – | – | – | Sì |
| Porta riservata? | – | Sì | – | – | Sì | Sì | – |
| PROXY protocol? | – | Sì, non per UDP | – | – | – | – | – |
| Connessione legacy? | Sì | Sì | Sì | Sì | Sì | – | Sì |
| Modalità SSL | – | – | Sì | – | – | – | – |
| Provider SSO | Sì, non sui tunnel di team | – | – | – | – | – | – |
| Token del gateway | – | – | – | – | – | – | Sì |
| Header | Sì | – | – | – | – | – | – |
| Timeout HTTP | Sì | – | – | – | – | – | Sì |
| Porta del server | – | Sì | – | – | Sì, non per VLESS | Sì | – |
| Nota del tunnel | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| IP del server locale | Solo server locale | Solo server locale | Solo server locale | – | Solo server locale | – | Solo server locale |
| Argomenti | Sì | Sì | Sì | – | Sì | – | – |
| Restrizione IP | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Data di scadenza | Sì | Sì | Sì | Sì | Sì | – | Sì |
| Limiti di velocità | Sì | Sì | Sì | Sì | Sì | – | Sì |
| Porta in uscita | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Limite di banda | Sì | Sì | Sì | Sì | Sì | – | Sì |
| Traffico di banda | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Utilizzo di banda | Sì | Sì | Sì | Sì | Sì | – | Sì |
| IP del tunnel | – | Sì | Sì | – | Sì | Sì | – |
| Registro richieste | Sì | Sì | Sì | Sì | Sì | – | Sì |
| Registro attività | Sì | Sì | Sì | Sì | Sì | Sì | Sì |
| Salute del tunnel | Sì | Sì | Sì | – | Sì | Sì | Sì |
Le pagine Server proxy e Proxy a rotazione hanno altre righe proprie, come Autenticazione proxy, Controllo accessi, Impostazione upstream, Accesso VPN, Speed test, Token del tunnel e Connetti solo con Ipv4?. Sono descritte in Server proxy e Proxy a rotazione. Un tunnel che usa il server Locale non ha la riga Porta in uscita. "Solo server locale" vale anche per un tunnel la cui colonna Server mostra VPN.
Cosa fa ogni impostazione #
| Impostazione | Cosa fa | Dettagli |
|---|---|---|
| Solo HTTPS? | Serve l'URL pubblico solo tramite HTTPS. | Header e riscritture |
| Riscrittura del percorso? | Aggiunge un percorso davanti a ogni richiesta prima che raggiunga il tuo servizio locale. | Header e riscritture |
| Autenticazione Basic? | Chiede ai visitatori un nome utente e una password. | Controllo degli accessi |
| SslStream attivo? | Indica al tunnel che il tuo servizio locale usa a sua volta HTTPS o TLS. | Questa pagina |
| HTTP/3 attivo? | Permette ai client di raggiungere l'URL pubblico tramite HTTP/3. | Header e riscritture |
| Porta riservata? | Mantiene la stessa porta del server quando il tunnel si riavvia. | Porte |
| PROXY protocol? | Passa al tuo servizio l'indirizzo originale del client in un header PROXY protocol. | Questa pagina |
| Connessione legacy? | Un metodo di connessione alternativo da provare quando il tunnel non riesce a connettersi con quello normale. | Questa pagina |
| Modalità SSL | Sceglie se Localtonet gestisce l'HTTPS per un tunnel TLS o se inoltra al tuo servizio il traffico cifrato così com'è. | TLS |
| Provider SSO | Obbliga i visitatori ad accedere con uno dei tuoi provider di identità prima di poter aprire il tunnel. | Single Sign-On |
| Token del gateway | Mostra il token che i tuoi client MCP inviano per connettersi al gateway. | Gateway MCP |
| Header | Aggiunge header fissi di richiesta e di risposta. | Header e riscritture |
| Timeout HTTP | Imposta per quanto tempo il tunnel attende la risposta del tuo servizio a una richiesta. | Header e riscritture |
| Porta del server | Cambia la porta a cui le persone si connettono sul server Localtonet. | Porte |
| Nota del tunnel | Un promemoria privato di a cosa serve il tunnel. | Questa pagina |
| IP del server locale | Gli indirizzi su cui è raggiungibile il tuo server locale. | Questa pagina |
| Argomenti | Fa passare il tunnel da una rete specifica del dispositivo. | Selezione della rete |
| Restrizione IP | Sceglie quali indirizzi IP possono connettersi al tunnel. | Controllo degli accessi |
| Data di scadenza | Ferma il tunnel a una data stabilita. | Limiti e scadenza |
| Limiti di velocità | Limita la velocità di upload e di download. | Limiti e scadenza |
| Porta in uscita | Mantiene fisse le porte verso cui l'app Localtonet si connette in uscita, per i firewall più restrittivi. | Porte |
| Limite di banda | Ferma il tunnel dopo che ha trasferito una quantità di dati stabilita. | Limiti e scadenza |
| Traffico di banda | Mostra in un grafico i dati passati attraverso il tunnel. | Limiti e scadenza |
| Utilizzo di banda | Azzera il contatore dei dati del tunnel. | Limiti e scadenza |
| IP del tunnel | Mostra gli indirizzi IP del server su cui è in esecuzione il tunnel. | Questa pagina |
| Registro richieste | Mostra le richieste o le connessioni registrate per il tunnel. | Log e ispezione |
| Registro attività | Elenca avvii, arresti e modifiche alle impostazioni. | Log e ispezione |
| Salute del tunnel | Mostra i risultati dei controlli di salute periodici. | Log e ispezione |
Dettagli del tunnel #
Seleziona un valore in Dettagli del tunnel per modificarlo. Salvare uno qualsiasi dei tre riavvia un tunnel in esecuzione. L'indirizzo locale e la porta locale si possono modificare qui sui tunnel HTTP, TCP - UDP e TLS; gli altri tipi di tunnel mostrano solo il titolo.
| Finestra di dialogo | Cosa inserire | Regole |
|---|---|---|
| Rinomina tunnel | Un nome che riconosci nell'elenco dei tuoi tunnel, ad esempio "NAS ufficio". | Obbligatorio. Fino a 30 caratteri: la finestra ne conta fino a 100, ma un titolo più lungo di 30 viene rifiutato con "Il titolo non può superare i 30 caratteri." |
| Indirizzo locale | Dove l'app Localtonet trova il tuo servizio. Usa 127.0.0.1 quando il servizio gira sullo stesso dispositivo dell'app. Per raggiungere un altro dispositivo della tua rete, inserisci il suo indirizzo, ad esempio 192.168.1.20. | Un indirizzo IPv4, un indirizzo IPv6 o un nome host. Niente http://, niente percorso, niente porta. |
| Porta locale | La porta su cui il tuo servizio è in ascolto, sul dispositivo che lo esegue. | Un numero da 1 a 65535. |
Nota del tunnel #
Nota del tunnel › Gestisci apre la finestra Nota. Una nota è un promemoria di a cosa serve il tunnel e la vede solo il tuo account.
- Una nota può contenere fino a 499 caratteri. La finestra li conta mentre scrivi.
- Le scelte sotto Etichetta mettono un'etichetta davanti alla nota: Produzione, Staging, Test, Demo o Temporaneo. La nota inizia allora con, ad esempio,
Staging -. Scegliere un'altra etichetta sostituisce quella presente.
SslStream attivo? #
Attiva SslStream attivo? quando il tuo servizio locale usa a sua volta HTTPS o TLS, ad esempio un server di sviluppo che ascolta solo su https://localhost. Lascialo disattivato per un servizio che parla HTTP semplice o TCP semplice. I tunnel HTTP, TCP e TLS hanno l'interruttore; un tunnel UDP no.
PROXY protocol? #
Con PROXY protocol? attivo, il tunnel passa al tuo servizio l'indirizzo originale del client in un header PROXY protocol. Attivalo solo quando il tuo servizio è configurato per leggere quell'header, perché un servizio che non se lo aspetta vede byte sconosciuti all'inizio di ogni connessione. I tunnel TCP hanno l'interruttore; un tunnel UDP no.
Connessione legacy? #
Connessione legacy? porta il tunnel su un metodo di connessione alternativo. Provalo se il tunnel non riesce a connettersi con il metodo normale e disattivalo di nuovo se non serve.
IP del server locale #
Questa riga compare solo sui tunnel la cui colonna Server mostra Locale o VPN. La finestra IP del server locale contiene gli indirizzi su cui è raggiungibile il tuo server locale: un Indirizzo IPv4 e, facoltativamente, un Indirizzo IPv6. Lascia vuoto l'IPv6 se non lo usi. È richiesto almeno un indirizzo. Un indirizzo che funziona solo sul dispositivo stesso, come 127.0.0.1, 0.0.0.0 o ::1, viene rifiutato con "L'IP del server locale deve essere raggiungibile dall'esterno."
IP del tunnel #
IP del tunnel › Mostra apre la finestra IP del server con l'indirizzo IPv4 e, se il server ne ha uno, l'indirizzo IPv6 del server su cui è in esecuzione il tunnel. I client possono connettersi al tunnel con questo indirizzo al posto del nome di dominio.
Gli indirizzi IP del server possono cambiare. Quando puoi, usa il nome di dominio in app e script.
Impostazioni nell'elenco dei tunnel #
Due impostazioni si modificano dall'elenco dei tunnel, non dal pannello.
Cambia il server #
Seleziona il codice del server nella colonna Server, scegli un altro server nella finestra Cambia server e seleziona Invia. Un tunnel in esecuzione viene riavviato sul nuovo server.
- Cambiare il server richiede del saldo (Balance). Senza, la dashboard risponde "Devi acquistare del saldo per usare questa funzione."
- Se la porta del server del tunnel è già occupata sul nuovo server, ricevi "La porta del tuo tunnel (PORT) non è disponibile sul server selezionato. Cambia prima la porta." Cambia la porta come descritto in Porte, poi riprova.
- I tunnel la cui colonna Server mostra Locale o VPN non si possono spostare.
Quando cambi server, gli aggiornamenti DNS possono richiedere fino a 3 ore.
Cambia l'AuthToken #
Seleziona il nome del token nella colonna AuthToken per aprire Cambia AuthToken, scegli un altro AuthToken e seleziona Invia. Il tunnel passa al dispositivo che esegue l'app Localtonet con quel token.
- Un tunnel in esecuzione si ferma, attende 2 secondi, poi riparte con l'AuthToken selezionato. Un tunnel fermo resta fermo.
- Se l'app con il nuovo token non è connessa, il token viene comunque cambiato e ricevi "L'AuthToken è stato aggiornato, ma non è stato possibile riavviare il tunnel. Connetti l'app Localtonet con il token selezionato e avvia il tunnel."
- I tunnel Proxy a rotazione usano gruppi di AuthToken. Cambia invece i gruppi.
Gli AuthToken sono spiegati in AuthToken.
Web Application Firewall #
I tunnel HTTP e Gateway MCP hanno anche un pulsante a forma di scudo nella colonna Azioni. Apre il firewall del tunnel. Vedi Web Application Firewall.
Le stesse impostazioni tramite l'API #
La maggior parte delle impostazioni si può anche leggere e modificare con l'API, sotto il percorso del tunnel. L'autenticazione e il riferimento completo sono in API.
| Impostazione | Percorso dopo /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| Restrizione IP | ip-restrictions |
| Header | headers, host-header |
| Autenticazione Basic | authentication |
| Data di scadenza | expiration |
| Porta del server | server-port |
| Timeout HTTP | http-timeout |
| Limiti di velocità | rate-limit |
| Limite e utilizzo di banda | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Argomenti | arguments |
| Solo HTTPS?, HTTP/3 attivo?, Riscrittura del percorso? | https-only, http3, path-rewrite |
| SslStream attivo?, PROXY protocol?, Modalità SSL | ssl-stream, proxy-protocol, pass-through |
| Nota del tunnel | note |
| Server | server |
Risoluzione dei problemi #
"Controlla la connessione del dispositivo."
L'impostazione riavvia il tunnel e l'app Localtonet del dispositivo del tunnel non è connessa. Avvia l'app sul dispositivo, attendi che la colonna Connessione mostri ON, poi salva di nuovo. Puoi anche fermare prima il tunnel: su un tunnel fermo il valore viene salvato senza riavvio.
"Devi acquistare del saldo per usare questa funzione."
L'impostazione richiede del saldo (Balance) sull'account. Vale per le porte riservate, una porta del server personalizzata, le porte in uscita fisse, le restrizioni IP e il cambio del server. Vedi Piani e saldo.
"Non hai l'autorizzazione per aggiornare questo tunnel."
Lavori in un team e il tuo ruolo non include la modifica dei tunnel. Chiedi al proprietario del team di darti questo permesso. Vedi Gestione team.
Nel mio pannello manca una riga della tabella
Il pannello mostra solo le righe del tipo del tunnel, e alcune righe dipendono dal tunnel stesso: IP del server locale richiede il server Locale o VPN, Provider SSO non è mostrato sui tunnel di team, e un tunnel UDP non ha SslStream attivo? e PROXY protocol?.