Saltar al contenido
Localtonet Localtonet Panel

Instala Localtonet en macOS

Ayuda con esta página
En esta página 9 secciones
  1. Antes de empezar
  2. Instala con Homebrew
  3. Añade el tap de Localtonet e instala
  4. Comprueba la instalación
  5. Instala manualmente
  6. Descarga y extrae
  7. Opcional: muévelo a tu PATH
  8. Inicia el cliente
  9. Inícialo con tu token
  10. Comprueba la sesión
  11. Ejecútalo como servicio de launchd
  12. Instala el servicio
  13. Comprueba que se ejecuta
  14. Qué crea la instalación
  15. Comandos de servicio
  16. Actualización
  17. Desinstalación
  18. Solución de problemas
  19. 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 #

  1. 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.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. Comprueba la instalación #

    Terminal
    localtonet --version

    El 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.

MacArchivo
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Descarga y extrae #

    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: muévelo a tu PATH #

    Sin este paso, inicias el cliente por su ruta, ~/localtonet/localtonet. Con él, puedes escribir localtonet en cualquier carpeta.

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

Inicia el cliente #

  1. Inícialo con tu token #

    Terminal
    localtonet --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, pregunta Please Enter AuthToken or PIN.

  2. Comprueba la sesión #

    El terminal muestra Session Status: Connected sobre una tabla con una fila por cada túnel en ejecución: IP/Url, Protocol, Client IP, Client Port, Ping y Status. 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.

  1. Instala el servicio #

    Terminal
    sudo 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 --authtoken para encontrarlo.

  2. Comprueba que se ejecuta #

    Terminal
    sudo 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 #

ElementoUbicació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>.

ComandoQué hace
--install-serviceEscribe la definición del trabajo, la carga e inicia el cliente.
--start-serviceInicia el trabajo. Si ya está en ejecución, launchd lo reinicia.
--stop-serviceDetiene el cliente. El trabajo sigue instalado y se vuelve a iniciar en el próximo arranque.
--status-serviceMuestra el estado, por ejemplo Running, Stopped, NotFound o Error.
--remove-serviceDetiene 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.

Terminal
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 #

  1. Si instalaste el servicio, elimínalo: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Para quitar el token guardado, inicia el cliente y pulsa F12.
  3. Elimina el cliente. Con Homebrew: brew uninstall localtonet y brew untap localtonet/tap para quitar el tap. Tras una instalación manual, elimina el archivo localtonet.

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:

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

Soporte