Ir para o conteúdo
Localtonet Localtonet Painel

Executar o Localtonet como serviço

Ajuda com esta página
Nesta página 8 seções
  1. Antes de começar
  2. Instale o serviço
  3. Windows
  4. O nome do serviço
  5. O que o serviço executa
  6. Gerencie o serviço
  7. Windows
  8. Onde o serviço é registrado e onde ficam os logs dele
  9. Altere o token
  10. O que você precisa saber
  11. Solução de problemas
  12. Páginas relacionadas

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, sudo no 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:

Prompt de Comando ou PowerShell (Administrador)
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

Bash
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

Bash
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:

Saída
[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 --net e --ip ou --proxy env no 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.

ComandoO que fazSaí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:

StatusSignificado
RunningO serviço está em execução.
StoppedO serviço está instalado, mas não está em execução.
InstallingO serviço está iniciando.
NotFoundNenhum serviço está instalado para este token.
PausedSomente no Windows: o serviço foi pausado.
ErrorO serviço falhou, ou o estado dele não pôde ser lido.
UnknownO 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:

Prompt de Comando (Administrador)
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>

macOS

Bash
sudo launchctl print system/<SERVICE_NAME>

Linux

Bash
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>

Onde o serviço é registrado e onde ficam os logs dele #

SistemaRegistroLogs
WindowsUm 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:

Bash
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 env e 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 enable em um terminal de Administrador ou com sudo, para que o serviço possa usar o resultado. Veja Terminal de dispositivo.

Solução de problemas #

MensagemCausa 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çãoO serviço já está em execução, porque a instalação o inicia. Verifique com --status-service.
O status é NotFoundNã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 painelVerifique 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.
Suporte