Ejecutar Localtonet en un NAS o en Home Assistant
Plantillas de configuración AMD64 y ARM64
En esta página 7 secciones
- Qué son las plantillas
- Lo que no son
- Antes de empezar
- Configurar un NAS con Docker Compose
- Extrae el ZIP y copia la carpeta nas al NAS
- Crea el archivo del token
- Deja compose.yaml como está
- Inicia el proyecto
- Crea e inicia un túnel
- Qué hace la plantilla de Compose
- Configurar Home Assistant OS o Supervised
- Copia la carpeta de la app
- Recarga la tienda de apps e instala Localtonet
- Introduce tu token e inicia la app
- Crea e inicia un túnel
- Accede a tus servicios
- Registros y actualizaciones
- Páginas relacionadas
Localtonet ofrece plantillas de despliegue que ejecutan el cliente de Localtonet como contenedor en un NAS compatible con Docker y en Home Assistant. Añades tu AuthToken, inicias el contenedor y luego gestionas los túneles en el panel.
Qué son las plantillas #
La descarga es un pequeño archivo ZIP con dos plantillas, cinco archivos en total:
| Plantilla | Úsala en | Archivos | Qué cambias |
|---|---|---|---|
NAS / Docker Compose (carpeta nas) | Synology Container Manager, QNAP Container Station, cualquier otro NAS que ejecute Docker y hosts con Home Assistant Container o Core | nas/compose.yaml y nas/auth-token.example | Solo el token: copia auth-token.example a auth-token y sustituye DUMMY_AUTH_TOKEN por tu AuthToken. Deja compose.yaml tal como está. |
App de Home Assistant (carpeta home-assistant) | Home Assistant OS y Home Assistant Supervised | home-assistant/localtonet/config.json, la definición de una app local (antes llamada complemento), y home-assistant/repository.json | Nada en los archivos. Introduces el token en Home Assistant después de instalar la app. Una instalación local no usa repository.json. |
El quinto archivo, README.txt, es una versión breve en texto de los pasos de esta página.
Ambas plantillas ejecutan el cliente de Localtonet en un contenedor, sin preguntas, como describe la página de Docker. Están hechas para AMD64 (procesadores Intel y AMD) y ARM64. Comprueba qué procesador tiene tu NAS antes de empezar; un NAS con ARM de 32 bits no puede ejecutarlo.
Lo que no son #
- No son paquetes SPK de Synology ni QPKG de QNAP. No aparece nada en el Package Center de Synology ni en el App Center de QNAP.
- La plantilla de Home Assistant no es una entrada de la tienda oficial de Home Assistant. La instalas como app local.
- No contienen la imagen del contenedor. Tu dispositivo descarga la imagen que nombran las plantillas,
docker.io/localtonet/localtonet, que es la imagen de la página de Docker en Docker Hub. - No dan al contenedor los privilegios que necesita una interfaz VPN. Las plantillas son para túneles; la función de VPN no forma parte de ellas.
Antes de empezar #
- Un NAS con compatibilidad con Docker y Docker Compose, o Home Assistant OS / Supervised.
- Un AuthToken de Mis tokens. Usa un token que ningún otro dispositivo utilice: cuando un segundo cliente se conecta con el mismo token, el primero se desconecta.
- El ZIP de plantillas. La descarga está en la lista al final de esta página y en la página Descargas.
Configurar un NAS con Docker Compose #
-
Extrae el ZIP y copia la carpeta nas al NAS #
Extrae el archivo en tu ordenador. Copia la carpeta
nasa una carpeta compartida del NAS que pueda usar tu gestor de contenedores. -
Crea el archivo del token #
En la carpeta
nas, copiaauth-token.exampleaauth-token. Abreauth-tokeny sustituyeDUMMY_AUTH_TOKENpor tu AuthToken, en una sola línea y sin nada más en el archivo.Mantén el archivo del token en privado. Restríngelo a tu propia cuenta en el NAS y no lo pongas en una carpeta compartida o sincronizada que otras personas puedan leer. El token permite que el cliente de Localtonet se conecte como este dispositivo.
El archivo debe existir antes de que se inicie el contenedor. Si falta, Docker crea en su lugar un directorio llamado
auth-token, y el contenedor no puede leer un token de él. -
Deja compose.yaml como está #
No necesitas editar
compose.yaml. Su líneaimage:nombra la imagen de Localtonet y la versión para la que se creó este ZIP, por ejemplodocker.io/localtonet/localtonet:8.6.0. Las demás líneas se explican en Qué hace la plantilla de Compose. -
Inicia el proyecto #
Importa
compose.yamlcomo proyecto en tu gestor de contenedores e inícialo:- Synology: en Container Manager, crea un proyecto a partir de la carpeta
nasy sucompose.yaml. - QNAP: en Container Station, crea una aplicación a partir de
compose.yaml. El archivo monta./auth-tokenrelativo al archivo de Compose, así que el archivo del token debe ser accesible en esa ruta. - Cualquier host Docker con shell: ejecuta el comando siguiente desde el directorio
nas.
Bashdocker compose up -dLas pantallas exactas varían según el modelo y la versión del NAS. Sigue la documentación de tu fabricante para crear un proyecto a partir de un archivo de Compose.
- Synology: en Container Manager, crea un proyecto a partir de la carpeta
-
Crea e inicia un túnel #
Cuando el contenedor esté en ejecución, abre el panel, crea un túnel con el token que pusiste en el archivo y selecciona Iniciar, como en el Inicio rápido.
Qué hace la plantilla de Compose #
Este es el archivo completo. La etiqueta al final de la línea image: es la versión de Localtonet para la que se creó tu ZIP; 8.6.0 es un ejemplo.
services:
localtonet:
image: "docker.io/localtonet/localtonet:8.6.0"
restart: unless-stopped
network_mode: host
environment:
LOCALTONET_HEADLESS: "1"
LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
volumes:
- ./auth-token:/run/secrets/localtonet_auth_token:ro| Ajuste | Qué hace |
|---|---|
image | La imagen de Localtonet, docker.io/localtonet/localtonet, y la versión que se ejecuta. Cambia la etiqueta solo cuando pases a otra versión; consulta Registros y actualizaciones. |
restart: unless-stopped | Docker vuelve a iniciar el contenedor después de un reinicio o un fallo, a menos que lo hayas detenido tú. |
network_mode: host | El contenedor comparte la red del NAS. Así, un túnel puede llegar a los servicios del propio NAS en 127.0.0.1 y a otros dispositivos de tu LAN en sus direcciones de LAN. Esto requiere la red de host de Linux. |
LOCALTONET_HEADLESS | Ejecuta el cliente sin preguntas, con líneas de registro simples. |
LOCALTONET_AUTH_TOKEN_FILE | La ruta, dentro del contenedor, del archivo del que el cliente lee el token. |
volumes | Monta tu archivo auth-token en modo de solo lectura en esa ruta. |
Configurar Home Assistant OS o Supervised #
Home Assistant OS y Supervised ejecutan las apps mediante el Supervisor. La plantilla es una app local que copias al dispositivo.
-
Copia la carpeta de la app #
Extrae el ZIP. Copia la carpeta
home-assistant/localtonetal directorio de apps locales de tu Home Assistant, de modo que quede como/addons/localtonet. La carpeta contiene un solo archivo,config.json. No lo edites: nombra la app Localtonet, la imagendocker.io/localtonet/localtonety la versión para la que se creó este ZIP, y deja vacía la opciónauthtokenpara que la rellenes después. -
Recarga la tienda de apps e instala Localtonet #
Recarga la tienda de apps en Home Assistant para que encuentre la app local y luego instala Localtonet.
-
Introduce tu token e inicia la app #
Abre la página Configuration de la app, introduce tu AuthToken en la opción
authtokene inicia la app. Home Assistant oculta el valor como una contraseña. A partir de entonces, la app se inicia automáticamente junto con Home Assistant. -
Crea e inicia un túnel #
Crea un túnel con ese token en el panel y selecciona Iniciar. Para publicar el propio Home Assistant, crea un túnel HTTP a
127.0.0.1y al puerto en el que escucha tu Home Assistant. El puerto predeterminado de Home Assistant es8123. Home Assistant tiene sus propios ajustes para las solicitudes que llegan a través de un proxy; si las rechaza, consulta la documentación HTTP de Home Assistant.
La app usa la red de host, así que llega directamente a Home Assistant y a los demás dispositivos de tu red. Es compatible con las arquitecturas de Home Assistant amd64 y aarch64.
Home Assistant Container y Core no tienen Supervisor, así que no pueden instalar apps. En esas instalaciones, usa en su lugar la plantilla NAS / Docker Compose en el host de Docker.
El archivo home-assistant/repository.json queda fuera de la carpeta que copias y no forma parte de una instalación local. Contiene valores de marcador (DUMMY) para una URL de repositorio y un mantenedor; ignóralo.
Accede a tus servicios #
Ambas plantillas usan la red de host. En el campo Dirección IP local de un túnel:
127.0.0.1es el propio NAS o el propio host de Home Assistant. Úsalo para la interfaz web del NAS, Home Assistant o cualquier otro servicio de ese dispositivo, con el puerto en el que escucha ese servicio.- Una dirección de LAN como
192.168.1.20llega a otro dispositivo de tu red.
Un túnel iniciado es accesible desde internet. Antes de publicar la página de inicio de sesión de un NAS o Home Assistant, mantén contraseñas seguras y la verificación en dos pasos en el propio servicio, y considera las opciones de la página Control de acceso.
Registros y actualizaciones #
El contenedor escribe líneas de registro simples: el estado de su conexión, el nombre del token con el que inició sesión y una línea cada vez que se añade un túnel, cambia de estado o se elimina. Léelas en la vista de registros de tu gestor de contenedores, en la pestaña Log de la app en Home Assistant, o con:
docker compose logs -f localtonetLa línea Invalid Localtonet headless configuration. Check the token file or environment settings. significa que el cliente no encontró ningún token utilizable: el archivo del token falta o está vacío, todavía contiene DUMMY_AUTH_TOKEN, o el token no tiene 33 caracteres. Authentication failed: AuthToken was rejected. significa que el token tiene el formato correcto pero Localtonet no lo acepta.
Cada ZIP de plantillas se crea para una versión de Localtonet: el archivo de Compose la fija en la etiqueta de la línea image:, y la app de Home Assistant en el campo version de config.json. Para pasar un NAS a una versión más reciente, cambia la etiqueta por una versión que Docker Hub muestre para la imagen (consulta Docker) y ejecuta de nuevo docker compose up -d (o actualiza el proyecto en tu gestor de contenedores). Tu archivo auth-token se queda como está.
Páginas relacionadas #
NAS y Home Assistant
Plantillas de Docker Compose para Synology Container Manager, QNAP Container Station y otros NAS compatibles con Docker, además de una plantilla de app de Home Assistant para OS / Supervised. AMD64 y ARM64.
Son plantillas de instalación, no instaladores SPK / QPKG ni una publicación oficial en la tienda de Home Assistant. Debe haber una imagen de Docker compatible disponible en el registro. Los usuarios de Home Assistant Container / Core pueden usar la plantilla de Compose.
Configura tu NAS o Home Assistant
- Extrae el ZIP y lee
README.txt. - En un NAS, copia
nas/auth-token.exampleennas/auth-tokene introduce tu AuthToken. Mantén este archivo privado. - Comprueba la etiqueta de imagen en
nas/compose.yamly luego impórtalo como proyecto o ejecutadocker compose up -ddesde el directorionas. - En Home Assistant OS / Supervised, sigue las instrucciones de instalación de la app local del README e introduce el token en la configuración de la app.
Las plantillas usan la red del host de Linux para el acceso a la LAN. No activan privilegios de VPN.