Executar o Localtonet como serviço
Nesta página 8 seções
Instale o cliente Localtonet como um serviço em segundo plano para que ele inicie junto com o dispositivo, continue em execução depois que você sair da conta e não precise de um terminal aberto. Um único comando o registra nos serviços do Windows, no launchd do macOS ou no systemd do Linux.
Antes de começar #
- O cliente de console está instalado no dispositivo: Windows, macOS ou Linux.
- Um AuthToken para este dispositivo, de Meus tokens.
- Direitos de administrador: um terminal aberto com Executar como administrador no Windows,
sudono macOS e no Linux. - No Linux, uma distribuição que use systemd. O Termux não é compatível; use o app Android nele.
Instalou a partir de um pacote DEB ou RPM, no OpenWrt ou no Docker? Eles vêm com uma forma própria de iniciar com o sistema. Veja Pacotes DEB e RPM, OpenWrt e Docker em vez desta página.
Instale o serviço #
Execute o cliente uma vez com --install-service e o seu token. Substitua <YOUR_TOKEN> pelo seu AuthToken. Sempre inclua --authtoken neste comando: o serviço se conecta com o token com o qual você o instala.
Windows #
Abra o Prompt de Comando ou o PowerShell como Administrador na pasta que contém o localtonet e execute:
localtonet --install-service --authtoken <YOUR_TOKEN>O cliente cria um serviço do Windows com início automático e o inicia. O serviço aparece em services.msc com a descrição Localtonet Service. Se o serviço falhar, o Windows o reinicia após um minuto.
macOS
sudo localtonet --install-service --authtoken <YOUR_TOKEN>O cliente grava um job do launchd em /Library/LaunchDaemons/<SERVICE_NAME>.plist, carrega-o e o inicia. O job inicia junto com o sistema, e o launchd o inicia de novo se ele terminar com um erro.
Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>O cliente grava uma unit do systemd em /etc/systemd/system/<SERVICE_NAME>.service, habilita-a e a inicia. A unit inicia junto com o sistema, e o systemd a reinicia cinco segundos após uma falha.
Se o sudo não encontrar o localtonet, execute-o com o caminho dele, por exemplo sudo ./localtonet na pasta que o contém.
Em caso de sucesso, o cliente imprime o nome do serviço:
[CLI] Installed service 'Localtonet_AbCdEfGhI'A instalação também inicia o serviço, então nenhum comando de início separado é necessário. Agora você já pode criar e iniciar túneis para este token no painel.
O nome do serviço #
O serviço se chama Localtonet_ seguido dos nove primeiros caracteres do token, por exemplo Localtonet_AbCdEfGhI. Esta página escreve <SERVICE_NAME> para ele. Como o nome vem do token, você pode instalar um serviço por token no mesmo dispositivo, e todo comando de gerenciamento precisa do mesmo token para encontrar o serviço dele.
O que o serviço executa #
O serviço inicia o mesmo arquivo localtonet no mesmo local, com as opções que você deu no comando de instalação. Duas coisas decorrem disso:
- Não mova nem exclua o arquivo. A definição do serviço contém o caminho completo dele. No Linux, se o arquivo estiver dentro de
/root, o instalador o copia para/usr/local/lib/<SERVICE_NAME>/e o serviço executa essa cópia. - As outras opções são mantidas. Opções como
--nete--ipou--proxy envno comando de instalação são armazenadas no serviço e usadas em toda inicialização. Veja a Referência da CLI.
Gerencie o serviço #
Use o mesmo token com uma destas opções. No macOS e no Linux, coloque sudo na frente. No Windows, use um terminal de Administrador para tudo, exceto o status.
| Comando | O que faz | Saída em caso de sucesso |
|---|---|---|
localtonet --status-service --authtoken <YOUR_TOKEN> | Mostra o estado do serviço. | [CLI] Service '<SERVICE_NAME>' status: Running |
localtonet --stop-service --authtoken <YOUR_TOKEN> | Para o serviço. Os túneis dele ficam offline. Ele inicia de novo na próxima inicialização do sistema. | [CLI] Stopped service '<SERVICE_NAME>'. |
localtonet --start-service --authtoken <YOUR_TOKEN> | Inicia um serviço parado. | [CLI] Started service '<SERVICE_NAME>'. |
localtonet --remove-service --authtoken <YOUR_TOKEN> | Para o serviço e remove o registro dele. O arquivo localtonet em si permanece. | [CLI] Removed service '<SERVICE_NAME>'. |
O status é um destes valores:
| Status | Significado |
|---|---|
Running | O serviço está em execução. |
Stopped | O serviço está instalado, mas não está em execução. |
Installing | O serviço está iniciando. |
NotFound | Nenhum serviço está instalado para este token. |
Paused | Somente no Windows: o serviço foi pausado. |
Error | O serviço falhou, ou o estado dele não pôde ser lido. |
Unknown | O gerenciador de serviços devolveu um estado que o cliente não reconhece. |
Você também pode usar as ferramentas do sistema operacional com o nome do serviço:
Windows #
Abra o services.msc e procure <SERVICE_NAME>, ou use o sc em um terminal de Administrador:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>Onde o serviço é registrado e onde ficam os logs dele #
| Sistema | Registro | Logs |
|---|---|---|
| Windows | Um serviço do Windows chamado <SERVICE_NAME>, com tipo de início automático, em execução na conta LocalSystem. | O serviço não tem janela de console e o instalador não configura nenhum arquivo de log. Verifique o estado do serviço e o dispositivo e os túneis dele no painel. |
| macOS | /Library/LaunchDaemons/<SERVICE_NAME>.plist, um job do launchd para todo o sistema. | /var/log/<SERVICE_NAME>.out.log e /var/log/<SERVICE_NAME>.err.log |
| Linux | /etc/systemd/system/<SERVICE_NAME>.service, habilitada para multi-user.target. | O journal do systemd: journalctl -u <SERVICE_NAME> -f |
O serviço não imprime a tabela de túneis que o cliente mostra em um terminal. Para o estado do seu dispositivo e dos túneis dele, use o painel.
Altere o token #
Para mudar o token de um dispositivo, remova o serviço com o token antigo e instale-o de novo com o novo:
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>O que você precisa saber #
- Um cliente por token. Enquanto o serviço está em execução, não inicie outro cliente Localtonet com o mesmo token, neste dispositivo ou em outro. Um segundo cliente que se conecta com um token desconecta o primeiro.
- Atualizar o cliente. O serviço continua executando o arquivo para o qual a definição dele aponta. Pare o serviço, substitua esse arquivo pela nova versão e inicie o serviço de novo.
- As senhas de proxy não são armazenadas. O comando de instalação recusa uma URL de proxy que contém uma senha e a opção
--proxy-user. Instale com--proxy enve defina as variáveis de proxy no ambiente do serviço. - Terminal de dispositivo. Se o dispositivo executa o Localtonet como serviço, execute
localtonet --terminal enableem um terminal de Administrador ou comsudo, para que o serviço possa usar o resultado. Veja Terminal de dispositivo.
Solução de problemas #
| Mensagem | Causa e correção |
|---|---|
[CLI] Install failed: '…' requires elevated (admin/root) privileges. | O comando foi executado sem direitos de administrador. Abra o terminal como Administrador no Windows ou use sudo no macOS e no Linux. No Windows e no Linux, a mesma mensagem aparece para iniciar, parar e remover. |
[CLI] Install failed: seguido de Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) ou Plist already exists for … (macOS) | Um serviço para este token já está instalado. Use --start-service para iniciá-lo, ou --remove-service primeiro se quiser instalá-lo de novo. |
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment. | O comando de instalação continha --proxy-user ou uma URL de proxy com senha. Use --proxy env no lugar. |
[CLI] Start failed: … no Windows logo após a instalação | O serviço já está em execução, porque a instalação o inicia. Verifique com --status-service. |
O status é NotFound | Não existe serviço para o token que você passou. Verifique se é o token com o qual você instalou o serviço. |
O status é Running, mas o dispositivo está offline no painel | Verifique o token: copie-o de novo em Meus tokens, remova o serviço e instale-o de novo. Verifique também se nenhum outro cliente usa o mesmo token. |