Instalar o Localtonet no Windows
Nesta página 9 seções
- Antes de começar
- Escolha uma versão
- Usar o app
- Instale e abra o app
- Entre com o seu token
- Inicie um túnel
- Usar o cliente de console
- Baixe e extraia
- Inicie com o seu token
- Verifique a sessão
- Executar como serviço do Windows
- Instale o serviço
- Confirme que ele está em execução
- Comandos de serviço
- Atualizar
- Desinstalar
- Solução de problemas
- 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ão | Download | Observações |
|---|---|---|
| App da Microsoft Store | Localtonet na Microsoft Store | Uma janela de app com uma tela de login. Requer o Windows 10 versão 1809 (build 17763) ou posterior. |
| App de desktop, ZIP portátil | x64, x86, ARM64 | O mesmo app, sem a Store. Extraia o ZIP e inicie o app a partir da pasta extraída. |
| Cliente de console | 64 bits, 32 bits, ARM64 | Um 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 #
-
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.
-
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á. -
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 #
-
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 olocaltonet.exea partir dessa pasta. -
Inicie com o seu token #
Abra o Prompt de Comando ou o PowerShell nessa pasta e execute:
Prompt de Comandolocaltonet --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 perguntaPlease Enter AuthToken or PIN. -
Verifique a sessão #
A janela mostra
Session Status: Connectedacima de uma tabela com uma linha para cada túnel em execução:IP/Url,Protocol,Client IP,Client Port,PingeStatus. 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.
-
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--authtokenpara encontrá-lo. -
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 emservices.msccom o mesmo nome, com a descriçãoLocaltonet Service. No painel, o token aparece como Online em Meus tokens.
Comandos de serviço #
Adicione --authtoken <YOUR_TOKEN> a cada comando.
| Comando | O que faz | Exige administrador |
|---|---|---|
--install-service | Cria 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-service | Inicia o serviço instalado, por exemplo depois de você tê-lo parado. | Sim |
--stop-service | Para o serviço. Ele inicia de novo no próximo boot. | Sim |
--status-service | Mostra 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-service | Para 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.exeenquanto 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 #
- Se você instalou o serviço, remova-o:
localtonet --remove-service --authtoken <YOUR_TOKEN>como administrador. - Para remover o token guardado, inicie o cliente de console e pressione F12.
- Exclua a pasta com o
localtonet.exeou 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.