Ejecuta Localtonet en Docker
En esta página 12 secciones
- Antes de empezar
- Pasos
- Descarga la imagen
- Inicia el contenedor con tu token
- Crea e inicia un túnel
- Cómo se ejecuta el contenedor
- Ejecuta en segundo plano y reinicia automáticamente
- Formas de pasar el token
- Docker Compose
- Accede a tu servicio desde el contenedor
- Lee el registro
- Actualización
- Archivos de imagen para hosts sin acceso al registro
- Solución de problemas
- 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/amd64ylinux/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 #
-
Descarga la imagen #
Descargarla primero garantiza que ejecutas la versión actual y no una imagen más antigua que siga en el host.
Bashdocker pull localtonet/localtonetLa 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. -
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.Bashdocker 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.
-
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.1significa 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:
docker run -d \
--name localtonet \
--restart unless-stopped \
localtonet/localtonet --authtoken <YOUR_TOKEN>Gestiónalo con los comandos habituales de Docker:
| Comando | Qué hace |
|---|---|
docker ps | Lista los contenedores en ejecución. |
docker logs -f localtonet | Sigue el registro del cliente. |
docker stop localtonet | Detiene el cliente. Sus túneles pasan a estar sin conexión. |
docker start localtonet | Lo vuelve a iniciar con el mismo token. |
docker rm -f localtonet | Elimina 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:
| Origen | Cómo usarlo | Notas |
|---|---|---|
--authtoken <YOUR_TOKEN> | Argumento después del nombre de la imagen. | La más sencilla. Prevalece sobre LOCALTONET_AUTH_TOKEN. |
LOCALTONET_AUTH_TOKEN | Variable de entorno que contiene el token. | Se usa cuando no se indica ningún argumento --authtoken. |
LOCALTONET_AUTH_TOKEN_FILE | Variable 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:
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/localtonetCrea 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.
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-configDocker Compose #
La misma configuración como archivo Compose. Pon el token en un archivo llamado auth-token junto a 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:rodocker compose up -d
docker compose logs -f localtonetCuando 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:
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:roPara 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 servicio | Dirección local que introducir | Qué más se necesita |
|---|---|---|
| En el host de Docker, Linux | 127.0.0.1 | Inicia 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.10 | El 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 contenedor | 127.0.0.1 con --network host en Linux; en otro caso, la dirección IP de LAN del host | Publica 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 red | La dirección IP de LAN de ese dispositivo, por ejemplo 192.168.1.20 | Nada. |
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ínea | Significado |
|---|---|
Localtonet - headless log | El 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:
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:
| Arquitectura | Archivo |
|---|---|
| AMD64 | localtonet-docker-amd64.tar |
| ARM64 | localtonet-docker-arm64.tar |
docker load --input localtonet-docker-amd64.tardocker 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:
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.