Ejecutar Localtonet como servicio
En esta página 8 secciones
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,
sudoen 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:
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
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
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:
[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
--nety--ipo--proxy enven 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.
| Comando | Qué hace | Salida 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:
| Estado | Significado |
|---|---|
Running | El servicio se está ejecutando. |
Stopped | El servicio está instalado pero no se está ejecutando. |
Installing | El servicio se está iniciando. |
NotFound | No hay ningún servicio instalado para este token. |
Paused | Solo en Windows: el servicio se puso en pausa. |
Error | El servicio falló, o no se pudo leer su estado. |
Unknown | El 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:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>Dónde se registra el servicio y dónde están sus registros #
| Sistema | Registro | Registros |
|---|---|---|
| Windows | Un 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:
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 envy define las variables de proxy en el entorno del servicio. - Terminal de dispositivos. Si el dispositivo ejecuta Localtonet como servicio, ejecuta
localtonet --terminal enabledesde un terminal de administrador o consudo, para que el servicio pueda usar el resultado. Consulta Terminal de dispositivos.
Solución de problemas #
| Mensaje | Causa 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 instalar | El servicio ya se está ejecutando, porque la instalación lo inicia. Compruébalo con --status-service. |
El estado es NotFound | No 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 panel | Comprueba 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. |