Ir para o conteúdo
Localtonet Localtonet Painel

Instalar a Localtonet no macOS

Ajuda com esta página
Nesta página 9 seções
  1. Antes de começar
  2. Instalar com o Homebrew
  3. Adicione o tap da Localtonet e instale
  4. Confira a instalação
  5. Instalar manualmente
  6. Baixe e extraia
  7. Opcional: mova-o para o seu PATH
  8. Inicie o cliente
  9. Inicie com o seu token
  10. Verifique a sessão
  11. Executar como um serviço launchd
  12. Instale o serviço
  13. Confirme que ele está em execução
  14. O que a instalação cria
  15. Comandos de serviço
  16. Atualizar
  17. Desinstalar
  18. Solução de problemas
  19. Páginas relacionadas

No macOS, o cliente Localtonet é um programa de console para Macs Intel e Apple Silicon. Instale-o com o Homebrew ou a partir de um arquivo ZIP, inicie-o com o seu AuthToken e instale-o como um serviço launchd se ele deve iniciar a cada boot.

Antes de começar #

  • Uma conta Localtonet. Crie uma gratuitamente se você não tiver.
  • Seu AuthToken. Selecione Copiar no cartão AuthToken do Painel ou copie um token de Meus tokens.
  • Para a instalação com o Homebrew: Homebrew.
  • Para o serviço launchd: uma conta que possa usar sudo.

Instalar com o Homebrew #

  1. Adicione o tap da Localtonet e instale #

    Um tap adiciona ao Homebrew um repositório de terceiros, para que você possa instalar e atualizar fórmulas dele.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. Confira a instalação #

    Terminal
    localtonet --version

    O comando exibe a versão do cliente.

Instalar manualmente #

Se você prefere um download direto, pegue o arquivo para o seu Mac. O ZIP contém um único arquivo, localtonet.

MacArquivo
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Baixe e extraia #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip
    unzip localtonet-osx-64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Opcional: mova-o para o seu PATH #

    Sem este passo, você inicia o cliente pelo caminho dele, ~/localtonet/localtonet. Depois dele, você pode digitar localtonet em qualquer pasta.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Inicie o cliente #

  1. Inicie com o seu token #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    O cliente armazena o token localmente. Da próxima vez, você pode iniciá-lo apenas com localtonet. Se você o iniciar sem um token armazenado, ele pergunta Please Enter AuthToken or PIN.

  2. Verifique a sessão #

    O terminal mostra Session Status: Connected acima de uma tabela com uma linha por túnel em execução: IP/Url, Protocol, Client IP, Client Port, Ping e Status. 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 armazenado e sair.

Executar como um serviço launchd #

Um serviço inicia a Localtonet a cada boot, a mantém em execução depois que você sai da sessão e não precisa de um terminal aberto. Os comandos do serviço precisam de root, então execute-os com sudo.

  1. Instale o serviço #

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    O comando registra um job launchd para todo o sistema para este token e o inicia imediatamente. Ele responde com o nome do job:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> são os primeiros 9 caracteres do seu token. Cada token tem o próprio job, então os outros comandos do serviço precisam do mesmo --authtoken para encontrá-lo.

  2. Confirme que ele está em execução #

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Um job em execução responde [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. No painel, o token aparece como Online em Meus tokens.

O que a instalação cria #

ItemLocal
Definição do job do launchd/Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist
Saída padrão do cliente/var/log/Localtonet_<TOKEN_PREFIX>.out.log
Saída de erro do cliente/var/log/Localtonet_<TOKEN_PREFIX>.err.log

O job inicia quando o Mac dá boot, e o launchd inicia o cliente de novo quando ele sai com erro. O job executa o arquivo localtonet a partir do caminho que ele tinha quando você instalou o serviço, com o token como parte dos argumentos.

Comandos de serviço #

Execute cada comando com sudo e adicione --authtoken <YOUR_TOKEN>.

ComandoO que faz
--install-serviceGrava a definição do job, carrega-o e inicia o cliente.
--start-serviceInicia o job. Se ele já estiver em execução, o launchd o reinicia.
--stop-servicePara o cliente. O job continua instalado e inicia de novo no próximo boot.
--status-serviceExibe o estado, por exemplo Running, Stopped, NotFound ou Error.
--remove-servicePara o job, descarrega-o e exclui a definição do job.

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.

Atualizar #

  • Homebrew: brew upgrade localtonet
  • Instalação manual: baixe o arquivo atual e substitua o arquivo localtonet.

Se a Localtonet roda como serviço, instale o serviço de novo depois de uma atualização do Homebrew: remova-o e depois instale-o com o mesmo token. Instalar também o inicia.

Terminal
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

O job mantém o caminho do arquivo a partir do qual foi instalado. Depois de uma atualização manual que deixa o cliente no mesmo lugar, basta parar o serviço com --stop-service, substituir o arquivo e iniciar o serviço com --start-service. Executar como serviço descreve esses comandos.

Desinstalar #

  1. Se você instalou o serviço, remova-o: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Para remover o token armazenado, inicie o cliente e pressione F12.
  3. Remova o cliente. Com o Homebrew: brew uninstall localtonet e brew untap localtonet/tap para remover o tap. Depois de uma instalação manual, exclua o arquivo localtonet.

Solução de problemas #

Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.

O comando foi executado sem root. Repita-o com sudo.

sudo: localtonet: command not found

O sudo não encontra o cliente no próprio caminho de busca. Informe o caminho completo. command -v localtonet o exibe, por exemplo:

Bash
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>

Depois de uma instalação manual sem o passo do PATH, o caminho é ~/localtonet/localtonet.

Install failed: Plist already exists for 'Localtonet_…'

Um serviço para este token já está instalado. Verifique-o com --status-service. Para instalá-lo de novo, execute antes --remove-service.

O serviço está instalado, mas o token continua Offline

Leia o log de erros do job, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, e verifique se o arquivo localtonet ainda existe no caminho que tinha quando você instalou o serviço.

Wrong Token!

O cliente espera o AuthToken de 33 caracteres de Meus tokens ou um PIN de 6 dígitos que não tenha expirado. Copie o token de novo e informe-o no prompt.

This token is used in another localtonet application!

Outro cliente Localtonet neste Mac já está em execução com o mesmo token. Feche-o ou inicie este com outro token. Use um cliente em execução por token.

Suporte