Instalar o Localtonet no Linux
Nesta página 9 seções
- Antes de começar
- Instalar com o script
- Execute o script de instalação
- Confira a instalação
- Instalar manualmente
- Baixe e extraia
- Opcional: mova-o para o seu PATH
- Inicie o cliente
- Inicie com o seu token
- Verifique a sessão
- Executar como serviço systemd
- Instale o serviço
- Confirme que ele está em execução
- Comandos de serviço
- A unit e seus logs
- Atualizar versão
- Substitua o cliente
- Reinicie o serviço
- Desinstalar
- Solução de problemas
- 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.
curlouwget, eunzip.- 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 #
-
Execute o script de instalação #
Terminalcurl -fsSL https://localtonet.com/install.sh | shO 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 quesudo localtonetfuncione em distribuições nas quais osudonão procura em/usr/local/bin.O script usa
sudoquando o seu usuário não pode gravar na pasta de instalação, e por isso ele pode pedir a sua senha. Se ounzipestiver ausente, ele tenta instalá-lo com o gerenciador de pacotes da sua distribuição. -
Confira a instalação #
O script termina mostrando a versão instalada. Você pode mostrá-la de novo a qualquer momento:
Terminallocaltonet --version
Instalar manualmente #
Se preferir um download direto, pegue o arquivo para o seu sistema. Cada ZIP contém um único arquivo, localtonet.
| CPU | glibc (Debian, Ubuntu, Fedora, RHEL e a maioria das outras) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32 bits) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m mostra o tipo da sua CPU: x86_64 é x64, aarch64 é ARM64 e armv7l é ARM.
-
Baixe e extraia #
O exemplo usa a versão x64 com glibc. Substitua o nome do arquivo pelo do arquivo correspondente ao seu sistema.
Terminalwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Opcional: mova-o para o seu PATH #
Sem este passo, você inicia o cliente pelo caminho dele,
~/localtonet/localtonet. Depois dele, você pode digitarlocaltonetem qualquer pasta.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Inicie o cliente #
-
Inicie com o seu token #
Terminallocaltonet --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 perguntaPlease Enter AuthToken or PIN. -
Verifique a sessão #
O terminal mostra
Session Status: Connectedacima de uma tabela com uma linha para cada túnel em execução:IP/Url,Protocol,Client IP,Client Port,PingeStatus. 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.
-
Instale o serviço #
Terminalsudo 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--authtokenpara encontrá-la. -
Confirme que ele está em execução #
Terminalsudo 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>.
| Comando | O que faz |
|---|---|
--install-service | Grava o arquivo da unit, habilita a unit e a inicia. |
--start-service | Inicia a unit, por exemplo depois de você tê-la parado. |
--stop-service | Para a unit. Ela continua habilitada e inicia de novo após uma reinicialização. |
--status-service | Mostra o estado, por exemplo Running, Stopped ou Error quando a unit falhou. |
--remove-service | Para 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:
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fA 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 #
-
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.Terminalcurl -fsSL https://localtonet.com/install.sh | sh -
Reinicie o serviço #
Um serviço em execução continua usando a versão antiga até ser reiniciado.
Terminalsudo 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 #
- Se você instalou o serviço, remova-o:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Para remover o token guardado, inicie o cliente e pressione F12.
- Exclua o cliente:
sudo rm /usr/local/bin/localtonet /usr/bin/localtonetapó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.