Duck DNS: un nombre fijo para entrar a tu casa desde fuera

Descripción general

Duck DNS es un servicio gratuito que te da un subdominio del tipo tucasa.duckdns.org. La integración oficial actualiza tu IP pública en Duck DNS cada 5 minutos, así que el nombre sigue funcionando aunque tu operador te cambie la IP. También puede escribir el registro TXT del subdominio, que se usa para validar certificados SSL por DNS.

Esquema: Home Assistant envía su IP pública a Duck DNS cada 5 minutos y el móvil desde fuera entra por tucasa.duckdns.org — Un nombre que siempre apunta a tu casa.

Esquema: NODARA.

Requisitos

Una cuenta en duckdns.org, un subdominio y tu token, que aparecen al iniciar sesión.
Ajustes → Dispositivos y servicios → Añadir integración → Duck DNS. Escribe el subdominio sin .duckdns.org y el token.
Si ya usas la app Duck DNS (antes, complemento), no necesitas esta integración: la app ya mantiene la IP.
Duck DNS solo resuelve el nombre. Para entrar desde fuera necesitas además abrir el puerto en el router y un certificado SSL. Si no quieres abrir puertos, mira Home Assistant Cloud.
Fuente: documentación oficial de Duck DNS.

Ideas de uso

Entrar desde la app Companion fuera de casa con https://tucasa.duckdns.org:8123.
Certificados SSL por DNS (reto ACME DNS-01) sin exponer el puerto 80. Es el ejemplo de abajo.
Acceder a otros servicios de casa (una cámara, un NAS) con el mismo nombre y otro puerto.
Sobrevivir a los cambios de IP de los operadores que no dan IP fija.

Ejemplo de uso

Dos scripts que un cliente ACME (como acme.sh o Certbot) puede llamar por la API de Home Assistant: uno publica el reto y otro lo borra.

publicar_reto_acme:
  alias: "Publicar reto ACME en Duck DNS"
  fields:
    reto:
      description: "Valor TXT que pide el cliente ACME"
      required: true
      selector:
        text:
  sequence:
    - action: duckdns.set_txt
      data:
        config_entry_id: TU_CONFIG_ENTRY_ID
        txt: "{{ reto }}"

borrar_reto_acme:
  alias: "Borrar reto ACME de Duck DNS"
  sequence:
    # Sin «txt», el registro se vacía.
    - action: duckdns.set_txt
      data:
        config_entry_id: TU_CONFIG_ENTRY_ID

Cómo funciona:

duckdns.set_txt escribe el registro TXT de tu subdominio. Si no le pasas txt, lo borra.
config_entry_id identifica tu integración Duck DNS. En el editor visual de la acción la eliges en una lista; dejarlo vacío está obsoleto.
La IP se sigue actualizando sola cada 5 minutos. Tras un corte largo de Internet puede tardar hasta 30 minutos en volver a apuntar a tu IP.
Si regeneras el token en Duck DNS, actualízalo en la integración: los errores no siempre dicen que el fallo es de autenticación.

Acción

script.publicar_reto_acme con reto = "LoqXcYV8…"

Resultado

TXT de tucasa.duckdns.org = "LoqXcYV8…"
la autoridad valida el dominio y emite el certificado