Vai al contenuto
Localtonet Localtonet Dashboard

Terminale dispositivo

Gratuito Desktop v8.6+ Windows, Linux e macOS

Aiuto su questa pagina
In questa pagina 13 sezioni
  1. Come funziona
  2. Prima di iniziare
  3. Aggiungi un dispositivo
  4. Apri Aggiungi dispositivo
  5. Scegli il token
  6. Esegui il comando sul computer
  7. Inserisci il codice e approva
  8. Senza nessuno al computer
  9. Opzioni del comando
  10. L'elenco dei dispositivi
  11. Apri un terminale nel browser
  12. Seleziona Terminale
  13. Inserisci il codice della tua app di autenticazione
  14. Connettiti con ssh
  15. Chiavi SSH
  16. Con il client Localtonet
  17. Chiavi di accesso per script e agenti IA
  18. Elio
  19. Cronologia delle connessioni
  20. Rinomina, rimuovi o disattiva un dispositivo
  21. Note sulla sicurezza
  22. Risoluzione dei problemi
  23. 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 #

  1. Apri Aggiungi dispositivo #

    Apri I miei dispositivi e seleziona Aggiungi dispositivo.

  2. 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.

  3. 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 computer
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    Il comando stampa un codice di approvazione e resta in attesa:

    Output
    Approval 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.

  4. 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.

  1. Nella finestra Aggiungi un dispositivo, scegli il token e inserisci il codice della tua app di autenticazione.
  2. 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.
  3. Copia il comando e sostituisci ACCOUNT con l'account utente con cui le shell devono essere eseguite su quel computer.
Sul 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 #

OpzioneCosa fa
--terminal enableAttiva il terminale remoto per questo computer e avvia l'abbinamento.
--terminal disableLo disattiva su questo computer e rimuove il dispositivo dal tuo account.
--terminal statusStampa 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.

ColonnaCosa mostra
DispositivoIl nome del computer, il suo sistema operativo e l'architettura, e l'account con cui vengono eseguite le shell.
StatoOnline significa che Localtonet è in esecuzione sul computer ed è connesso.
CPUCarico attuale del processore. Visibile mentre il dispositivo è online.
MemoriaMemoria in uso sul totale. Visibile mentre il dispositivo è online.
DiscoSpazio su disco in uso sul totale. Visibile mentre il dispositivo è online.
AzioniTerminale, Chiavi, cronologia delle connessioni, rinomina e rimozione.

Apri un terminale nel browser #

  1. 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.

  2. 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:

Qualsiasi terminale
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.

  1. In I miei dispositivi, seleziona Chiavi SSH.
  2. 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.
  3. 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:

Qualsiasi terminale
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.

Qualsiasi terminale
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

Senza 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.

  1. Seleziona Chiavi nella riga del dispositivo.
  2. 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.
  3. 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.
Script
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

La 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 #

AzioneDoveRisultato
RinominaIl 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.
RimuoviIl 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.
DisattivaSul computer stesso.Disattiva il terminale in locale e rimuove il dispositivo dal tuo account.
Sul computer
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 disable su 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.

Supporto