Terminale dispositivo
Gratuito Desktop v8.6+ Windows, Linux e macOS
In questa pagina 13 sezioni
- Come funziona
- Prima di iniziare
- Aggiungi un dispositivo
- Apri Aggiungi dispositivo
- Scegli il token
- Esegui il comando sul computer
- Inserisci il codice e approva
- Senza nessuno al computer
- Opzioni del comando
- L'elenco dei dispositivi
- Apri un terminale nel browser
- Seleziona Terminale
- Inserisci il codice della tua app di autenticazione
- Connettiti con ssh
- Chiavi SSH
- Con il client Localtonet
- Chiavi di accesso per script e agenti IA
- Elio
- Cronologia delle connessioni
- Rinomina, rimuovi o disattiva un dispositivo
- Note sulla sicurezza
- Risoluzione dei problemi
- Pagine correlate
I miei dispositivi elenca i tuoi computer con l'uso di CPU, memoria e disco, e apre una vera shell su ognuno di essi direttamente dal browser. La attivi con un solo comando sulla macchina; nessuna porta del computer deve essere in ascolto pubblicamente.
Come funziona #
Esegui localtonet --terminal enable sulla macchina e approva nella dashboard il breve codice che viene stampato. Da quel momento un pulsante Terminale apre una shell su quella macchina in una scheda del browser. La stessa shell è raggiungibile da qualsiasi terminale con un comando ssh mostrato dalla dashboard.
- Il dispositivo effettua solo connessioni in uscita. Non c'è nessuna porta in ingresso da aprire e nessun server SSH da installare.
- Per aprire una shell dal browser serve ogni volta un codice nuovo della tua app di autenticazione.
- Solo il comando locale può attivare il terminale. Non è possibile attivarlo dalla dashboard.
Prima di iniziare #
- Localtonet sulla macchina. Versione minima dell'app Localtonet richiesta per usare questa funzione: Desktop v8.6. Scaricala dalla pagina Download.
- Un AuthToken per quella macchina. Assegna a ogni computer il suo token: usare lo stesso token su un secondo computer disconnette il primo. Il terminale funziona con i token del tuo account personale, non con i token del team. Vedi AuthToken.
- Autenticazione a due fattori. Per aprire una shell serve un'app di autenticazione collegata al tuo account. Se non è ancora configurata, I miei dispositivi mostra Attiva l'autenticazione a due fattori. Vedi Account e sicurezza.
I miei dispositivi si trova nel menu della tua dashboard personale. Non è visibile mentre è selezionato un team.
Aggiungi un dispositivo #
-
Apri Aggiungi dispositivo #
Apri I miei dispositivi e seleziona Aggiungi dispositivo.
-
Scegli il token #
Scegli un token esistente oppure seleziona Genera nuovo token per crearne uno e inserirlo nel comando. Se Localtonet è già in esecuzione su questo computer, scegli il suo token. L'elenco indica i token online o già usati su un altro dispositivo. Un token connesso in questo momento mostra un avviso: usalo solo se Localtonet è in esecuzione su questo stesso computer.
-
Esegui il comando sul computer #
Copia il comando dalla finestra ed eseguilo in un terminale sul computer che vuoi aggiungere. Se lì Localtonet è in esecuzione come servizio, usa un terminale con privilegi di amministratore oppure
sudo.Sul computerlocaltonet --terminal enable --authtoken <YOUR_TOKEN>Il comando stampa un codice di approvazione e resta in attesa:
OutputApproval code: ABCD-EFGH Open https://localtonet.com/devices, choose Add device and enter this code. Waiting for approval...Se lo esegui come amministratore o root, chiede prima Run shells as user: e propone il tuo account. Senza questi privilegi, le shell vengono eseguite con l'account che ha lanciato il comando.
-
Inserisci il codice e approva #
Tornato nella finestra, digita il codice di approvazione sotto 2. Inserisci il codice mostrato. Le maiuscole e il trattino vengono aggiunti per te e puoi incollare l'intera riga stampata dal comando. Inserisci il codice a 6 cifre della tua app di autenticazione e seleziona Approva dispositivo.
Il comando sul computer stampa quindi Terminal enabled. Shells will run as … e il dispositivo compare nell'elenco. Risulta online finché Localtonet è in esecuzione.
Il codice di approvazione è valido per 15 minuti. Ha 8 caratteri e non contiene mai I, L, O, U, 0 o 1. Se scade, il comando lo segnala: eseguilo di nuovo.
Dopo l'approvazione, un comando avviato a mano in una console prosegue come una normale esecuzione di Localtonet. In uno script, o quando Localtonet è già in esecuzione sul dispositivo con questo token, il comando termina una volta attivato il terminale.
Senza nessuno al computer #
Per una macchina dove nessuno può leggere un codice, ad esempio un server configurato con uno script, usa una chiave monouso al posto del codice di approvazione.
- Nella finestra Aggiungi un dispositivo, scegli il token e inserisci il codice della tua app di autenticazione.
- Apri Nessuno può leggere un codice su quel computer? e seleziona Crea chiave monouso. La chiave è valida per un'ora e funziona una sola volta.
- Copia il comando e sostituisci
ACCOUNTcon l'account utente con cui le shell devono essere eseguite su quel computer.
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>Con una chiave valida il dispositivo viene approvato subito e non viene mostrato nessun codice.
Opzioni del comando #
| Opzione | Cosa fa |
|---|---|
--terminal enable | Attiva il terminale remoto per questo computer e avvia l'abbinamento. |
--terminal disable | Lo disattiva su questo computer e rimuove il dispositivo dal tuo account. |
--terminal status | Stampa se il terminale è attivo e con quale account vengono eseguite le shell. |
--terminal-user <ACCOUNT> | L'account con cui vengono eseguite le shell, quando attivi come root o amministratore. In quel caso è obbligatorio se il comando viene eseguito senza console, ad esempio da uno script. |
--pairing-key <PAIRING_KEY> | La chiave monouso della dashboard, così non serve nessun codice di approvazione. |
L'elenco dei dispositivi #
L'elenco si aggiorna da solo finché la pagina è aperta.
| Colonna | Cosa mostra |
|---|---|
| Dispositivo | Il nome del computer, il suo sistema operativo e l'architettura, e l'account con cui vengono eseguite le shell. |
| Stato | Online significa che Localtonet è in esecuzione sul computer ed è connesso. |
| CPU | Carico attuale del processore. Visibile mentre il dispositivo è online. |
| Memoria | Memoria in uso sul totale. Visibile mentre il dispositivo è online. |
| Disco | Spazio su disco in uso sul totale. Visibile mentre il dispositivo è online. |
| Azioni | Terminale, Chiavi, cronologia delle connessioni, rinomina e rimozione. |
Apri un terminale nel browser #
-
Seleziona Terminale #
Seleziona Terminale nella riga del dispositivo. Il pulsante funziona solo mentre il dispositivo è online. La finestra ti indica con quale account viene eseguita la shell.
-
Inserisci il codice della tua app di autenticazione #
Inserisci il codice a 6 cifre della tua app di autenticazione e seleziona Apri terminale. La shell si apre in una nuova scheda del browser.
Connettiti con ssh #
La finestra Terminale mostra anche un comando sotto Oppure da qualsiasi terminale, senza installare nulla. Funziona da qualsiasi computer con un client ssh. Il comando ha questa forma, dove <DEVICE> è il nome del tuo dispositivo e <NODE> è il server Localtonet a cui è connesso:
ssh -p 24 <DEVICE>@<NODE>Copia il comando dalla finestra: mostra il comando esatto per il tuo dispositivo.
- La finestra mostra l'Impronta del server. ssh mostra un'impronta alla prima connessione. Se coincide, hai raggiunto Localtonet.
- Se non hai aggiunto una chiave SSH, ssh mostra un link da approvare nel browser. La pagina Approva connessione indica il dispositivo e l'indirizzo IP da cui proviene la richiesta. Inserisci il codice della tua app di autenticazione, seleziona Consenti connessione e torna al terminale. La richiesta scade dopo 5 minuti.
Approva una connessione solo se hai appena eseguito tu il comando ssh. Chi ha fatto la richiesta ottiene una shell su quel computer.
Chiavi SSH #
Aggiungi la chiave SSH pubblica del tuo computer, così ssh, scp e sftp si connettono senza chiedere l'approvazione nel browser.
- In I miei dispositivi, seleziona Chiavi SSH.
- Inserisci un Nome e incolla una riga del file della tua chiave pubblica, ad esempio
~/.ssh/id_ed25519.pub, in Chiave pubblica. Non incollare mai la tua chiave privata. - Inserisci il codice della tua app di autenticazione e seleziona Aggiungi chiave.
I tipi di chiave accettati sono ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 e ssh-rsa. Una chiave vale per tutti i dispositivi del tuo account. Seleziona Rimuovi accanto a una chiave per impedirne l'uso. La finestra mostra anche un esempio di scp per uno dei tuoi dispositivi:
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/Con il client Localtonet #
Se Localtonet è installato sul computer da cui ti connetti, anche localtonet ssh si connette, e la sessione resta cifrata fino al dispositivo.
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptimeSenza una chiave stampa Approve this connection in your browser con un link e prosegue appena approvi. Tutto ciò che segue -- viene eseguito come un unico comando sul dispositivo invece di aprire una shell.
Chiavi di accesso per script e agenti IA #
Una chiave di accesso permette a uno script o a un agente IA di raggiungere un computer senza browser. Chiunque la possieda può eseguire comandi su quel computer, quindi tienila riservata.
- Seleziona Chiavi nella riga del dispositivo.
- Inserisci un Nome, imposta Valida per (giorni) e inserisci il codice della tua app di autenticazione. La chiave smette di funzionare dopo quel numero di giorni, al massimo 3650.
- Seleziona Crea chiave e copia subito la chiave. Non verrà mostrata di nuovo.
Modi per usare la chiave:
- ssh. Esegui il comando ssh mostrato nella finestra. Quando ssh lo chiede, incolla la chiave.
- Client Localtonet. Passa la chiave con l'opzione
--key, come nell'esempio qui sotto. - MCP. Gli agenti IA collegati al server MCP di Localtonet possono passare la chiave allo strumento
RunDeviceCommand.
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptimeLa finestra elenca le chiavi del dispositivo con la data di scadenza. Seleziona Rimuovi per revocarne una.
Elio #
Il pulsante Elio in I miei dispositivi riguarda Elio, il client SSH gratuito e open source di Localtonet. Lo scarichi da elio.sh, accedi da Elio e approvi la richiesta nella dashboard con il tuo codice a due fattori. Elio vede quindi i nomi e lo stato dei tuoi dispositivi. Per aprire una shell su uno di essi servono comunque la chiave di accesso o un'approvazione di quel dispositivo. La finestra elenca le copie di Elio con accesso effettuato; rimuoverne una la disconnette.
Cronologia delle connessioni #
Seleziona il pulsante con l'orologio nella riga di un dispositivo per vedere le sue ultime connessioni. Ogni riga indica quando è avvenuta, come è stata effettuata e da quale indirizzo IP. Il come è uno dei seguenti: il terminale nel browser, ssh con la tua chiave SSH, ssh con una chiave di accesso, ssh approvato nel browser, localtonet ssh con una chiave di accesso o approvato nel browser, e un agente IA tramite MCP con una chiave di accesso. L'elenco contiene le 50 connessioni più recenti.
Localtonet conserva solo questa registrazione. I comandi che digiti e il loro output non vengono salvati. Usa l'elenco per individuare una connessione che non hai fatto tu: se ne trovi una, rimuovi le chiavi di accesso e le chiavi SSH che non ti servono più.
Rinomina, rimuovi o disattiva un dispositivo #
| Azione | Dove | Risultato |
|---|---|---|
| Rinomina | Il pulsante con la matita nella riga. | Cambia il nome mostrato nell'elenco e usato nel comando ssh. Usa lettere, numeri, punti, trattini o trattini bassi. |
| Rimuovi | Il pulsante con il cestino nella riga. | Rimuove il computer dal tuo account. Le sue chiavi smettono di funzionare e deve essere approvato di nuovo per tornare. |
| Disattiva | Sul computer stesso. | Disattiva il terminale in locale e rimuove il dispositivo dal tuo account. |
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>La disattivazione funziona sempre sul computer, anche quando la dashboard non è raggiungibile. In quel caso il comando ti dice di rimuovere il dispositivo anche dalla dashboard.
Note sulla sicurezza #
- Una shell su una macchina dà pieno accesso a tutto ciò che il suo account può fare. Scegli con cura l'account con cui vengono eseguite le shell; un account senza privilegi limita ciò che una sessione può modificare.
- Tutto ciò che può portare a una shell richiede un codice nuovo della app di autenticazione: approvare un dispositivo, aprire un terminale, creare una chiave di accesso, aggiungere una chiave SSH e approvare una connessione ssh.
- Una chiave di accesso o una chiave SSH aggiunta si connette senza quel codice. Dai alle chiavi una validità breve, conservale come password e rimuovi quelle che non usi più.
- Dopo troppi tentativi in poco tempo la dashboard risponde Troppi tentativi. Attendi un minuto e riprova.
- Controlla ogni tanto la cronologia delle connessioni. Una connessione che non riconosci significa che è stata usata una chiave o un'approvazione che non ti aspettavi.
- Rimuovere un dispositivo, o eseguire
--terminal disablesu di esso, interrompe l'accesso di tutte le sue chiavi.
Risoluzione dei problemi #
Quel codice di approvazione è errato o scaduto
Controlla il codice confrontandolo con quello stampato dal comando. Un codice è valido per 15 minuti e appartiene all'account del token usato nel comando. Esegui di nuovo il comando per ottenere un nuovo codice.
Remote terminal is available on personal tokens only
Il token nel comando appartiene a un team. Crea un token nel tuo account personale e usa quello.
The pairing key is not valid or has expired
Una chiave monouso funziona una sola volta e per un'ora. Creane una nuova nella finestra Aggiungi un dispositivo.
Scegli l'account per le shell con --terminal-user
Il comando viene eseguito come root o amministratore senza console, quindi non può chiederlo. Aggiungi --terminal-user <ACCOUNT>.
Il pulsante Terminale è disattivato, oppure Questo dispositivo è offline
Il terminale si apre solo mentre il dispositivo è online. Avvia Localtonet su quel computer con lo stesso token.
Quel codice di autenticazione non è corretto
Inserisci il codice a 6 cifre che la tua app di autenticazione mostra per Localtonet. Non è la tua password e non è il codice mostrato sul computer, e cambia ogni 30 secondi.
Questa richiesta è scaduta. Ricomincia da I miei dispositivi
Una richiesta di apertura di un terminale o di approvazione di una connessione ssh ha vita breve. Seleziona di nuovo Terminale, oppure esegui di nuovo il comando ssh.
Non sembra una chiave pubblica SSH
Incolla l'intera riga del tuo file .pub, a partire dal tipo di chiave.
The terminal is already enabled on this device
Non c'è nulla da fare. Per abbinare di nuovo la macchina, esegui prima --terminal disable, poi --terminal enable.