Ir para o conteúdo
Localtonet Localtonet Painel

Instale o Localtonet por um pacote DEB ou RPM

Ajuda com esta página
Nesta página 9 seções
  1. Antes de começar
  2. O que o pacote instala
  3. Passos
  4. Baixe e instale o pacote
  5. Defina o seu AuthToken
  6. Verifique a configuração
  7. Ative um serviço
  8. Inicie um túnel
  9. Serviço de túneis ou serviço de VPN
  10. Como os serviços rodam
  11. Leia o log
  12. Atualização
  13. Remoção
  14. Solução de problemas
  15. Páginas relacionadas

Os pacotes DEB e RPM instalam o cliente Localtonet junto com dois serviços systemd, um para túneis e outro para túneis mais VPN. Os serviços leem o seu AuthToken de um arquivo e rodam sem terminal, então o cliente inicia a cada boot.

Antes de começar #

  • Um sistema Linux de 64 bits: os pacotes existem para x64 e ARM64.
  • systemd 247 ou mais recente e OpenSSL 3, como Debian 12, Ubuntu 22.04+ ou RHEL 9.
  • Acesso root (sudo).
  • Seu AuthToken. Selecione Copiar no cartão AuthToken do Painel ou copie um token de Meus tokens.

Em outras distribuições, em ARM de 32 bits ou quando você não quer um pacote de sistema, use o script de instalação ou os arquivos compactados descritos em Linux.

O que o pacote instala #

CaminhoO que é
/usr/bin/localtonetO comando localtonet.
/usr/lib/localtonet/O próprio cliente.
/usr/lib/systemd/system/localtonet.serviceO serviço de túneis.
/usr/lib/systemd/system/localtonet-vpn.serviceO serviço de VPN e túneis.
/etc/localtonet/auth-tokenO arquivo do token. Somente o root pode lê-lo. Ele é instalado com o marcador DUMMY_AUTH_TOKEN.

O pacote se chama localtonet. Suas dependências, entre elas OpenSSL 3, iproute2 (iproute no RPM), iptables e kmod, são instaladas pelo seu gerenciador de pacotes. Instalar o pacote não ativa nem inicia um serviço: você define o token primeiro e depois ativa o serviço de que precisa.

Passos #

  1. Baixe e instale o pacote #

    Escolha o pacote da sua distribuição e CPU na lista no fim desta página e instale o arquivo baixado com apt (DEB) ou dnf (RPM). Instruções de configuração, sob cada pacote, mostra os comandos exatos para aquele arquivo.

  2. Defina o seu AuthToken #

    Edite /etc/localtonet/auth-token como root com um editor de texto e substitua DUMMY_AUTH_TOKEN pelo seu token, em uma única linha. Depois, garanta que somente o root possa ler o arquivo:

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. Verifique a configuração #

    Terminal
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    A verificação lê o arquivo do token sem se conectar. Ela responde Localtonet headless configuration OK. quando o arquivo contém um token de 33 caracteres sem espaços. Ela não pergunta aos servidores da Localtonet se o token é válido para a sua conta.

  4. Ative um serviço #

    Para túneis, ative o serviço de túneis e leia o log dele:

    Terminal
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Se este dispositivo também participa de uma rede VPN, ative o serviço de VPN no lugar. Veja Serviço de túneis ou serviço de VPN.

  5. Inicie um túnel #

    O token agora aparece como Online em Meus tokens. Crie e inicie um túnel para ele no painel, veja Início rápido.

Serviço de túneis ou serviço de VPN #

Os dois serviços executam o mesmo cliente e os dois atendem os seus túneis. Eles diferem nos direitos com que rodam. Ative um deles: os dois serviços entram em conflito, e iniciar um interrompe o outro.

localtonet.servicelocaltonet-vpn.service
Use paraTúneisVPN e túneis
Roda comoUm usuário sem privilégios que o systemd cria para o serviçoroot, limitado às capacidades de rede CAP_NET_ADMIN e CAP_NET_RAW
Módulo TUNNão é usadoCarregado com modprobe tun antes de o cliente iniciar
Diretório de trabalho/var/lib/localtonet/var/lib/localtonet-vpn

Para trocar um dispositivo do serviço de túneis para o serviço de VPN:

Terminal
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

Para voltar, desative localtonet-vpn.service e ative localtonet.service da mesma forma. As redes VPN em si são configuradas no painel, veja Gerenciador de VPN.

Como os serviços rodam #

ComportamentoDetalhes
Modo headlessOs dois serviços iniciam localtonet --headless. Nesse modo, o cliente nunca faz perguntas e não guarda o token nas próprias configurações.
TokenO systemd passa /etc/localtonet/auth-token ao serviço. Um serviço não inicia enquanto o arquivo estiver ausente.
Início no bootUm serviço ativado inicia depois que a rede está no ar.
ReinícioO systemd reinicia o cliente dez segundos depois de uma falha. Ele não o reinicia quando o cliente para por causa de um arquivo de token inválido. Corrija o arquivo e reinicie o serviço você mesmo.

Leia o log #

No modo headless, o cliente escreve linhas simples no journal, uma por alteração:

Terminal
sudo journalctl -u localtonet.service -f
LinhaSignificado
Connection: ConnectedO estado da sessão. Os outros valores são Connecting e Disconnected.
AuthTokenName: …O nome do token com o qual o cliente entrou.
OPEN …, ADDED …Um túnel que roda neste dispositivo, com seu endereço público, protocolo e destino local.
STATUS …Um túnel mudou de status.
CLOSED …Um túnel foi parado ou removido.
Authentication failed: AuthToken was rejected.O token no arquivo não é aceito. Copie-o de novo em Meus tokens.

Se uma dessas linhas fosse conter o token, o cliente escreve [redacted] no lugar dele.

Atualização #

Baixe o novo pacote e instale-o da mesma forma que da primeira vez e depois reinicie o serviço que você usa. O seu arquivo de token é preservado.

Serviço de túneis
sudo systemctl restart localtonet
Serviço de VPN
sudo systemctl restart localtonet-vpn.service

Em Meus tokens, a coluna Cliente mostra a versão que o dispositivo informou por último e um selo Requer atualização quando há uma mais nova disponível.

Remoção #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

Remover o pacote para e desativa os dois serviços. O arquivo do token é um arquivo de configuração, e os gerenciadores de pacotes os tratam com cuidado: depois da remoção, verifique se /etc/localtonet/auth-token ou uma cópia salva dele ainda está lá e exclua-o se você não quer que o token fique na máquina.

Solução de problemas #

Invalid Localtonet headless configuration. Check the token file or environment settings.

O arquivo do token não é utilizável. Verifique se /etc/localtonet/auth-token existe, se o marcador DUMMY_AUTH_TOKEN foi removido e se o arquivo contém apenas o token de 33 caracteres, sem espaços e em uma única linha. Execute a verificação com sudo, porque somente o root pode ler o arquivo.

O serviço está ativado, mas não roda

Execute systemctl status localtonet.service. Um serviço não inicia enquanto /etc/localtonet/auth-token estiver ausente, e não é reiniciado depois de parar por causa de um arquivo de token inválido. Corrija o arquivo, execute a verificação da configuração e depois execute sudo systemctl restart localtonet.service.

O log diz: Authentication failed: AuthToken was rejected.

O arquivo tem o formato certo, mas o token não é aceito. Copie o token de novo em Meus tokens, salve-o no arquivo do token e reinicie o serviço.

O serviço de túneis parou quando iniciei o serviço de VPN

Isso é intencional. Os dois serviços entram em conflito, então o systemd interrompe um quando o outro inicia. O serviço de VPN também atende os seus túneis.

O pacote não instala na minha distribuição

Os pacotes exigem systemd 247 ou mais recente e OpenSSL 3. Em versões mais antigas, o gerenciador de pacotes não consegue satisfazer essas dependências. Use o script de instalação ou um arquivo compactado da página Linux.

Os pacotes estão listados abaixo. Selecione Instruções de configuração sob um pacote para ver os comandos com o nome do arquivo dele.

Pacotes Linux

Pacotes DEB e RPM instaláveis para x64 e ARM64. Exige systemd 247 ou mais recente e OpenSSL 3, como Debian 12, Ubuntu 22.04+ ou RHEL 9.

  • Debian / Ubuntu · x64
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-linux-x64.deb.

    sudo apt install ./localtonet-linux-x64.deb

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Inicie o serviço. Quando a verificação da configuração passar:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para usar VPN, mude para o serviço de VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Para atualizar, instale o novo pacote e execute sudo systemctl restart localtonet. Sua configuração é mantida.

    Se você usa VPN, reinicie o localtonet-vpn.service em vez disso.

  • Debian / Ubuntu · ARM64
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-linux-arm64.deb.

    sudo apt install ./localtonet-linux-arm64.deb

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Inicie o serviço. Quando a verificação da configuração passar:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para usar VPN, mude para o serviço de VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Para atualizar, instale o novo pacote e execute sudo systemctl restart localtonet. Sua configuração é mantida.

    Se você usa VPN, reinicie o localtonet-vpn.service em vez disso.

  • Fedora / RHEL · x64
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-linux-x64.rpm.

    sudo dnf install ./localtonet-linux-x64.rpm

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Inicie o serviço. Quando a verificação da configuração passar:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para usar VPN, mude para o serviço de VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Para atualizar, instale o novo pacote e execute sudo systemctl restart localtonet. Sua configuração é mantida.

    Se você usa VPN, reinicie o localtonet-vpn.service em vez disso.

  • Fedora / RHEL · ARM64
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-linux-arm64.rpm.

    sudo dnf install ./localtonet-linux-arm64.rpm

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Inicie o serviço. Quando a verificação da configuração passar:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para usar VPN, mude para o serviço de VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Para atualizar, instale o novo pacote e execute sudo systemctl restart localtonet. Sua configuração é mantida.

    Se você usa VPN, reinicie o localtonet-vpn.service em vez disso.

Suporte