Instala Localtonet desde un paquete DEB o RPM
En esta página 9 secciones
- Antes de empezar
- Qué instala el paquete
- Pasos
- Descarga e instala el paquete
- Configura tu AuthToken
- Comprueba la configuración
- Activa un servicio
- Inicia un túnel
- Servicio de túneles o servicio de VPN
- Cómo se ejecutan los servicios
- Lee el registro
- Actualizar
- Desinstalar
- Solución de problemas
- Páginas relacionadas
Los paquetes DEB y RPM instalan el cliente de Localtonet junto con dos servicios de systemd, uno para túneles y otro para túneles más VPN. Los servicios leen tu AuthToken de un archivo y se ejecutan sin terminal, de modo que el cliente arranca en cada inicio del sistema.
Antes de empezar #
- Un sistema Linux de 64 bits: los paquetes existen para x64 y ARM64.
- systemd 247 o posterior y OpenSSL 3, como Debian 12, Ubuntu 22.04+ o RHEL 9.
- Acceso root (
sudo). - Tu AuthToken. Selecciona Copiar en la tarjeta AuthToken del Panel, o copia un token de Mis tokens.
En otras distribuciones, en ARM de 32 bits, o cuando no quieras un paquete del sistema, usa el script de instalación o los archivos comprimidos descritos en Linux.
Qué instala el paquete #
| Ruta | Qué es |
|---|---|
/usr/bin/localtonet | El comando localtonet. |
/usr/lib/localtonet/ | El propio cliente. |
/usr/lib/systemd/system/localtonet.service | El servicio de túneles. |
/usr/lib/systemd/system/localtonet-vpn.service | El servicio de VPN y túneles. |
/etc/localtonet/auth-token | El archivo del token. Solo root puede leerlo. Se instala con el marcador DUMMY_AUTH_TOKEN. |
El paquete se llama localtonet. Su gestor de paquetes instala sus dependencias, entre ellas OpenSSL 3, iproute2 (iproute en el RPM), iptables y kmod. Instalar el paquete no activa ni inicia ningún servicio: primero configuras el token y luego activas el servicio que necesites.
Pasos #
-
Descarga e instala el paquete #
Elige el paquete para tu distribución y tu CPU en la lista del final de esta página y luego instala el archivo descargado con
apt(DEB) odnf(RPM). Instrucciones de instalación, bajo cada paquete, muestra los comandos exactos para ese archivo. -
Configura tu AuthToken #
Edita
/etc/localtonet/auth-tokencomo root con un editor de texto y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después asegúrate de que solo root pueda leer el archivo:Terminalsudo chmod 600 /etc/localtonet/auth-token -
Comprueba la configuración #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configLa comprobación lee el archivo del token sin conectarse. Responde
Localtonet headless configuration OK.cuando el archivo contiene un token de 33 caracteres sin espacios. No pregunta a los servidores de Localtonet si el token es válido para tu cuenta. -
Activa un servicio #
Para túneles, activa el servicio de túneles y lee su registro:
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSi este dispositivo también se une a una red VPN, activa en su lugar el servicio de VPN. Consulta Servicio de túneles o servicio de VPN.
-
Inicia un túnel #
El token aparece ahora como En línea en Mis tokens. Crea e inicia un túnel para él en el panel; consulta Inicio rápido.
Servicio de túneles o servicio de VPN #
Ambos servicios ejecutan el mismo cliente y ambos sirven tus túneles. Se diferencian en los derechos con los que se ejecutan. Activa solo uno: los dos servicios entran en conflicto, e iniciar uno detiene al otro.
localtonet.service | localtonet-vpn.service | |
|---|---|---|
| Úsalo para | Túneles | VPN y túneles |
| Se ejecuta como | Un usuario sin privilegios que systemd crea para el servicio | root, limitado a las capacidades de red CAP_NET_ADMIN y CAP_NET_RAW |
| Módulo TUN | No se usa | Se carga con modprobe tun antes de que arranque el cliente |
| Directorio de trabajo | /var/lib/localtonet | /var/lib/localtonet-vpn |
Para cambiar un dispositivo del servicio de túneles al servicio de VPN:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.servicePara volver, desactiva localtonet-vpn.service y activa localtonet.service de la misma manera. Las redes VPN en sí se configuran en el panel; consulta Gestor de VPN.
Cómo se ejecutan los servicios #
| Comportamiento | Detalles |
|---|---|
| Modo headless | Ambos servicios inician localtonet --headless. En este modo el cliente nunca pide datos y no guarda el token en sus propios ajustes. |
| Token | systemd pasa /etc/localtonet/auth-token al servicio. Un servicio no se inicia mientras falte el archivo. |
| Inicio en el arranque | Un servicio activado se inicia cuando la red está disponible. |
| Reinicio | systemd reinicia el cliente diez segundos después de un fallo. No lo reinicia cuando el cliente se detiene por un archivo de token no válido. Corrige el archivo y reinicia tú mismo el servicio. |
Lee el registro #
En modo headless el cliente escribe líneas de texto sin formato en el journal, una por cada cambio:
sudo journalctl -u localtonet.service -f| Línea | Significado |
|---|---|
Connection: Connected | El estado de la sesión. Otros valores son Connecting y Disconnected. |
AuthTokenName: … | El nombre del token con el que inició sesión el cliente. |
OPEN …, ADDED … | Un túnel que se ejecuta en este dispositivo, con su dirección pública, protocolo y destino local. |
STATUS … | Un túnel cambió de estado. |
CLOSED … | Un túnel se detuvo o se eliminó. |
Authentication failed: AuthToken was rejected. | El token del archivo no se acepta. Cópialo de nuevo desde Mis tokens. |
Si una de estas líneas fuera a contener el token, el cliente escribe [redacted] en su lugar.
Actualizar #
Descarga el paquete nuevo e instálalo de la misma manera que la primera vez, y luego reinicia el servicio que uses. Tu archivo de token se conserva.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceEn Mis tokens, la columna Cliente muestra la versión que el dispositivo notificó por última vez y una insignia Requiere actualización cuando hay una más reciente.
Desinstalar #
sudo apt remove localtonetsudo dnf remove localtonetAl desinstalar el paquete se detienen y desactivan ambos servicios. El archivo del token es un archivo de configuración, y los gestores de paquetes los tratan con cuidado: tras la desinstalación, comprueba si /etc/localtonet/auth-token o una copia guardada sigue ahí, y elimínalo si no quieres que el token permanezca en la máquina.
Solución de problemas #
Invalid Localtonet headless configuration. Check the token file or environment settings.
El archivo del token no se puede usar. Comprueba que /etc/localtonet/auth-token existe, que el marcador DUMMY_AUTH_TOKEN ya no está y que el archivo contiene solo el token de 33 caracteres, sin espacios y en una sola línea. Ejecuta la comprobación con sudo, porque solo root puede leer el archivo.
El servicio está activado pero no se ejecuta
Ejecuta systemctl status localtonet.service. Un servicio no se inicia mientras falte /etc/localtonet/auth-token, y no se reinicia después de haberse detenido por un archivo de token no válido. Corrige el archivo, ejecuta la comprobación de configuración y luego ejecuta sudo systemctl restart localtonet.service.
El registro dice: Authentication failed: AuthToken was rejected.
El archivo tiene el formato correcto pero no se acepta el token. Copia de nuevo el token desde Mis tokens, guárdalo en el archivo del token y reinicia el servicio.
El servicio de túneles se detuvo cuando inicié el servicio de VPN
Es lo previsto. Los dos servicios entran en conflicto, así que systemd detiene uno cuando se inicia el otro. El servicio de VPN también sirve tus túneles.
El paquete no se instala en mi distribución
Los paquetes necesitan systemd 247 o posterior y OpenSSL 3. En versiones anteriores el gestor de paquetes no puede satisfacer estas dependencias. Usa en su lugar el script de instalación o un archivo comprimido de la página de Linux.
Páginas relacionadas #
Los paquetes se listan a continuación. Selecciona Instrucciones de instalación bajo un paquete para ver los comandos con el nombre de su archivo.
Paquetes para Linux
Paquetes DEB y RPM instalables para x64 y ARM64. Requieren systemd 247 o posterior y OpenSSL 3, como en Debian 12, Ubuntu 22.04+ o RHEL 9.
-
Debian / Ubuntu · x64
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-linux-x64.deb.sudo apt install ./localtonet-linux-x64.deb2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara la VPN, cambia al servicio VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePara actualizar, instala el nuevo paquete y ejecuta
sudo systemctl restart localtonet. Tu configuración se conserva.Si usas la VPN, reinicia
localtonet-vpn.serviceen su lugar. -
Debian / Ubuntu · ARM64
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-linux-arm64.deb.sudo apt install ./localtonet-linux-arm64.deb2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara la VPN, cambia al servicio VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePara actualizar, instala el nuevo paquete y ejecuta
sudo systemctl restart localtonet. Tu configuración se conserva.Si usas la VPN, reinicia
localtonet-vpn.serviceen su lugar. -
Fedora / RHEL · x64
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-linux-x64.rpm.sudo dnf install ./localtonet-linux-x64.rpm2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara la VPN, cambia al servicio VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePara actualizar, instala el nuevo paquete y ejecuta
sudo systemctl restart localtonet. Tu configuración se conserva.Si usas la VPN, reinicia
localtonet-vpn.serviceen su lugar. -
Fedora / RHEL · ARM64
Instrucciones de instalación
1. Instala el paquete descargado. Abre una terminal en el directorio que contiene
localtonet-linux-arm64.rpm.sudo dnf install ./localtonet-linux-arm64.rpm2. Configura tu AuthToken. Edita
/etc/localtonet/auth-tokencomo root y sustituyeDUMMY_AUTH_TOKENpor tu token en una sola línea. Después protege el archivo y comprueba la configuración:sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePara la VPN, cambia al servicio VPN:
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePara actualizar, instala el nuevo paquete y ejecuta
sudo systemctl restart localtonet. Tu configuración se conserva.Si usas la VPN, reinicia
localtonet-vpn.serviceen su lugar.