Instala Localtonet en macOS
En esta página 9 secciones
- Antes de empezar
- Instala con Homebrew
- Añade el tap de Localtonet e instala
- Comprueba la instalación
- Instala manualmente
- Descarga y extrae
- Opcional: muévelo a tu PATH
- Inicia el cliente
- Inícialo con tu token
- Comprueba la sesión
- Ejecútalo como servicio de launchd
- Instala el servicio
- Comprueba que se ejecuta
- Qué crea la instalación
- Comandos de servicio
- Actualización
- Desinstalación
- Solución de problemas
- Páginas relacionadas
En macOS, el cliente de Localtonet es un programa de consola para Mac con Intel y con Apple Silicon. Instálalo con Homebrew o desde un archivo ZIP, inícialo con tu AuthToken e instálalo como servicio de launchd si debe iniciarse en cada arranque.
Antes de empezar #
- Una cuenta de Localtonet. Crea una gratis si no tienes una.
- Tu AuthToken. Selecciona Copiar en la tarjeta AuthToken del Panel, o copia un token de Mis tokens.
- Para la instalación con Homebrew: Homebrew.
- Para el servicio de launchd: una cuenta que pueda usar
sudo.
Instala con Homebrew #
-
Añade el tap de Localtonet e instala #
Un tap añade a Homebrew un repositorio de terceros, para que puedas instalar y actualizar fórmulas desde él.
Terminalbrew tap localtonet/tap brew install localtonet -
Comprueba la instalación #
Terminallocaltonet --versionEl comando muestra la versión del cliente.
Instala manualmente #
Si prefieres una descarga directa, toma el archivo para tu Mac. El ZIP contiene un solo archivo, localtonet.
| Mac | Archivo |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Descarga y extrae #
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: muévelo a tu PATH #
Sin este paso, inicias el cliente por su ruta,
~/localtonet/localtonet. Con él, puedes escribirlocaltoneten cualquier carpeta.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Inicia el cliente #
-
Inícialo con tu token #
Terminallocaltonet --authtoken <YOUR_TOKEN>El cliente guarda el token localmente. La próxima vez puedes iniciarlo solo con
localtonet. Si lo inicias sin un token guardado, preguntaPlease Enter AuthToken or PIN. -
Comprueba la sesión #
El terminal muestra
Session Status: Connectedsobre una tabla con una fila por cada túnel en ejecución:IP/Url,Protocol,Client IP,Client Port,PingyStatus. La tabla está vacía hasta que inicias un túnel en el panel; consulta la Guía de inicio rápido.Pulsa Ctrl + C para detener el cliente. Pulsa F12 para quitar el token guardado y salir.
Ejecútalo como servicio de launchd #
Un servicio inicia Localtonet en cada arranque, lo mantiene en ejecución después de cerrar sesión y no necesita un terminal abierto. Los comandos del servicio requieren root, así que ejecútalos con sudo.
-
Instala el servicio #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>El comando registra un trabajo de launchd para todo el sistema con este token y lo inicia de inmediato. Responde con el nombre del trabajo:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>son los primeros 9 caracteres de tu token. Cada token tiene su propio trabajo, así que los demás comandos del servicio necesitan el mismo--authtokenpara encontrarlo. -
Comprueba que se ejecuta #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Un trabajo en ejecución responde
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. En el panel, el token aparece como En línea en Mis tokens.
Qué crea la instalación #
| Elemento | Ubicación |
|---|---|
| Definición del trabajo de launchd | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| Salida estándar del cliente | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| Salida de error del cliente | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
El trabajo se inicia cuando arranca el Mac, y launchd vuelve a iniciar el cliente cuando termina con un error. El trabajo ejecuta el archivo localtonet desde la ruta que tenía cuando instalaste el servicio, con el token como parte de sus argumentos.
Comandos de servicio #
Ejecuta cada comando con sudo y añade --authtoken <YOUR_TOKEN>.
| Comando | Qué hace |
|---|---|
--install-service | Escribe la definición del trabajo, la carga e inicia el cliente. |
--start-service | Inicia el trabajo. Si ya está en ejecución, launchd lo reinicia. |
--stop-service | Detiene el cliente. El trabajo sigue instalado y se vuelve a iniciar en el próximo arranque. |
--status-service | Muestra el estado, por ejemplo Running, Stopped, NotFound o Error. |
--remove-service | Detiene el trabajo, lo descarga y elimina su definición. |
El servicio se instala con las opciones que pasas junto con --install-service. Las opciones figuran en la Referencia de la CLI.
Actualización #
- Homebrew:
brew upgrade localtonet - Instalación manual: descarga el archivo actual y reemplaza el archivo
localtonet.
Si Localtonet se ejecuta como servicio, vuelve a instalar el servicio tras una actualización con Homebrew: elimínalo y luego instálalo con el mismo token. Al instalarlo también se inicia.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>El trabajo conserva la ruta del archivo desde el que se instaló. Tras una actualización manual que deja el cliente en el mismo lugar, basta con detener el servicio con --stop-service, reemplazar el archivo e iniciar el servicio con --start-service. Ejecutar como servicio describe estos comandos.
Desinstalación #
- Si instalaste el servicio, elimínalo:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Para quitar el token guardado, inicia el cliente y pulsa F12.
- Elimina el cliente. Con Homebrew:
brew uninstall localtonetybrew untap localtonet/tappara quitar el tap. Tras una instalación manual, elimina el archivolocaltonet.
Solución de problemas #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
El comando se ejecutó sin root. Repítelo con sudo.
sudo: localtonet: command not found
sudo no encuentra el cliente en su propia ruta de búsqueda. Indica en su lugar la ruta completa. command -v localtonet la muestra, por ejemplo:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>Tras una instalación manual sin el paso de PATH, la ruta es ~/localtonet/localtonet.
Install failed: Plist already exists for 'Localtonet_…'
Ya hay un servicio instalado para este token. Compruébalo con --status-service. Para instalarlo de nuevo, ejecuta antes --remove-service.
El servicio está instalado pero el token sigue Sin conexión
Lee el registro de errores del trabajo, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, y comprueba que el archivo localtonet sigue existiendo en la ruta que tenía cuando instalaste el servicio.
Wrong Token!
El cliente espera el AuthToken de 33 caracteres de Mis tokens, o un PIN de 6 dígitos que no haya caducado. Copia el token de nuevo e introdúcelo en el prompt.
This token is used in another localtonet application!
Otro cliente de Localtonet de este Mac ya se ejecuta con el mismo token. Ciérralo o inicia este con otro token. Usa un cliente en ejecución por token.