Saltar al contenido
Localtonet Localtonet Panel

Instala Localtonet desde un paquete DEB o RPM

Ayuda con esta página
En esta página 9 secciones
  1. Antes de empezar
  2. Qué instala el paquete
  3. Pasos
  4. Descarga e instala el paquete
  5. Configura tu AuthToken
  6. Comprueba la configuración
  7. Activa un servicio
  8. Inicia un túnel
  9. Servicio de túneles o servicio de VPN
  10. Cómo se ejecutan los servicios
  11. Lee el registro
  12. Actualizar
  13. Desinstalar
  14. Solución de problemas
  15. 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 #

RutaQué es
/usr/bin/localtonetEl comando localtonet.
/usr/lib/localtonet/El propio cliente.
/usr/lib/systemd/system/localtonet.serviceEl servicio de túneles.
/usr/lib/systemd/system/localtonet-vpn.serviceEl servicio de VPN y túneles.
/etc/localtonet/auth-tokenEl 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 #

  1. 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) o dnf (RPM). Instrucciones de instalación, bajo cada paquete, muestra los comandos exactos para ese archivo.

  2. Configura tu AuthToken #

    Edita /etc/localtonet/auth-token como root con un editor de texto y sustituye DUMMY_AUTH_TOKEN por tu token en una sola línea. Después asegúrate de que solo root pueda leer el archivo:

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. Comprueba la configuración #

    Terminal
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

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

  4. Activa un servicio #

    Para túneles, activa el servicio de túneles y lee su registro:

    Terminal
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

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

  5. 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.servicelocaltonet-vpn.service
Úsalo paraTúnelesVPN y túneles
Se ejecuta comoUn usuario sin privilegios que systemd crea para el servicioroot, limitado a las capacidades de red CAP_NET_ADMIN y CAP_NET_RAW
Módulo TUNNo se usaSe 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:

Terminal
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

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

ComportamientoDetalles
Modo headlessAmbos servicios inician localtonet --headless. En este modo el cliente nunca pide datos y no guarda el token en sus propios ajustes.
Tokensystemd pasa /etc/localtonet/auth-token al servicio. Un servicio no se inicia mientras falte el archivo.
Inicio en el arranqueUn servicio activado se inicia cuando la red está disponible.
Reiniciosystemd 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:

Terminal
sudo journalctl -u localtonet.service -f
LíneaSignificado
Connection: ConnectedEl 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.

Servicio de túneles
sudo systemctl restart localtonet
Servicio de VPN
sudo systemctl restart localtonet-vpn.service

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

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

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

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

    2. Configura tu AuthToken. Edita /etc/localtonet/auth-token como root y sustituye DUMMY_AUTH_TOKEN por 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-config

    3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para 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.service

    Para actualizar, instala el nuevo paquete y ejecuta sudo systemctl restart localtonet. Tu configuración se conserva.

    Si usas la VPN, reinicia localtonet-vpn.service en 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.deb

    2. Configura tu AuthToken. Edita /etc/localtonet/auth-token como root y sustituye DUMMY_AUTH_TOKEN por 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-config

    3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para 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.service

    Para actualizar, instala el nuevo paquete y ejecuta sudo systemctl restart localtonet. Tu configuración se conserva.

    Si usas la VPN, reinicia localtonet-vpn.service en 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.rpm

    2. Configura tu AuthToken. Edita /etc/localtonet/auth-token como root y sustituye DUMMY_AUTH_TOKEN por 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-config

    3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para 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.service

    Para actualizar, instala el nuevo paquete y ejecuta sudo systemctl restart localtonet. Tu configuración se conserva.

    Si usas la VPN, reinicia localtonet-vpn.service en 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.rpm

    2. Configura tu AuthToken. Edita /etc/localtonet/auth-token como root y sustituye DUMMY_AUTH_TOKEN por 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-config

    3. Inicia el servicio. Cuando la comprobación de la configuración sea correcta:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Para 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.service

    Para actualizar, instala el nuevo paquete y ejecuta sudo systemctl restart localtonet. Tu configuración se conserva.

    Si usas la VPN, reinicia localtonet-vpn.service en su lugar.

Soporte