Saltar al contenido
Localtonet Localtonet Panel

Ejecutar Localtonet en un NAS o en Home Assistant

Plantillas de configuración AMD64 y ARM64

Ayuda con esta página
En esta página 7 secciones
  1. Qué son las plantillas
  2. Lo que no son
  3. Antes de empezar
  4. Configurar un NAS con Docker Compose
  5. Extrae el ZIP y copia la carpeta nas al NAS
  6. Crea el archivo del token
  7. Deja compose.yaml como está
  8. Inicia el proyecto
  9. Crea e inicia un túnel
  10. Qué hace la plantilla de Compose
  11. Configurar Home Assistant OS o Supervised
  12. Copia la carpeta de la app
  13. Recarga la tienda de apps e instala Localtonet
  14. Introduce tu token e inicia la app
  15. Crea e inicia un túnel
  16. Accede a tus servicios
  17. Registros y actualizaciones
  18. 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 enArchivosQué 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 Corenas/compose.yaml y nas/auth-token.exampleSolo 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 Supervisedhome-assistant/localtonet/config.json, la definición de una app local (antes llamada complemento), y home-assistant/repository.jsonNada 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 #

  1. Extrae el ZIP y copia la carpeta nas al NAS #

    Extrae el archivo en tu ordenador. Copia la carpeta nas a una carpeta compartida del NAS que pueda usar tu gestor de contenedores.

  2. Crea el archivo del token #

    En la carpeta nas, copia auth-token.example a auth-token. Abre auth-token y sustituye DUMMY_AUTH_TOKEN por 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.

  3. Deja compose.yaml como está #

    No necesitas editar compose.yaml. Su línea image: nombra la imagen de Localtonet y la versión para la que se creó este ZIP, por ejemplo docker.io/localtonet/localtonet:8.6.0. Las demás líneas se explican en Qué hace la plantilla de Compose.

  4. Inicia el proyecto #

    Importa compose.yaml como proyecto en tu gestor de contenedores e inícialo:

    • Synology: en Container Manager, crea un proyecto a partir de la carpeta nas y su compose.yaml.
    • QNAP: en Container Station, crea una aplicación a partir de compose.yaml. El archivo monta ./auth-token relativo 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.
    Bash
    docker compose up -d

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

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

nas/compose.yaml
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
AjusteQué hace
imageLa 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-stoppedDocker vuelve a iniciar el contenedor después de un reinicio o un fallo, a menos que lo hayas detenido tú.
network_mode: hostEl 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_HEADLESSEjecuta el cliente sin preguntas, con líneas de registro simples.
LOCALTONET_AUTH_TOKEN_FILELa ruta, dentro del contenedor, del archivo del que el cliente lee el token.
volumesMonta 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.

  1. Copia la carpeta de la app #

    Extrae el ZIP. Copia la carpeta home-assistant/localtonet al 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 imagen docker.io/localtonet/localtonet y la versión para la que se creó este ZIP, y deja vacía la opción authtoken para que la rellenes después.

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

  3. Introduce tu token e inicia la app #

    Abre la página Configuration de la app, introduce tu AuthToken en la opción authtoken e 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.

  4. 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.1 y al puerto en el que escucha tu Home Assistant. El puerto predeterminado de Home Assistant es 8123. 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.1 es 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.20 llega 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:

Bash
docker compose logs -f localtonet

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

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
  1. Extrae el ZIP y lee README.txt.
  2. En un NAS, copia nas/auth-token.example en nas/auth-token e introduce tu AuthToken. Mantén este archivo privado.
  3. Comprueba la etiqueta de imagen en nas/compose.yaml y luego impórtalo como proyecto o ejecuta docker compose up -d desde el directorio nas.
  4. 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.

Soporte