Saltar al contenido
Localtonet Localtonet Panel

Ejecutar Localtonet como servicio

Ayuda con esta página
En esta página 8 secciones
  1. Antes de empezar
  2. Instala el servicio
  3. Windows
  4. El nombre del servicio
  5. Qué ejecuta el servicio
  6. Gestionar el servicio
  7. Windows
  8. Dónde se registra el servicio y dónde están sus registros
  9. Cambiar el token
  10. Cosas que debes saber
  11. Solución de problemas
  12. Páginas relacionadas

Instala el cliente de Localtonet como servicio en segundo plano para que se inicie con el dispositivo, siga funcionando después de cerrar sesión y no necesite ningún terminal abierto. Un solo comando lo registra en los servicios de Windows, en launchd en macOS o en systemd en Linux.

Antes de empezar #

  • El cliente de consola está instalado en el dispositivo: Windows, macOS o Linux.
  • Un AuthToken para este dispositivo de Mis tokens.
  • Derechos de administrador: un terminal abierto con Run as administrator en Windows, sudo en macOS y Linux.
  • En Linux, una distribución que use systemd. Termux no es compatible; usa allí la app de Android.

¿Lo instalaste desde un paquete DEB o RPM, en OpenWrt o en Docker? Esos incluyen su propia forma de iniciarse con el arranque. Consulta Paquetes DEB y RPM, OpenWrt y Docker en lugar de esta página.

Instala el servicio #

Ejecuta el cliente una vez con --install-service y tu token. Sustituye <YOUR_TOKEN> por tu AuthToken. Incluye siempre --authtoken en este comando: el servicio se conecta con el token con el que lo instalas.

Windows #

Abre el Símbolo del sistema o PowerShell como administrador en la carpeta que contiene localtonet y ejecuta:

Símbolo del sistema o PowerShell (administrador)
localtonet --install-service --authtoken <YOUR_TOKEN>

El cliente crea un servicio de Windows con inicio automático y lo inicia. El servicio es visible en services.msc con la descripción Localtonet Service. Si el servicio falla, Windows lo reinicia al cabo de un minuto.

macOS

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

El cliente escribe un trabajo de launchd en /Library/LaunchDaemons/<SERVICE_NAME>.plist, lo carga y lo inicia. El trabajo se inicia con el arranque, y launchd lo inicia de nuevo si termina con un error.

Linux

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

El cliente escribe una unidad de systemd en /etc/systemd/system/<SERVICE_NAME>.service, la habilita y la inicia. La unidad se inicia con el arranque, y systemd la reinicia cinco segundos después de un fallo.

Si sudo no encuentra localtonet, ejecútalo con su ruta, por ejemplo sudo ./localtonet desde la carpeta que lo contiene.

Si todo va bien, el cliente muestra el nombre del servicio:

Salida
[CLI] Installed service 'Localtonet_AbCdEfGhI'

La instalación también inicia el servicio, así que no hace falta un comando de inicio aparte. Ya puedes crear e iniciar túneles para este token en el panel.

El nombre del servicio #

El servicio se llama Localtonet_ seguido de los nueve primeros caracteres del token, por ejemplo Localtonet_AbCdEfGhI. Esta página escribe <SERVICE_NAME> para referirse a él. Como el nombre sale del token, puedes instalar un servicio por token en el mismo dispositivo, y todos los comandos de gestión necesitan el mismo token para encontrar su servicio.

Qué ejecuta el servicio #

El servicio inicia el mismo archivo localtonet desde la misma ubicación, con las opciones que diste en el comando de instalación. De ello se derivan dos cosas:

  • No muevas ni borres el archivo. La definición del servicio contiene su ruta completa. En Linux, si el archivo está dentro de /root, el instalador lo copia a /usr/local/lib/<SERVICE_NAME>/ y el servicio ejecuta esa copia.
  • Las demás opciones se conservan. Opciones como --net y --ip o --proxy env en el comando de instalación se guardan en el servicio y se usan en cada inicio. Consulta la Referencia de la línea de comandos.

Gestionar el servicio #

Usa el mismo token con una de estas opciones. En macOS y Linux, antepón sudo. En Windows, usa un terminal de administrador para todo excepto el estado.

ComandoQué haceSalida si todo va bien
localtonet --status-service --authtoken <YOUR_TOKEN>Muestra el estado del servicio.[CLI] Service '<SERVICE_NAME>' status: Running
localtonet --stop-service --authtoken <YOUR_TOKEN>Detiene el servicio. Sus túneles quedan sin conexión. Se inicia de nuevo en el siguiente arranque.[CLI] Stopped service '<SERVICE_NAME>'.
localtonet --start-service --authtoken <YOUR_TOKEN>Inicia un servicio detenido.[CLI] Started service '<SERVICE_NAME>'.
localtonet --remove-service --authtoken <YOUR_TOKEN>Detiene el servicio y elimina su registro. El archivo localtonet en sí se conserva.[CLI] Removed service '<SERVICE_NAME>'.

El estado es uno de estos valores:

EstadoSignificado
RunningEl servicio se está ejecutando.
StoppedEl servicio está instalado pero no se está ejecutando.
InstallingEl servicio se está iniciando.
NotFoundNo hay ningún servicio instalado para este token.
PausedSolo en Windows: el servicio se puso en pausa.
ErrorEl servicio falló, o no se pudo leer su estado.
UnknownEl administrador de servicios devolvió un estado que el cliente no reconoce.

También puedes usar las herramientas del sistema operativo con el nombre del servicio:

Windows #

Abre services.msc y busca <SERVICE_NAME>, o usa sc en un terminal de administrador:

Símbolo del sistema (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>

Dónde se registra el servicio y dónde están sus registros #

SistemaRegistroRegistros
WindowsUn servicio de Windows llamado <SERVICE_NAME>, con tipo de inicio automático, que se ejecuta con la cuenta LocalSystem.El servicio no tiene ventana de consola y el instalador no configura ningún archivo de registro. Comprueba el estado del servicio, y el dispositivo y sus túneles en el panel.
macOS/Library/LaunchDaemons/<SERVICE_NAME>.plist, un trabajo de launchd para todo el sistema./var/log/<SERVICE_NAME>.out.log y /var/log/<SERVICE_NAME>.err.log
Linux/etc/systemd/system/<SERVICE_NAME>.service, habilitada para multi-user.target.El journal de systemd: journalctl -u <SERVICE_NAME> -f

El servicio no muestra la tabla de túneles que el cliente muestra en un terminal. Para ver el estado de tu dispositivo y sus túneles, usa el panel.

Cambiar el token #

Para cambiar el token de un dispositivo, elimina el servicio con el token antiguo e instálalo de nuevo con el nuevo:

Bash
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>

Cosas que debes saber #

  • Un cliente por token. Mientras el servicio se ejecuta, no inicies otro cliente de Localtonet con el mismo token, ni en este dispositivo ni en otro. Un segundo cliente que se conecta con un token desconecta al primero.
  • Actualizar el cliente. El servicio sigue ejecutando el archivo al que apunta su definición. Detén el servicio, sustituye ese archivo por la nueva versión e inicia el servicio de nuevo.
  • Las contraseñas de proxy no se guardan. El comando de instalación rechaza una URL de proxy que contenga una contraseña y la opción --proxy-user. Instala con --proxy env y define las variables de proxy en el entorno del servicio.
  • Terminal de dispositivos. Si el dispositivo ejecuta Localtonet como servicio, ejecuta localtonet --terminal enable desde un terminal de administrador o con sudo, para que el servicio pueda usar el resultado. Consulta Terminal de dispositivos.

Solución de problemas #

MensajeCausa y solución
[CLI] Install failed: '…' requires elevated (admin/root) privileges.El comando se ejecutó sin derechos de administrador. Abre el terminal como administrador en Windows, o usa sudo en macOS y Linux. En Windows y Linux aparece el mismo mensaje al iniciar, detener y eliminar.
[CLI] Install failed: seguido de Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) o Plist already exists for … (macOS)Ya hay un servicio instalado para este token. Usa --start-service para iniciarlo, o --remove-service primero si quieres instalarlo de nuevo.
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment.El comando de instalación contenía --proxy-user o una URL de proxy con contraseña. Usa --proxy env en su lugar.
[CLI] Start failed: … en Windows justo después de instalarEl servicio ya se está ejecutando, porque la instalación lo inicia. Compruébalo con --status-service.
El estado es NotFoundNo existe ningún servicio para el token que pasaste. Comprueba que es el token con el que instalaste el servicio.
El estado es Running pero el dispositivo aparece sin conexión en el panelComprueba el token: cópialo de nuevo desde Mis tokens, elimina el servicio e instálalo de nuevo. Asegúrate también de que ningún otro cliente use el mismo token.
Soporte