Avvia un tunnel con il tuo client SSH
Piano Gratuito Tunnel HTTP e TCP
In questa pagina 11 sezioni
- Quando usarlo
- Prima di iniziare
- Passaggi
- Crea un tunnel HTTP o TCP
- Apri il comando SSH
- Scegli se deve riconnettersi
- Esegui il comando
- Tieni aperta la finestra
- Dalla procedura guidata di configurazione del tunnel
- Il comando spiegato
- Riconnessione automatica
- Per quanto tempo un comando resta valido
- Limiti
- Cosa vedi nella dashboard
- Risoluzione dei problemi
- Messaggi nella dashboard
- Messaggi nel terminale
- Pagine correlate
Metti online un servizio locale senza installare Localtonet. La dashboard ti fornisce un comando ssh già pronto; finché quel comando è in esecuzione, il tuo tunnel HTTP o TCP è attivo.
Quando usarlo #
Usa SSH senza installazione su una macchina in cui non puoi o non vuoi installare il client Localtonet, per esempio un server che ti serve solo per un momento, un computer aziendale con restrizioni o una demo veloce. Ti basta il client ssh incluso in Windows, macOS e Linux.
Il comando SSH sostituisce il client Localtonet per un singolo tunnel. Tutto il resto rimane nella dashboard: l'indirizzo del tunnel, le sue impostazioni, i suoi log e la sua banda.
| Tipo di tunnel | Comando SSH |
|---|---|
| HTTP / HTTPS | Disponibile |
| TCP | Disponibile |
| UDP, UDP / TCP misto, TLS, File server, Server proxy e gli altri tipi | Non disponibile. Questi richiedono il client Localtonet. |
Questa pagina non riguarda l'accesso a un server SSH. Per pubblicare il tuo server SSH tramite un tunnel, consulta Usare Localtonet con SSH. Per aprire una shell su uno dei tuoi dispositivi dalla dashboard, consulta Terminale dispositivo.
Prima di iniziare #
- Un account Localtonet e un servizio già in esecuzione, per esempio un'app web sulla porta 3000.
- Un client
sshsulla macchina che raggiunge il servizio. Verifica conssh -V. - Le connessioni TCP in uscita verso la porta
223devono essere consentite sulla rete di quella macchina. - Un AuthToken che nessun client Localtonet in esecuzione sta usando. Un tunnel appartiene sempre a un token, ma con SSH nessun client accede con esso. Se un client è connesso con il token del tunnel, la dashboard rifiuta di emettere il comando.
Passaggi #
-
Crea un tunnel HTTP o TCP #
Apri I miei tunnel › HTTP oppure I miei tunnel › TCP - UDP (protocollo TCP) e crea il tunnel come al solito. Indirizzo IP locale e Porta locale indicano dove il client SSH invierà il traffico:
127.0.0.1e la porta del tuo servizio quando esegui il comando sulla stessa macchina del servizio. Lascia il tunnel arrestato. -
Apri il comando SSH #
Nell'elenco dei tunnel, seleziona Impostazioni per il tunnel, poi Mostra comando SSH. Si apre la finestra Comando SSH con il comando per questo tunnel. Un avviso ti indica di quanti secondi disponi per eseguirlo; un comando non usato scade e ne richiedi uno nuovo allo stesso modo.
-
Scegli se deve riconnettersi #
Lascia disattivato Riconnetti automaticamente per ottenere il semplice comando
ssh. Attivalo per racchiudere il comando in un ciclo che lo riavvia quando la connessione cade, poi scegli sotto Dove lo eseguirai per quale shell viene scritto il ciclo: PowerShell, Prompt dei comandi oppure macOS o Linux. -
Esegui il comando #
Copia il testo sotto Comando. Apri un terminale sul computer che esegue il tuo servizio, incolla il comando e premi Enter. Non viene richiesta alcuna password. Quando la connessione è attiva, il terminale mostra gli endpoint del tunnel:
Terminale+--------------------------------------------------------------+ | Welcome to Localtonet! | +--------------------------------------------------------------+ | Localtonet Tunnel Endpoints | +--------------------------------------------------------------+ | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000 | | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000 | +--------------------------------------------------------------+ | Server Time: ... | +--------------------------------------------------------------+ You can view your requests and configure your tunnel settings from the Localtonet Dashboard.Un tunnel TCP mostra invece una sola riga:
TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>. -
Tieni aperta la finestra #
Il tunnel si avvia da solo quando il comando si connette; non devi selezionare Avvia. Resta online finché il comando è in esecuzione. Chiudere la finestra termina la connessione e l'indirizzo pubblico smette di rispondere. Per terminare tu stesso il comando, digita
exite premi Enter, oppure premi Ctrl + C.Terminare il comando non arresta il tunnel nella dashboard. Il tunnel resta avviato con la connessione indicata come disattivata, così lo stesso comando può connettersi di nuovo. Quando hai finito con il tunnel, seleziona Arresta per quel tunnel nella dashboard. La dashboard emette un nuovo comando SSH solo per un tunnel arrestato.
Dalla procedura guidata di configurazione del tunnel #
La Procedura guidata di configurazione del tunnel nella Dashboard offre lo stesso comando. Nell'ultimo passaggio, in cui scegli la tua piattaforma, seleziona SSH e poi Ottieni comando SSH. L'opzione SSH compare solo per i tunnel HTTP e TCP. La procedura mostra In attesa di SSH finché il tuo comando non si connette e Connesso tramite SSH subito dopo. Riconnessione automatica aggiunge lo stesso ciclo di riconnessione e Ottieni un nuovo comando sostituisce un comando scaduto.
Il comando spiegato #
Il comando ha sempre questa forma. La dashboard inserisce i valori per il tuo tunnel:
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>| Parte | Cosa fa |
|---|---|
-p 223 | Si connette alla porta 223, dove Localtonet accetta queste connessioni SSH. |
-l <COMMAND_KEY> | Il nome di accesso. È una chiave che la dashboard genera per questo tunnel, non il tuo AuthToken né la password del tuo account. Indica a Localtonet quale tunnel avviare, ed è per questo che non viene richiesta alcuna password. |
<TUNNEL_ADDRESS> | L'indirizzo del tuo tunnel. La connessione SSH va al server che lo ospita. |
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT> | Il remote forward: le connessioni che arrivano per il tunnel sul server vengono inviate attraverso la connessione SSH a <LOCAL_IP>:<LOCAL_PORT>. Gli ultimi due valori sono l'Indirizzo IP locale e la Porta locale del tunnel. La porta del server è assegnata da Localtonet e non deve essere modificata. |
-o ExitOnForwardFailure=yes | Fa terminare ssh se il forward non può essere impostato, invece di restare connesso senza un tunnel funzionante. |
-o ServerAliveInterval=15 -o ServerAliveCountMax=3 | Invia un keep-alive ogni 15 secondi e chiude la connessione dopo tre keep-alive senza risposta, così una connessione interrotta viene rilevata entro circa 45 secondi. |
-o ConnectTimeout=15 | Rinuncia dopo 15 secondi se il server non è raggiungibile. |
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null | Salta la domanda sulla chiave dell'host e non scrive il server nel tuo file known_hosts. |
-o LogLevel=ERROR | Nasconde i messaggi informativi di ssh. Gli errori vengono comunque mostrati. |
Poiché <LOCAL_IP> viene risolto sulla macchina in cui esegui ssh, il servizio non deve trovarsi su quella macchina. Con un indirizzo locale come 192.168.1.20 il comando inoltra il traffico a un altro dispositivo nella stessa rete.
Non condividere il comando. Chiunque lo esegua mentre è valido risponde al traffico del tuo tunnel.
Riconnessione automatica #
Con Riconnetti automaticamente attivo, la dashboard racchiude lo stesso comando ssh in un piccolo script per la shell che hai scelto. Per Prompt dei comandi lo script viene consegnato come un'unica riga powershell -NoProfile -EncodedCommand …. Lo script si comporta allo stesso modo in ogni shell:
- Quando
sshtermina, attende e lo riavvia. L'attesa parte da circa 10 secondi e raddoppia a ogni tentativo fallito, fino a circa 2 minuti. - Una connessione durata almeno 60 secondi conta come riuscita e azzera il tempo di attesa.
- Dopo 8 tentativi consecutivi terminati ciascuno in meno di 60 secondi, si ferma e stampa
SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.
La riconnessione riutilizza lo stesso comando. Funziona dopo un'interruzione di rete, ma non dopo che il tunnel è stato arrestato nella dashboard o ha raggiunto un limite; in quel caso lo script rinuncia e ti serve un nuovo comando.
Per quanto tempo un comando resta valido #
- Prima del primo utilizzo: il comando deve essere eseguito entro il tempo che la dashboard mostra quando lo emette. Dopo questo tempo l'offerta della porta scade.
- Durante l'uso: una sola sessione SSH per tunnel. Una seconda copia del comando viene rifiutata finché la prima è connessa.
- Dopo la fine della connessione: lo stesso comando può connettersi di nuovo, purché il tunnel non sia stato arrestato nella dashboard e non sia stato raggiunto alcun limite.
- Dopo un arresto: quando il tunnel è stato arrestato nella dashboard o da un limite, il comando è esaurito. Apri di nuovo Mostra comando SSH per ottenerne uno nuovo.
La dashboard emette un comando solo mentre il tunnel è arrestato. Un nuovo comando può arrivare con una porta del server diversa; sul piano Gratuito ogni nuovo comando ne riceve una nuova. Per un tunnel TCP quella porta fa parte dell'indirizzo pubblico, quindi controlla l'indirizzo nell'output del terminale o nell'elenco dei tunnel dopo aver richiesto un nuovo comando. Il registro attività del tunnel annota la modifica come Server port changed to "…" for SSH.
Limiti #
- Limite di sessione sul piano Gratuito. Un tunnel avviato tramite SSH segue la stessa regola di uno avviato con il client: sul piano Gratuito i tunnel TCP si arrestano dopo 30 minuti e possono essere riavviati, mentre i tunnel HTTP non hanno limite di tempo. I 30 minuti decorrono dalla prima volta che un comando si connette; riconnettersi con lo stesso comando non li riavvia. Quando una sessione TCP raggiunge il limite, il server chiude la connessione SSH con il messaggio
Session time limit reached. Get a new SSH command from the panel.Consulta Piani e saldo. - Banda. Il traffico viene conteggiato nella tua banda come qualsiasi altro traffico dei tunnel. Senza banda residua non viene emesso alcun comando e il server chiude una sessione in corso con il messaggio
Bandwidth limit reached. Get a new command after bandwidth is available. - Solo inoltro inverso. L'endpoint SSH accetta solo il forward del comando. Non ti dà alcuna shell su un server Localtonet né altri tipi di inoltro.
- Un tunnel per comando. Per eseguire più tunnel, richiedi un comando per ciascuno ed eseguilo in un terminale separato.
Cosa vedi nella dashboard #
Finché il comando è connesso, il tunnel risulta avviato e le richieste compaiono nei suoi log come di consueto. Il Registro attività del tunnel annota Tunnel started over SSH. quando un comando si connette. Consulta Log e ispezione.
Risoluzione dei problemi #
Messaggi nella dashboard #
| Messaggio | Cosa fare |
|---|---|
| Arresta il tunnel prima di richiedere un comando SSH. | Il tunnel è in esecuzione con il client Localtonet. Arrestalo, poi seleziona di nuovo Mostra comando SSH. |
| Arresta il tunnel SSH attuale prima di richiedere un nuovo comando. | Il tunnel è ancora avviato tramite SSH, oppure una sua sessione SSH era attiva fino a un attimo fa. Termina il comando ssh in esecuzione, seleziona Arresta per il tunnel, poi riprova. |
| Un client è connesso a questo tunnel con l'AuthToken che hai creato. Crea un nuovo AuthToken. | Un client Localtonet ha effettuato l'accesso con il token del tunnel. Arresta quel client, oppure crea un altro token in I miei token e usalo per questo tunnel. |
| Non hai abbastanza banda residua per avviare il tunnel. | La tua banda è esaurita. Consulta Piani e saldo. |
| Questa funzione non è disponibile per questo tipo di protocollo. | Il tunnel non è un tunnel HTTP o TCP. |
| Questa funzione non è disponibile su questo server. Sposta il tunnel su un altro server. | Il server di questo tunnel non offre comandi SSH. Crea il tunnel su un altro server. |
| È in corso un'operazione sul tunnel. Riprova tra poco. | Attendi qualche secondo e riprova. |
| Impossibile assegnare una nuova porta del server. | Riprova. Se continua a fallire, crea il tunnel su un altro server. |
| Impossibile salvare la porta SSH. Riprova. | Riprova. |
Messaggi nel terminale #
Quando il server chiude una sessione, invia come motivo uno dei messaggi seguenti. Il modo in cui il motivo viene mostrato dipende dal tuo client ssh.
| Messaggio o sintomo | Causa e soluzione |
|---|---|
ssh termina subito con un errore di autenticazione, tipicamente Permission denied | Localtonet non ha accettato il comando. Non è stato eseguito in tempo, il tunnel è stato arrestato o ha raggiunto un limite dopo l'emissione, un'altra sessione dello stesso comando è già connessa, oppure il testo è stato modificato durante la copia. Ottieni un nuovo comando dalla dashboard e incollalo senza modifiche. |
Port mismatch. Get a new SSH command from the panel. | La porta del server dopo -R non è quella assegnata da Localtonet. Usa il comando esattamente come è stato emesso. |
Session time limit reached. Get a new SSH command from the panel. | La sessione di 30 minuti di un tunnel TCP sul piano Gratuito è terminata. Richiedi un nuovo comando per ripartire. |
Bandwidth limit reached. Get a new command after bandwidth is available. | La tua banda è esaurita. |
Session stopped. Get a new SSH command from the panel. | Il tunnel è stato arrestato, per esempio dalla dashboard. |
Un timeout della connessione, oppure Connection refused | La macchina non riesce a raggiungere il server sulla porta 223. Consenti le connessioni TCP in uscita verso la porta 223 nel firewall oppure prova da un'altra rete. |
| Il tunnel è attivo ma i visitatori ricevono un errore | ssh è connesso ma non riesce a raggiungere il tuo servizio. Verifica che il servizio sia in esecuzione e che l'Indirizzo IP locale e la Porta locale del tunnel siano corretti. Dopo averli modificati, richiedi un nuovo comando, perché il vecchio contiene ancora i vecchi valori. |