Ir para o conteúdo
Localtonet Localtonet Painel

Instalar o Localtonet no Linux

Ajuda com esta página
Nesta página 9 seções
  1. Antes de começar
  2. Instalar com o script
  3. Execute o script de instalação
  4. Confira a instalação
  5. Instalar manualmente
  6. Baixe e extraia
  7. Opcional: mova-o para o seu PATH
  8. Inicie o cliente
  9. Inicie com o seu token
  10. Verifique a sessão
  11. Executar como serviço systemd
  12. Instale o serviço
  13. Confirme que ele está em execução
  14. Comandos de serviço
  15. A unit e seus logs
  16. Atualizar versão
  17. Substitua o cliente
  18. Reinicie o serviço
  19. Desinstalar
  20. Solução de problemas
  21. Páginas relacionadas

No Linux, o cliente Localtonet é um único programa de console. Instale-o com o script de instalação ou a partir de um arquivo ZIP, inicie-o com o seu AuthToken e instale-o como um serviço systemd se ele deve iniciar a cada reinicialização.

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.
  • curl ou wget, e unzip.
  • Para o serviço systemd: acesso root e uma distribuição que use systemd.

Outras formas de executar o Localtonet no Linux. No Debian, Ubuntu, Fedora e RHEL, você pode instalar um pacote DEB ou RPM que traz seus próprios serviços. Há guias separados para Docker, roteadores OpenWrt e Termux no Android.

Instalar com o script #

  1. Execute o script de instalação #

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh

    O script detecta a sua CPU (x64, ARM64 ou ARM) e se o sistema usa glibc ou musl, baixa a versão correspondente e a instala em /usr/local/bin/localtonet. Ele também cria o link /usr/bin/localtonet, para que sudo localtonet funcione em distribuições nas quais o sudo não procura em /usr/local/bin.

    O script usa sudo quando o seu usuário não pode gravar na pasta de instalação, e por isso ele pode pedir a sua senha. Se o unzip estiver ausente, ele tenta instalá-lo com o gerenciador de pacotes da sua distribuição.

  2. Confira a instalação #

    O script termina mostrando a versão instalada. Você pode mostrá-la de novo a qualquer momento:

    Terminal
    localtonet --version

Instalar manualmente #

Se preferir um download direto, pegue o arquivo para o seu sistema. Cada ZIP contém um único arquivo, localtonet.

uname -m mostra o tipo da sua CPU: x86_64 é x64, aarch64 é ARM64 e armv7l é ARM.

  1. Baixe e extraia #

    O exemplo usa a versão x64 com glibc. Substitua o nome do arquivo pelo do arquivo correspondente ao seu sistema.

    Terminal
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Opcional: mova-o para o seu PATH #

    Sem este passo, você inicia o cliente pelo caminho dele, ~/localtonet/localtonet. Depois dele, você pode digitar localtonet em qualquer pasta.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Inicie o cliente #

  1. Inicie com o seu token #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    O cliente guarda o token localmente para o seu usuário. 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.

  2. Verifique a sessão #

    O terminal 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; veja o Início rápido.

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

Quando a saída não é um terminal, por exemplo quando você a redireciona para um arquivo, o cliente escreve uma linha simples a cada alteração em vez da tabela.

A VPN precisa de root. Se o dispositivo faz parte de uma rede do Gerenciador de VPN e o cliente roda sem root, a linha VPN da tabela mostra Admin rights required. Nesse caso, inicie o cliente com sudo ou como um serviço.

Executar como serviço systemd #

Um serviço inicia o Localtonet a cada reinicialização, o mantém em execução depois que você faz logout e não precisa de um terminal aberto. Os comandos de serviço precisam de root.

  1. Instale o serviço #

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    O comando grava uma unit do systemd para este token, a habilita e a inicia na hora. Ele responde com o nome da unit:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

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

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

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Um serviço em execução responde [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. No painel, o token aparece como Online em Meus tokens.

Comandos de serviço #

Execute cada comando com sudo e adicione --authtoken <YOUR_TOKEN>.

ComandoO que faz
--install-serviceGrava o arquivo da unit, habilita a unit e a inicia.
--start-serviceInicia a unit, por exemplo depois de você tê-la parado.
--stop-servicePara a unit. Ela continua habilitada e inicia de novo após uma reinicialização.
--status-serviceMostra o estado, por exemplo Running, Stopped ou Error quando a unit falhou.
--remove-servicePara e desabilita a unit e exclui o arquivo da unit.

O serviço é instalado com as opções que você passa junto com --install-service. As opções estão listadas na Referência da CLI.

A unit e seus logs #

O arquivo da unit é /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. O systemd reinicia o cliente cinco segundos após uma falha. Como é uma unit normal do systemd, você também pode gerenciá-la com systemctl e ler a saída dela com journalctl:

Terminal
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

A unit inicia o arquivo localtonet a partir do caminho que ele tinha quando você instalou o serviço. Há uma exceção: se esse caminho estiver dentro de /root/, o comando de instalação copia o arquivo para /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ e o serviço executa a cópia.

Atualizar versão #

  1. Substitua o cliente #

    Execute o script de instalação de novo. É seguro executá-lo outra vez, e ele sobrescreve o cliente instalado com a versão atual. Após uma instalação manual, baixe o arquivo atual e substitua o arquivo localtonet.

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Reinicie o serviço #

    Um serviço em execução continua usando a versão antiga até ser reiniciado.

    Terminal
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    Se o serviço executa uma cópia dentro de /usr/local/lib/, remova o serviço e instale-o de novo com o novo cliente.

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: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Para remover o token guardado, inicie o cliente e pressione F12.
  3. Exclua o cliente: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet após a instalação pelo script, ou a pasta em que você extraiu o arquivo.

Solução de problemas #

Script de instalação: Unsupported architecture

O script tem versões para x64 (x86_64), ARM64 (aarch64) e ARM de 32 bits (armv7l). Outros tipos de CPU não são compatíveis com as versões para Linux.

Script de instalação: Neither curl nor wget found

Instale curl ou wget com o seu gerenciador de pacotes e execute o script de novo.

Script de instalação: Failed to install 'unzip'

O script não conseguiu instalar o unzip sozinho. Instale-o com o seu gerenciador de pacotes e execute o script de novo.

Installed but not found in PATH

Abra um novo shell ou inicie o cliente pelo caminho completo, /usr/local/bin/localtonet.

sudo: localtonet: command not found

Após uma instalação manual, o cliente não está no caminho de busca do sudo. Use o caminho completo, por exemplo sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, ou mova primeiro o arquivo para /usr/local/bin.

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

O comando foi executado sem root. Repita-o com sudo. O mesmo vale para --start-service, --stop-service e --remove-service.

Install failed: Systemd unit already exists for 'Localtonet_…'

Já existe um serviço instalado para este token. Verifique-o com --status-service. Para instalá-lo de novo, execute primeiro --remove-service.

Os comandos de serviço falham em um sistema sem systemd

O modo de serviço usa o systemd. Em sistemas sem ele, inicie o cliente de outra forma, por exemplo em um contêiner Docker. O cliente de console tem um modo headless para isso: --headless executa sem prompts e lê o token de um arquivo indicado com --authtoken-file. 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!

Outro cliente Localtonet nesta máquina já está em execução com o mesmo token. Feche-o ou inicie este com um token diferente. Use um cliente em execução por token.

Suporte