Ir para o conteúdo
Localtonet Localtonet Painel

Instalar o Localtonet no Windows

Ajuda com esta página
Nesta página 9 seções
  1. Antes de começar
  2. Escolha uma versão
  3. Usar o app
  4. Instale e abra o app
  5. Entre com o seu token
  6. Inicie um túnel
  7. Usar o cliente de console
  8. Baixe e extraia
  9. Inicie com o seu token
  10. Verifique a sessão
  11. Executar como serviço do Windows
  12. Instale o serviço
  13. Confirme que ele está em execução
  14. Comandos de serviço
  15. Atualizar
  16. Desinstalar
  17. Solução de problemas
  18. Páginas relacionadas

No Windows, você pode usar o app Localtonet da Microsoft Store, uma versão portátil do mesmo app ou o cliente de console. O cliente de console também pode se instalar como um serviço do Windows que inicia a cada boot.

Antes de começar #

  • Uma conta Localtonet. Crie uma gratuitamente se você ainda não tem.
  • Seu AuthToken. Selecione Copiar no cartão AuthToken do Painel ou copie um token de Meus tokens.
  • Para o serviço do Windows: uma janela do Prompt de Comando ou do PowerShell executada como administrador.

Escolha uma versão #

VersãoDownloadObservações
App da Microsoft StoreLocaltonet na Microsoft StoreUma janela de app com uma tela de login. Requer o Windows 10 versão 1809 (build 17763) ou posterior.
App de desktop, ZIP portátilx64, x86, ARM64O mesmo app, sem a Store. Extraia o ZIP e inicie o app a partir da pasta extraída.
Cliente de console64 bits, 32 bits, ARM64Um ZIP que contém um único arquivo, localtonet.exe. É a versão que oferece os comandos de serviço.

A página Downloads oferece o app da Microsoft Store e as três versões de console em Binários.

Usar o app #

  1. Instale e abra o app #

    Instale o Localtonet pela Microsoft Store ou extraia o ZIP portátil e inicie o app. O app abre na tela Sign in to Localtonet.

  2. Entre com o seu token #

    Cole seu AuthToken no campo Authtoken or PIN e selecione Connect. Se o token estiver na área de transferência quando a tela abrir, o app o preenche para você. Em vez do token, você pode digitar o PIN de 6 dígitos que Meus tokens mostra para um token. Um PIN é válido por um minuto.

    Se o app responder Pin or authtoken is not valid., copie o token de novo e confira se todos os 33 caracteres estão lá.

  3. Inicie um túnel #

    Depois de entrar, o app lista os túneis que rodam neste dispositivo. Enquanto a lista disser No active tunnels, crie e inicie um túnel no painel; veja o Início rápido. Sign Out remove o token do app, e Quit Localtonet o fecha.

Usar o cliente de console #

  1. Baixe e extraia #

    Baixe o ZIP para a sua CPU e extraia-o em uma pasta que permaneça no mesmo lugar, por exemplo C:\Localtonet. Um serviço que você instalar depois inicia o localtonet.exe a partir dessa pasta.

  2. Inicie com o seu token #

    Abra o Prompt de Comando ou o PowerShell nessa pasta e execute:

    Prompt de Comando
    localtonet --authtoken <YOUR_TOKEN>

    O PowerShell só executa um programa da pasta atual quando você escreve o caminho, então nele o comando é:

    PowerShell
    .\localtonet --authtoken <YOUR_TOKEN>

    O cliente guarda o token localmente. Da próxima vez, você pode iniciá-lo apenas com localtonet. Se você o iniciar sem um token guardado, ele pergunta Please Enter AuthToken or PIN.

  3. Verifique a sessão #

    A janela mostra Session Status: Connected acima de uma tabela com uma linha para cada túnel em execução: IP/Url, Protocol, Client IP, Client Port, Ping e Status. A tabela fica vazia até você iniciar um túnel no painel. O nome do seu token aparece abaixo da tabela.

    Pressione Ctrl + C para parar o cliente. Pressione F12 para remover o token guardado e sair.

Executar como serviço do Windows #

Um serviço inicia o Localtonet a cada boot, o mantém em execução depois que você faz logout e não precisa de um terminal aberto. Execute estes comandos com o cliente de console, em um Prompt de Comando ou PowerShell executado como administrador.

  1. Instale o serviço #

    Prompt de Comando (Administrador)
    localtonet --install-service --authtoken <YOUR_TOKEN>

    O comando registra um serviço do Windows para este token, define o tipo de inicialização como automático e o inicia na hora. Ele responde com o nome do serviço:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> são os 9 primeiros caracteres do seu token. Cada token tem o próprio serviço, então os outros comandos de serviço precisam do mesmo --authtoken para encontrá-lo.

  2. Confirme que ele está em execução #

    Prompt de Comando (Administrador)
    localtonet --status-service --authtoken <YOUR_TOKEN>

    Um serviço em execução responde [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. O serviço também aparece em services.msc com o mesmo nome, com a descrição Localtonet Service. No painel, o token aparece como Online em Meus tokens.

Comandos de serviço #

Adicione --authtoken <YOUR_TOKEN> a cada comando.

ComandoO que fazExige administrador
--install-serviceCria o serviço com inicialização automática e o inicia. O Windows reinicia o serviço um minuto depois de uma falha.Sim
--start-serviceInicia o serviço instalado, por exemplo depois de você tê-lo parado.Sim
--stop-servicePara o serviço. Ele inicia de novo no próximo boot.Sim
--status-serviceMostra o estado: Running, Stopped, Installing enquanto o serviço está iniciando, Paused, NotFound quando não existe serviço para este token, Error ou Unknown.Não
--remove-servicePara o serviço e o exclui.Sim

O serviço é instalado com as opções que você passa junto com --install-service, então adicione a esse comando opções do cliente, como --net e --ip. As opções estão listadas na Referência da CLI.

O serviço executa o localtonet.exe da pasta em que ele estava quando você instalou o serviço, com o token como parte do comando de inicialização. Não mova nem exclua o arquivo enquanto o serviço estiver instalado.

Atualizar #

  • App da Microsoft Store: a Microsoft Store atualiza o app.
  • Cliente de console e app portátil: baixe o ZIP atual na página Downloads e substitua os arquivos antigos. O Windows não permite substituir o localtonet.exe enquanto ele está em execução, então feche o cliente primeiro. Se ele roda como serviço, execute --stop-service, substitua o arquivo e depois execute --start-service.

localtonet --version mostra a versão instalada. Em Meus tokens, a coluna Cliente mostra a versão que o dispositivo informou pela última vez e um selo Requer atualização quando há uma versão mais nova disponível.

Desinstalar #

  1. Se você instalou o serviço, remova-o: localtonet --remove-service --authtoken <YOUR_TOKEN> como administrador.
  2. Para remover o token guardado, inicie o cliente de console e pressione F12.
  3. Exclua a pasta com o localtonet.exe ou desinstale o app da Store em Configurações do Windows.

Solução de problemas #

'localtonet' is not recognized

O terminal não está na pasta que contém o localtonet.exe, ou você está no PowerShell. Vá primeiro para a pasta. No PowerShell, inicie o cliente como .\localtonet.

Install failed: 'Windows service installation' requires elevated (admin/root) privileges.

O terminal não está sendo executado como administrador. Abra o Prompt de Comando ou o PowerShell com Executar como administrador e repita o comando. --start-service, --stop-service e --remove-service respondem com o mesmo tipo de mensagem.

Install failed: Service 'Localtonet_…' already exists.

Já existe um serviço instalado para este token. Verifique-o com --status-service. Para instalá-lo de novo, por exemplo com outras opções ou a partir de outra pasta, execute primeiro --remove-service.

Start failed: Service could not be started

A mensagem inclui a resposta da ferramenta sc do Windows. O erro 1056 significa que o serviço já está em execução. Isso é esperado quando você executa --start-service logo depois de --install-service, porque o comando de instalação já inicia o serviço. O erro 1060 significa que não existe serviço para este token.

O status é NotFound, mas eu instalei o serviço

O nome do serviço é montado a partir do token. Se você passar um token diferente daquele com que instalou o serviço, o cliente procura outro serviço. Use o mesmo token ou procure em services.msc um serviço que comece com Localtonet_.

Service installation cannot persist proxy passwords.

Você combinou --install-service com --proxy-user ou com uma URL de proxy que contém uma senha. Um serviço não é instalado com senhas de proxy. Use --proxy env e forneça as credenciais no ambiente do serviço. Veja a Referência da CLI.

Wrong Token!

O cliente espera o AuthToken de 33 caracteres de Meus tokens ou um PIN de 6 dígitos que ainda não expirou. Copie o token de novo e informe-o no prompt.

This token is used in another localtonet application!

Outra janela do Localtonet neste computador já está em execução com o mesmo token. Feche-a ou inicie esta com um token diferente. Use um cliente em execução por token.

O token continua Offline no painel

Offline significa que o dispositivo está desconectado. Verifique se a janela do cliente ainda está aberta ou se o status do serviço é Running, e se o cliente foi iniciado com o token que você está olhando.

Suporte