Ir para o conteúdo
Localtonet Localtonet Painel

Instalar o cliente Localtonet

Ajuda com esta página
Nesta página 5 seções
  1. Plataformas compatíveis
  2. Escolha o tipo de instalação
  3. O que toda instalação tem em comum
  4. O cliente faz login com um AuthToken
  5. Você inicia o cliente com esse token
  6. Você cria e inicia túneis no painel
  7. O cliente precisa continuar em execução
  8. Mantenha o cliente atualizado
  9. Guias de instalação

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.

PlataformaO que você pode instalarArquiteturas
WindowsApp da Microsoft Store, app de desktop portátil, cliente de console64 bits (x64), 32 bits (x86), ARM64
macOSCliente de console, com Homebrew ou como arquivo ZIPIntel (x64), Apple Silicon (ARM64)
LinuxCliente de console, com o script de instalação ou como arquivo ZIPx64, ARM e ARM64, cada um para glibc e para musl
Pacotes LinuxPacotes DEB e RPM com serviços systemdx64, ARM64
AndroidApp Android do Google Play ou como arquivo APKA versão mínima do Android do app é a 5.0
TermuxCliente de console como pacote do TermuxARM64
DockerImagem oficial localtonet/localtonetAMD64, ARM64
OpenWrtPacotes de roteador para OpenWrt 24.10 e 25.12+ (experimental)x64, ARM64
NAS e Home AssistantModelos de configuração para Docker Compose e Home AssistantAMD64, ARM64
SSH sem instalaçãoNada. Você usa o cliente SSH que já tem.Qualquer dispositivo com um cliente SSH

Escolha o tipo de instalação #

OpçãoO que éEscolha quando
Cliente de consoleO 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 desktopO 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óvelO 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.
PacotePacotes 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êinerA 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çãoO 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 #

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

  2. 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 Comando
    localtonet --authtoken <YOUR_TOKEN>

    macOS

    Bash
    brew tap localtonet/tap
    brew install localtonet
    localtonet --authtoken <YOUR_TOKEN>

    Linux

    Bash
    curl -fsSL https://localtonet.com/install.sh | sh
    localtonet --authtoken <YOUR_TOKEN>

    Docker

    Bash
    docker 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 pergunta Please Enter AuthToken or PIN.

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

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

    PlataformaComo
    Windowslocaltonet --install-service --authtoken <YOUR_TOKEN> em um terminal executado como Administrador
    macOS, Linuxsudo localtonet --install-service --authtoken <YOUR_TOKEN>
    Pacotes DEB, RPM e OpenWrtO pacote contém o serviço. Você o habilita depois de definir o token.
    AndroidO 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.

Guias de instalação #

Suporte