Instalar o cliente Localtonet
Nesta página 5 seções
O cliente Localtonet roda no dispositivo que hospeda o seu serviço e mantém aberto o túnel até o Localtonet. Esta página lista as plataformas compatíveis, ajuda você a escolher o tipo certo de instalação e traz links para o guia de cada uma.
Plataformas compatíveis #
Todos os downloads estão na página Downloads.
| Plataforma | O que você pode instalar | Arquiteturas |
|---|---|---|
| Windows | App da Microsoft Store, app de desktop portátil, cliente de console | 64 bits (x64), 32 bits (x86), ARM64 |
| macOS | Cliente de console, com Homebrew ou como arquivo ZIP | Intel (x64), Apple Silicon (ARM64) |
| Linux | Cliente de console, com o script de instalação ou como arquivo ZIP | x64, ARM e ARM64, cada um para glibc e para musl |
| Pacotes Linux | Pacotes DEB e RPM com serviços systemd | x64, ARM64 |
| Android | App Android do Google Play ou como arquivo APK | A versão mínima do Android do app é a 5.0 |
| Termux | Cliente de console como pacote do Termux | ARM64 |
| Docker | Imagem oficial localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | Pacotes de roteador para OpenWrt 24.10 e 25.12+ (experimental) | x64, ARM64 |
| NAS e Home Assistant | Modelos de configuração para Docker Compose e Home Assistant | AMD64, ARM64 |
| SSH sem instalação | Nada. Você usa o cliente SSH que já tem. | Qualquer dispositivo com um cliente SSH |
Escolha o tipo de instalação #
| Opção | O que é | Escolha quando |
|---|---|---|
| Cliente de console | O programa localtonet para Windows, macOS e Linux. Você o inicia em um terminal com o seu AuthToken. Ele mostra os seus túneis em uma tabela ao vivo e pode se instalar como serviço. | Você trabalha em um terminal, ou o dispositivo é um servidor sem desktop. |
| App de desktop | O app Localtonet para Windows com uma janela de login, da Microsoft Store ou como ZIP portátil. | Você prefere uma janela de aplicativo a um terminal no Windows. |
| App móvel | O app Localtonet para Android. Você entra com um QR code, um PIN ou o token. | O dispositivo é um celular ou tablet Android, por exemplo para um proxy móvel. |
| Pacote | Pacotes DEB e RPM para Linux, um pacote do Termux para Android e pacotes experimentais para OpenWrt. Os pacotes de Linux e OpenWrt vêm com um serviço que lê o token de um arquivo. | Você quer que o gerenciador de pacotes do sistema instale e remova o cliente, e um serviço que inicia junto com o sistema. |
| Contêiner | A imagem oficial do Docker e os modelos de configuração para dispositivos NAS e Home Assistant que a usam. | Os seus serviços já rodam em contêineres, ou o dispositivo é um NAS. |
| SSH sem instalação | O painel gera um comando ssh que abre o túnel. Nenhum download é necessário. É oferecido para túneis HTTP e TCP. | Você não pode ou não quer instalar nada no dispositivo. |
O que toda instalação tem em comum #
-
O cliente faz login com um AuthToken #
Um AuthToken conecta um dispositivo à sua conta. Copie-o com Copiar no cartão AuthToken do Painel, ou crie um token com nome para cada dispositivo em Meus tokens. Os tokens são explicados em AuthTokens.
Mantenha o seu token privado. Qualquer pessoa com o token pode usá-lo para entrar no app.
-
Você inicia o cliente com esse token #
Substitua
<YOUR_TOKEN>pelo seu token.Windows
Abra o app Localtonet e cole o seu AuthToken, ou execute o cliente de console no Prompt de Comando, na pasta que contém o
localtonet.exe:Prompt de Comandolocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
Abra o app Localtonet, escaneie o QR code do token, digite o PIN dele ou cole o token e selecione Connect. O QR code e o PIN ficam em Meus tokens.
O cliente de console armazena o token localmente, então da próxima vez você pode iniciá-lo só com
localtonet. Quando você o inicia sem um token armazenado, ele perguntaPlease Enter AuthToken or PIN. -
Você cria e inicia túneis no painel #
O cliente não precisa conhecer os seus túneis de antemão. Você cria um túnel em Meus túneis, escolhe o token do dispositivo, e o cliente que está logado com esse token o atende. O Início rápido mostra o primeiro túnel passo a passo.
-
O cliente precisa continuar em execução #
Um túnel fica no ar quando o cliente está em execução com o seu AuthToken e o túnel está iniciado. Meus tokens mostra cada dispositivo como Online ou Offline. Offline significa que o dispositivo está desconectado, mesmo que os túneis dele ainda estejam configurados.
Para manter o cliente em execução depois de fechar o terminal, sair da conta ou reiniciar o dispositivo, instale-o como serviço:
Plataforma Como Windows localtonet --install-service --authtoken <YOUR_TOKEN>em um terminal executado como AdministradormacOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>Pacotes DEB, RPM e OpenWrt O pacote contém o serviço. Você o habilita depois de definir o token. Android O app continua em execução em segundo plano e abre de novo depois que o celular reinicia. Os detalhes estão em Executar como serviço e na página de cada plataforma.
Mantenha o cliente atualizado #
A coluna Cliente em Meus tokens mostra a última versão que cada dispositivo informou. Um selo Requer atualização leva à página Downloads quando há uma versão mais nova disponível. O cliente de console também mostra New Version available sob a tabela de túneis, e localtonet --version imprime a versão instalada.