Saltar al contenido
Localtonet Localtonet Panel

Ejecuta Localtonet en Docker

Ayuda con esta página
En esta página 12 secciones
  1. Antes de empezar
  2. Pasos
  3. Descarga la imagen
  4. Inicia el contenedor con tu token
  5. Crea e inicia un túnel
  6. Cómo se ejecuta el contenedor
  7. Ejecuta en segundo plano y reinicia automáticamente
  8. Formas de pasar el token
  9. Docker Compose
  10. Accede a tu servicio desde el contenedor
  11. Lee el registro
  12. Actualización
  13. Archivos de imagen para hosts sin acceso al registro
  14. Solución de problemas
  15. Páginas relacionadas

La imagen oficial localtonet/localtonet ejecuta el cliente de Localtonet en un contenedor. Pasa tu AuthToken y luego crea e inicia túneles en el panel como de costumbre.

Antes de empezar #

  • Docker en un host de 64 bits. La imagen se publica para linux/amd64 y linux/arm64, y Docker elige la que coincide con tu host. Para un dispositivo ARM de 32 bits, usa en su lugar la compilación para Linux.
  • Un AuthToken de Mis tokens. Da a cada contenedor su propio token: cuando un segundo cliente se conecta con el mismo token, el primero se desconecta.

Pasos #

  1. Descarga la imagen #

    Descargarla primero garantiza que ejecutas la versión actual y no una imagen más antigua que siga en el host.

    Bash
    docker pull localtonet/localtonet

    La imagen está en Docker Hub. Además de latest, Docker Hub lista una etiqueta por cada versión por si quieres fijar una versión concreta.

  2. Inicia el contenedor con tu token #

    Todo lo que va después del nombre de la imagen se pasa al cliente de Localtonet. Sustituye <YOUR_TOKEN> por tu AuthToken.

    Bash
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    El contenedor muestra el estado de su conexión y se queda en primer plano. Pulsa Ctrl + C para detenerlo.

  3. Crea e inicia un túnel #

    Abre el panel, crea un túnel con el token que diste al contenedor y selecciona Iniciar. El Inicio rápido muestra el formulario. Lee Accede a tu servicio desde el contenedor antes de rellenar Dirección IP local, porque 127.0.0.1 significa algo distinto dentro de un contenedor.

Cómo se ejecuta el contenedor #

La imagen inicia el cliente en modo headless. Eso cambia tres cosas respecto al cliente en un escritorio:

  • Nunca hace preguntas. Si falta el token o está mal formado, el contenedor muestra un error y termina con el código 2.
  • Escribe líneas de registro en texto plano en lugar de la tabla de estado en vivo, incluso cuando lo inicias con -it.
  • No guarda el token. La imagen no declara volúmenes, así que pasa el token cada vez que se crea un contenedor: en la línea de comandos, en una variable de entorno o como archivo.

Los túneles no se configuran en el contenedor. Los creas, inicias y detienes en el panel, y el contenedor los recibe a través de su conexión.

Ejecuta en segundo plano y reinicia automáticamente #

Usa -d para desacoplarlo y una política de reinicio para que Docker vuelva a iniciar el contenedor tras un reinicio del sistema o un fallo:

Bash
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Gestiónalo con los comandos habituales de Docker:

ComandoQué hace
docker psLista los contenedores en ejecución.
docker logs -f localtonetSigue el registro del cliente.
docker stop localtonetDetiene el cliente. Sus túneles pasan a estar sin conexión.
docker start localtonetLo vuelve a iniciar con el mismo token.
docker rm -f localtonetElimina el contenedor.

Formas de pasar el token #

Un token en la línea de comandos es visible en docker inspect y en la lista de procesos del host. La imagen también lee el token del entorno o de un archivo:

OrigenCómo usarloNotas
--authtoken <YOUR_TOKEN>Argumento después del nombre de la imagen.La más sencilla. Prevalece sobre LOCALTONET_AUTH_TOKEN.
LOCALTONET_AUTH_TOKENVariable de entorno que contiene el token.Se usa cuando no se indica ningún argumento --authtoken.
LOCALTONET_AUTH_TOKEN_FILEVariable de entorno que contiene la ruta, dentro del contenedor, de un archivo que contiene solo el token.Un archivo de token siempre prevalece sobre un token pasado directamente. El argumento --authtoken-file <PATH> hace lo mismo.

La propia imagen establece LOCALTONET_HEADLESS=1. No necesitas establecerla.

Con un archivo de token, mantén el token fuera de la definición del contenedor y móntalo como solo lectura:

Bash
printf '%s' '<YOUR_TOKEN>' > auth-token
chmod 600 auth-token

docker run -d \
  --name localtonet \
  --restart unless-stopped \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet

Crea el archivo de token antes de iniciar el contenedor. Si el archivo no existe, Docker crea un directorio con ese nombre y el cliente no puede leer un token de él.

Para comprobar un origen de token sin conectar, añade --check-config. El cliente comprueba que el token esté presente y bien formado (33 caracteres, sin espacios), imprime Localtonet headless configuration OK. y termina. No pregunta al servidor si el token es válido.

Bash
docker run --rm \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet --check-config

Docker Compose #

La misma configuración como archivo Compose. Pon el token en un archivo llamado auth-token junto a compose.yaml:

compose.yaml
services:
  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro
Bash
docker compose up -d
docker compose logs -f localtonet

Cuando el servicio que quieres publicar está en el mismo proyecto Compose en un host Linux, publica su puerto en el host y ejecuta el contenedor de Localtonet con red de host. La dirección local del túnel debe ser una dirección IP, así que no se puede usar para ello el nombre de un servicio de Compose como web:

compose.yaml
services:
  web:
    image: nginx
    ports:
      - "8080:80"

  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    network_mode: host
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro

Para este ejemplo, establece la dirección local del túnel en 127.0.0.1 y su puerto local en 8080.

Para un NAS o Home Assistant, hay plantillas listas para usar en la página NAS y Home Assistant.

Accede a tu servicio desde el contenedor #

La Dirección IP local y el Puerto local del túnel indican al cliente dónde está tu servicio. El cliente se conecta desde dentro del contenedor, donde 127.0.0.1 es el propio contenedor y no tu equipo. Introduce una dirección IP: el cliente no resuelve nombres de Docker como host.docker.internal, el nombre de un servicio de Compose ni el nombre de un contenedor. Usa el valor que corresponda a dónde se ejecuta el servicio:

Dónde se ejecuta el servicioDirección local que introducirQué más se necesita
En el host de Docker, Linux127.0.0.1Inicia el contenedor con --network host (Compose: network_mode: host). Así el contenedor comparte la red del host.
En el host de Docker, sin red de host (incluido Docker Desktop en Windows o macOS)La dirección IP de LAN del host, por ejemplo 192.168.1.10El servicio debe escuchar en una dirección a la que el contenedor pueda llegar, no solo en 127.0.0.1, y el firewall del host debe permitir la conexión.
En otro contenedor127.0.0.1 con --network host en Linux; en otro caso, la dirección IP de LAN del hostPublica el puerto de ese contenedor en el host (-p, Compose: ports) y usa el puerto publicado como puerto local del túnel.
En otro dispositivo de tu redLa dirección IP de LAN de ese dispositivo, por ejemplo 192.168.1.20Nada.
Linux, servicio en el host
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

Puedes cambiar la dirección de un túnel existente en su configuración, en Dirección local. Consulta la referencia de configuración.

Lee el registro #

docker logs -f localtonet muestra una línea por cada cambio. Todas las líneas, salvo la primera, empiezan con una marca de tiempo:

LíneaSignificado
Localtonet - headless logEl cliente se inició.
Connection: …El estado de la conexión con Localtonet. Aparece una línea nueva cuando cambia.
AuthTokenName: …El nombre del token con el que inició sesión el contenedor, tal como aparece en Mis tokens.
OPEN …, ADDED …Un túnel de este token. OPEN se usa para los túneles que existen cuando el cliente se inicia y ADDED para los que aparecen después.
STATUS …Cambió el estado de un túnel.
CLOSED …Se quitó un túnel de este cliente.
Authentication failed: AuthToken was rejected.Localtonet no aceptó el token.

El token en sí nunca se escribe en el registro.

Actualización #

Descarga la imagen de nuevo y vuelve a crear el contenedor:

Bash
docker pull localtonet/localtonet
docker rm -f localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

Con Compose, ejecuta docker compose pull y luego docker compose up -d. Para empezar siempre desde la imagen más reciente, añade --pull always a docker run.

Archivos de imagen para hosts sin acceso al registro #

Si el host no puede acceder a Docker Hub, descarga la imagen como archivo TAR en otro equipo, cópiala y cárgala:

Bash
docker load --input localtonet-docker-amd64.tar

docker load muestra lo que ha cargado. Si muestra un ID de imagen en lugar de un nombre, ponle un nombre a la imagen antes de ejecutarla:

Bash
docker tag <IMAGE_ID> localtonet/localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

Solución de problemas #

El contenedor termina de inmediato con "Invalid Localtonet headless configuration"

El mensaje completo es Invalid Localtonet headless configuration. Check the token file or environment settings. El cliente no encontró ningún token utilizable: no se pasó nada, el valor no tiene 33 caracteres, contiene un espacio o un salto de línea en medio, o la ruta del archivo de token no existe en el contenedor. Si montas un archivo de token, comprueba en el host que sea un archivo y no un directorio. Con una política de reinicio, el contenedor sigue reiniciándose hasta que corrijas el token, así que lee docker logs localtonet.

El registro muestra "Authentication failed: AuthToken was rejected."

El token está bien formado, pero Localtonet no lo acepta. Cópialo de nuevo desde Mis tokens y vuelve a crear el contenedor.

El túnel está iniciado, pero la dirección pública no llega a mi servicio

Revisa la dirección local del túnel. 127.0.0.1 solo funciona con --network host en Linux. En otro caso, usa la dirección IP de LAN del host. Un nombre como host.docker.internal o el nombre de otro contenedor no funciona en este campo, como se describe en Accede a tu servicio desde el contenedor.

El contenedor pierde la conexión continuamente

Asegúrate de que ningún otro cliente use el mismo token. Un segundo cliente que se conecta con el token desconecta al primero. Crea un token por contenedor o dispositivo en Mis tokens.

Soporte