Ir para o conteúdo
Localtonet Localtonet Painel

Terminal de dispositivo

Free Desktop v8.6+ Windows, Linux e macOS

Ajuda com esta página
Nesta página 13 seções
  1. Como funciona
  2. Antes de começar
  3. Adicionar um dispositivo
  4. Abra Adicionar dispositivo
  5. Escolha o token
  6. Execute o comando no computador
  7. Digite o código e aprove
  8. Sem ninguém no computador
  9. Opções do comando
  10. A lista de dispositivos
  11. Abrir um terminal no navegador
  12. Selecione Terminal
  13. Digite o código do seu autenticador
  14. Conecte-se com ssh
  15. Chaves SSH
  16. Com o cliente Localtonet
  17. Chaves de acesso para scripts e agentes de IA
  18. Elio
  19. Histórico de conexões
  20. Renomear, remover ou desativar um dispositivo
  21. Notas de segurança
  22. Solução de problemas
  23. Páginas relacionadas

Meus dispositivos lista seus computadores com o uso de CPU, memória e disco, e abre um shell de verdade em qualquer um deles pelo navegador. Você ativa o recurso com um único comando na máquina; nada no computador precisa escutar em uma porta pública.

Como funciona #

Você executa localtonet --terminal enable na máquina e aprova no painel o código curto que ele exibe. A partir daí, um botão Terminal abre um shell nessa máquina em uma aba do navegador. O mesmo shell pode ser acessado de qualquer terminal com um comando ssh que o painel mostra.

  • O dispositivo faz apenas conexões de saída. Não há porta de entrada para abrir nem servidor SSH para instalar.
  • Abrir um shell pelo navegador exige, a cada vez, um código novo do seu aplicativo autenticador.
  • Somente o comando local pode ativar o terminal. Ele não pode ser ativado pelo painel.

Antes de começar #

  • Localtonet na máquina. Versão mínima do aplicativo Localtonet necessária para usar este recurso: Desktop v8.6. Baixe-o na página Downloads.
  • Um AuthToken para essa máquina. Dê a cada computador o seu próprio token: usar o mesmo token em um segundo computador desconecta o primeiro. O terminal funciona com tokens da sua conta pessoal, não com tokens de equipe. Veja AuthTokens.
  • Autenticação em dois fatores. Abrir um shell exige um aplicativo autenticador na sua conta. Se ele ainda não estiver configurado, Meus dispositivos mostra Ativar a autenticação em duas etapas. Veja Conta e segurança.

Meus dispositivos fica no menu do seu painel pessoal. Ele não aparece enquanto uma equipe está selecionada.

Adicionar um dispositivo #

  1. Abra Adicionar dispositivo #

    Abra Meus dispositivos e selecione Adicionar dispositivo.

  2. Escolha o token #

    Escolha um token existente ou selecione Gerar novo token para criar um e colocá-lo no comando. Se o Localtonet já estiver em execução neste computador, escolha o token dele. A lista marca os tokens que estão online ou que já são usados em outro dispositivo. Um token conectado neste momento mostra um aviso: use-o somente se o Localtonet estiver em execução neste mesmo computador.

  3. Execute o comando no computador #

    Copie o comando da caixa de diálogo e execute-o em um terminal no computador que você quer adicionar. Se o Localtonet roda lá como serviço, use um terminal de administrador ou sudo.

    No computador
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    O comando exibe um código de aprovação e fica aguardando:

    Saída
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    Quando você o executa como administrador ou root, ele primeiro pergunta Run shells as user: e sugere a sua própria conta. Sem esses privilégios, os shells são executados como a conta que executou o comando.

  4. Digite o código e aprove #

    De volta à caixa de diálogo, digite o código de aprovação em 2. Digite o código exibido. As letras maiúsculas e o hífen são adicionados para você, e você pode colar a linha inteira que o comando exibiu. Digite o código de 6 dígitos do seu aplicativo autenticador e selecione Aprovar dispositivo.

    O comando no computador então exibe Terminal enabled. Shells will run as … e o dispositivo aparece na lista. Ele aparece como online enquanto o Localtonet estiver em execução nele.

O código de aprovação é válido por 15 minutos. Ele tem 8 caracteres e nunca contém I, L, O, U, 0 ou 1. Se expirar, o comando avisa: execute-o de novo.

Após a aprovação, um comando que você iniciou manualmente em um console continua como uma execução normal do Localtonet. Em um script, ou quando o Localtonet já está em execução no dispositivo com este token, o comando termina assim que o terminal é ativado.

Sem ninguém no computador #

Para uma máquina em que ninguém consegue ler um código, por exemplo um servidor configurado por script, use uma chave de uso único no lugar do código de aprovação.

  1. Na caixa de diálogo Adicionar um dispositivo, escolha o token e digite o código do seu autenticador.
  2. Abra Ninguém consegue ler um código nesse computador? e selecione Criar chave de uso único. A chave é válida por uma hora e funciona uma única vez.
  3. Copie o comando e substitua ACCOUNT pela conta de usuário com a qual os shells devem ser executados nesse computador.
No computador
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

Com uma chave válida, o dispositivo é aprovado na hora e nenhum código é exibido.

Opções do comando #

OpçãoO que faz
--terminal enableAtiva o terminal remoto neste computador e inicia o pareamento.
--terminal disableDesativa o terminal neste computador e remove o dispositivo da sua conta.
--terminal statusExibe se o terminal está ativado e com qual conta os shells são executados.
--terminal-user <ACCOUNT>A conta com a qual os shells são executados, quando você ativa como root ou administrador. Obrigatória nesse caso quando o comando roda sem console, por exemplo em um script.
--pairing-key <PAIRING_KEY>A chave de uso único do painel, para que nenhum código de aprovação seja necessário.

A lista de dispositivos #

A lista é atualizada sozinha enquanto a página estiver aberta.

ColunaO que mostra
DispositivoO nome do computador, seu sistema operacional e arquitetura, e a conta com a qual os shells são executados.
StatusOnline significa que o Localtonet está em execução no computador e conectado.
CPUCarga atual do processador. Exibida enquanto o dispositivo está online.
MemóriaMemória em uso em relação ao total. Exibida enquanto o dispositivo está online.
DiscoEspaço em disco em uso em relação ao total. Exibido enquanto o dispositivo está online.
AçõesTerminal, Chaves, histórico de conexões, renomear e remover.

Abrir um terminal no navegador #

  1. Selecione Terminal #

    Selecione Terminal na linha do dispositivo. O botão só funciona enquanto o dispositivo está online. A caixa de diálogo informa com qual conta o shell é executado.

  2. Digite o código do seu autenticador #

    Digite o código de 6 dígitos do seu aplicativo autenticador e selecione Abrir terminal. O shell abre em uma nova aba do navegador.

Conecte-se com ssh #

A caixa de diálogo Terminal também mostra um comando em Ou de qualquer terminal, sem instalar nada. Ele funciona em qualquer computador com um cliente ssh. O comando tem esta forma, em que <DEVICE> é o nome do seu dispositivo e <NODE> é o servidor Localtonet ao qual ele está conectado:

Qualquer terminal
ssh -p 24 <DEVICE>@<NODE>

Copie o comando da caixa de diálogo: ela mostra o comando exato para o seu dispositivo.

  • A caixa de diálogo mostra o Fingerprint do servidor. O ssh mostra um fingerprint na primeira vez que você se conecta. Se ele for igual, você chegou ao Localtonet.
  • Se você não adicionou uma chave SSH, o ssh mostra um link para aprovar no navegador. A página Aprovar conexão informa o dispositivo e o endereço IP de onde veio a solicitação. Digite o código do seu autenticador, selecione Permitir conexão e volte ao seu terminal. A solicitação expira após 5 minutos.

Só aprove uma conexão se você mesmo acabou de executar o comando ssh. Quem fez a solicitação obtém um shell nesse computador.

Chaves SSH #

Adicione a chave SSH pública do seu próprio computador para que ssh, scp e sftp se conectem sem pedir aprovação no navegador.

  1. Em Meus dispositivos, selecione Chaves SSH.
  2. Digite um Nome e cole uma linha do arquivo da sua chave pública, por exemplo ~/.ssh/id_ed25519.pub, em Chave pública. Nunca cole a sua chave privada.
  3. Digite o código do seu autenticador e selecione Adicionar chave.

Os tipos de chave aceitos são ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 e ssh-rsa. Uma chave vale para todos os dispositivos da sua conta. Selecione Remover ao lado de uma chave para que ela deixe de funcionar. A caixa de diálogo também mostra um exemplo de scp para um dos seus dispositivos:

Qualquer terminal
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

Com o cliente Localtonet #

Se o Localtonet estiver instalado no computador de onde você se conecta, localtonet ssh também se conecta, e a sessão permanece criptografada até o dispositivo.

Qualquer terminal
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

Sem uma chave, ele exibe Approve this connection in your browser com um link e continua assim que você aprova. Tudo que vem depois de -- é executado como um único comando no dispositivo, em vez de abrir um shell.

Chaves de acesso para scripts e agentes de IA #

Uma chave de acesso permite que um script ou um agente de IA alcance um computador sem navegador. Quem a possui pode executar comandos nele, portanto mantenha-a em sigilo.

  1. Selecione Chaves na linha do dispositivo.
  2. Digite um Nome, defina Válida por (dias) e digite o código do seu autenticador. A chave deixa de funcionar após esse número de dias, no máximo 3650.
  3. Selecione Criar chave e copie a chave agora. Ela não será exibida novamente.

Formas de usar a chave:

  • ssh. Execute o comando ssh que a caixa de diálogo mostra. Quando o ssh pedir, cole a chave.
  • Cliente Localtonet. Passe a chave com a opção --key, como no exemplo abaixo.
  • MCP. Agentes de IA conectados ao servidor MCP do Localtonet podem passar a chave para a ferramenta RunDeviceCommand.
Script
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

A caixa de diálogo lista as chaves do dispositivo com a data de expiração. Selecione Remover para revogar uma.

Elio #

O botão Elio em Meus dispositivos trata do Elio, o cliente SSH gratuito e de código aberto da Localtonet. Você o baixa em elio.sh, entra pelo Elio e aprova a solicitação no painel com o seu código de dois fatores. O Elio passa então a ver os nomes e o status dos seus dispositivos. Abrir um shell em um deles ainda exige a chave de acesso do dispositivo ou uma aprovação. A caixa de diálogo lista as cópias do Elio com sessão iniciada; remover uma encerra a sessão dela.

Histórico de conexões #

Selecione o botão de relógio na linha de um dispositivo para ver as conexões mais recentes. Cada linha mostra quando ocorreu, como foi feita e de qual endereço IP. O modo é um destes: o terminal do navegador, ssh com a sua chave SSH, ssh com uma chave de acesso, ssh aprovado no navegador, localtonet ssh com uma chave de acesso ou aprovado no navegador, e um agente de IA via MCP com uma chave de acesso. A lista guarda as 50 conexões mais recentes.

O Localtonet guarda apenas esse registro. Os comandos que você digita e a saída deles não são armazenados. Use a lista para identificar uma conexão que você não fez: se encontrar uma, remova as chaves de acesso e as chaves SSH de que você não precisa mais.

Renomear, remover ou desativar um dispositivo #

AçãoOndeResultado
RenomearO botão de lápis na linha.Altera o nome exibido na lista e usado no comando ssh. Use letras, números, pontos, hifens ou sublinhados.
RemoverO botão de lixeira na linha.Remove o computador da sua conta. As chaves dele deixam de funcionar e ele precisa ser aprovado de novo para voltar.
DesativarNo próprio computador.Desativa o terminal localmente e remove o dispositivo da sua conta.
No computador
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

Desativar sempre funciona no computador, mesmo quando o painel não pode ser alcançado. Nesse caso, o comando orienta você a remover também o dispositivo no painel.

Notas de segurança #

  • Um shell em uma máquina dá acesso total a tudo que a conta dele pode fazer. Escolha com cuidado a conta com a qual os shells são executados; uma conta sem privilégios limita o que uma sessão pode alterar.
  • Tudo que pode levar a um shell pede um código novo do autenticador: aprovar um dispositivo, abrir um terminal, criar uma chave de acesso, adicionar uma chave SSH e aprovar uma conexão ssh.
  • Uma chave de acesso ou uma chave SSH adicionada conecta sem esse código. Dê às chaves uma validade curta, guarde-as como senhas e remova as que você não usa mais.
  • Após tentativas demais em pouco tempo, o painel responde Tentativas demais. Aguarde um minuto e tente de novo.
  • Olhe o histórico de conexões de vez em quando. Uma conexão que você não reconhece significa que uma chave ou uma aprovação foi usada sem que você esperasse.
  • Remover um dispositivo, ou executar --terminal disable nele, encerra o acesso de todas as suas chaves.

Solução de problemas #

Esse código de aprovação está errado ou expirou

Compare o código com o que o comando exibiu. Um código é válido por 15 minutos e pertence à conta do token usado no comando. Execute o comando de novo para obter um código novo.

Remote terminal is available on personal tokens only

O token do comando pertence a uma equipe. Crie um token na sua conta pessoal e use esse.

The pairing key is not valid or has expired

Uma chave de uso único funciona uma vez e por uma hora. Crie uma nova na caixa de diálogo Adicionar um dispositivo.

Escolha a conta dos shells com --terminal-user

O comando roda como root ou administrador sem console, então não consegue perguntar. Adicione --terminal-user <ACCOUNT>.

O botão Terminal está desativado, ou Este dispositivo está offline

O terminal só abre enquanto o dispositivo está online. Inicie o Localtonet nesse computador com o mesmo token.

Esse código do autenticador não está correto

Digite o código de 6 dígitos que o seu aplicativo autenticador mostra para o Localtonet. Não é a sua senha nem o código exibido no computador, e ele muda a cada 30 segundos.

Esta solicitação expirou. Comece de novo em Meus dispositivos

Uma solicitação para abrir um terminal ou aprovar uma conexão ssh tem vida curta. Selecione Terminal de novo, ou execute o comando ssh de novo.

Isso não parece uma chave pública SSH

Cole a linha inteira do seu arquivo .pub, começando pelo tipo da chave.

O terminal já está ativado neste dispositivo

Nada a fazer. Para parear a máquina de novo, execute primeiro --terminal disable e depois --terminal enable.

Suporte