Instale o Localtonet por um pacote DEB ou RPM
Nesta página 9 seções
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 #
| Caminho | O que é |
|---|---|
/usr/bin/localtonet | O comando localtonet. |
/usr/lib/localtonet/ | O próprio cliente. |
/usr/lib/systemd/system/localtonet.service | O serviço de túneis. |
/usr/lib/systemd/system/localtonet-vpn.service | O serviço de VPN e túneis. |
/etc/localtonet/auth-token | O 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 #
-
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) oudnf(RPM). Instruções de configuração, sob cada pacote, mostra os comandos exatos para aquele arquivo. -
Defina o seu AuthToken #
Edite
/etc/localtonet/auth-tokencomo root com um editor de texto e substituaDUMMY_AUTH_TOKENpelo seu token, em uma única linha. Depois, garanta que somente o root possa ler o arquivo:Terminalsudo chmod 600 /etc/localtonet/auth-token -
Verifique a configuração #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configA 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. -
Ative um serviço #
Para túneis, ative o serviço de túneis e leia o log dele:
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSe 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.
-
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.service | localtonet-vpn.service | |
|---|---|---|
| Use para | Túneis | VPN e túneis |
| Roda como | Um usuário sem privilégios que o systemd cria para o serviço | root, limitado às capacidades de rede CAP_NET_ADMIN e CAP_NET_RAW |
| Módulo TUN | Não é usado | Carregado 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:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.servicePara 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 #
| Comportamento | Detalhes |
|---|---|
| Modo headless | Os dois serviços iniciam localtonet --headless. Nesse modo, o cliente nunca faz perguntas e não guarda o token nas próprias configurações. |
| Token | O systemd passa /etc/localtonet/auth-token ao serviço. Um serviço não inicia enquanto o arquivo estiver ausente. |
| Início no boot | Um serviço ativado inicia depois que a rede está no ar. |
| Reinício | O 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:
sudo journalctl -u localtonet.service -f| Linha | Significado |
|---|---|
Connection: Connected | O 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.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceEm 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 #
sudo apt remove localtonetsudo dnf remove localtonetRemover 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.
Páginas relacionadas #
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.deb2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. Inicie o serviço. Quando a verificação da configuração passar:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara 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.servicePara atualizar, instale o novo pacote e execute
sudo systemctl restart localtonet. Sua configuração é mantida.Se você usa VPN, reinicie o
localtonet-vpn.serviceem 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.deb2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. Inicie o serviço. Quando a verificação da configuração passar:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara 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.servicePara atualizar, instale o novo pacote e execute
sudo systemctl restart localtonet. Sua configuração é mantida.Se você usa VPN, reinicie o
localtonet-vpn.serviceem 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.rpm2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. Inicie o serviço. Quando a verificação da configuração passar:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara 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.servicePara atualizar, instale o novo pacote e execute
sudo systemctl restart localtonet. Sua configuração é mantida.Se você usa VPN, reinicie o
localtonet-vpn.serviceem 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.rpm2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. Inicie o serviço. Quando a verificação da configuração passar:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara 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.servicePara atualizar, instale o novo pacote e execute
sudo systemctl restart localtonet. Sua configuração é mantida.Se você usa VPN, reinicie o
localtonet-vpn.serviceem vez disso.