Instalar a Localtonet no macOS
Nesta página 9 seções
- Antes de começar
- Instalar com o Homebrew
- Adicione o tap da Localtonet e instale
- 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 um serviço launchd
- Instale o serviço
- Confirme que ele está em execução
- O que a instalação cria
- Comandos de serviço
- Atualizar
- Desinstalar
- Solução de problemas
- 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 #
-
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.
Terminalbrew tap localtonet/tap brew install localtonet -
Confira a instalação #
Terminallocaltonet --versionO 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.
| Mac | Arquivo |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Baixe e extraia #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -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 -
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 armazena o token localmente. Da próxima vez, você pode iniciá-lo apenas com
localtonet. Se você o iniciar sem um token armazenado, ele perguntaPlease Enter AuthToken or PIN. -
Verifique a sessão #
O terminal mostra
Session Status: Connectedacima de uma tabela com uma linha por 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 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.
-
Instale o serviço #
Terminalsudo 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--authtokenpara encontrá-lo. -
Confirme que ele está em execução #
Terminalsudo 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 #
| Item | Local |
|---|---|
| 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>.
| Comando | O que faz |
|---|---|
--install-service | Grava a definição do job, carrega-o e inicia o cliente. |
--start-service | Inicia o job. Se ele já estiver em execução, o launchd o reinicia. |
--stop-service | Para o cliente. O job continua instalado e inicia de novo no próximo boot. |
--status-service | Exibe o estado, por exemplo Running, Stopped, NotFound ou Error. |
--remove-service | Para 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.
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 #
- Se você instalou o serviço, remova-o:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Para remover o token armazenado, inicie o cliente e pressione F12.
- Remova o cliente. Com o Homebrew:
brew uninstall localtonetebrew untap localtonet/tappara remover o tap. Depois de uma instalação manual, exclua o arquivolocaltonet.
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:
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.