El DNS es un fuerte sospechoso cuando Home Assistant puede acceder a un servicio mediante la dirección IP, pero falla mediante el nombre de host; cuando los errores mencionan explícitamente la resolución de nombres o tiempos de espera de DNS; o cuando el mismo nombre de host se comporta de forma diferente desde distintas redes. Un mensaje genérico de «conexión fallida» por sí solo no lo demuestra.
Prueba el DNS desde la máquina y la ruta de red que realmente presentan el fallo. Que un portátil resuelva correctamente un nombre de host no demuestra que el equipo de Home Assistant, el contenedor, la aplicación móvil o el resolvedor local obtengan la misma respuesta.
Empieza con el nombre de host exacto indicado en el error
Lee el registro de Home Assistant o el error de Companion y anota el nombre de host exacto, no solo el nombre de la integración. Un rechazo de conexión, un error de TLS, un tiempo de espera y un fallo de búsqueda DNS pertenecen a capas diferentes.
La guía de conexión actual de Home Assistant indica que los routers, el DNS, el DHCP, los dispositivos inaccesibles y los servicios no disponibles son causas comunes de errores de conexión. El texto del registro debería indicar qué rama probar a continuación.
Si el error ya indica «name or service not known», «temporary failure in name resolution» o un tiempo de espera de DNS, pasa directamente a probar el resolvedor. Si indica «connection refused», es posible que el DNS ya haya funcionado y que el servicio remoto o el puerto sean los principales sospechosos.
Ejecuta pruebas de DNS desde la ruta de Home Assistant afectada
Usa dig o nslookup desde el equipo de Home Assistant, el contenedor u otro sistema que utilice el mismo resolvedor. Compara las direcciones devueltas con lo que esperas que represente el nombre de host.
La guía de solución de problemas de Companion recomienda usar dig y nslookup cuando Home Assistant informa de un tiempo de espera al buscar un nombre de host. Una búsqueda fallida desde el equipo afectado es una evidencia mucho más sólida que una búsqueda correcta desde otro cliente.
Repite la prueba varias veces si el fallo es intermitente. Un resolvedor que funciona una vez y agota el tiempo de espera en una de cada diez solicitudes aún puede provocar integraciones poco fiables.
Compara la accesibilidad mediante el nombre de host y mediante la IP directa
Cuando sea seguro y relevante para el servicio, prueba el destino mediante su dirección IP conocida. Si la ruta por IP funciona repetidamente mientras que la ruta por nombre de host falla, las pruebas apuntan al DNS o a un enrutamiento específico del nombre de host.
No lo consideres una prueba absoluta en servicios HTTPS o alojados mediante hosts virtuales. Los certificados TLS, los proxies inversos y las cabeceras Host pueden requerir el nombre de host aunque la IP subyacente sea accesible.
La guía de ZimaSpace sobre los fallos intermitentes de DNS en aplicaciones autoalojadas amplía esta prueba separando la latencia del resolvedor, las respuestas obsoletas, el DNS dividido y las rutas de resolución específicas de los contenedores.
Comprueba las respuestas A y AAAA
Un nombre de host puede resolverse correctamente y aun así elegir una familia de direcciones inutilizable. Por ejemplo, puede existir un registro AAAA mientras el enrutamiento IPv6 está averiado, lo que provoca largas esperas antes de recurrir a IPv4.
Los diagnósticos de DNS de Home Assistant señalan explícitamente los fallos del servidor DNS y la gestión incorrecta de las solicitudes A y AAAA. En Home Assistant OS, los mismos diagnósticos muestran el estado del resolvedor y las opciones de DNS de respaldo.
Compara por separado los resultados de A y AAAA y, después, prueba la conectividad mediante la familia de direcciones devuelta. No desactives IPv6 globalmente solo porque un nombre de host presente problemas; demuestra primero cuál es la ruta que falla.
Compara el DNS interno y externo cuando el fallo depende de la ubicación
Si un nombre de host de Home Assistant funciona con datos móviles, pero no con la Wi-Fi doméstica, o funciona dentro de la LAN, pero no de forma remota, compara la respuesta DNS desde ambas ubicaciones. El DNS dividido puede devolver intencionadamente una dirección privada dentro de la red y una dirección pública o de túnel fuera de ella.
Comprueba las anulaciones DNS del router, las reescrituras de Pi-hole o AdGuard, los nombres mDNS, los dominios de búsqueda locales, los registros DNS públicos y las cachés obsoletas. Un registro público correcto no puede corregir una anulación interna incorrecta, y un registro LAN correcto no puede hacer accesible desde internet una dirección privada.
Cambia una sola variable del resolvedor cada vez. Un resolvedor público temporal puede ser útil para diagnosticar nombres públicos, pero fijar permanentemente un DNS público no es una solución cuando el nombre de host debería resolverse hacia un servicio local privado.
Preguntas frecuentes
Si Home Assistant funciona mediante IP, pero no mediante el nombre de host, ¿el problema es definitivamente el DNS?
Es una evidencia sólida, pero no una prueba absoluta. Los certificados HTTPS, los proxies inversos, los hosts virtuales y las reglas de enrutamiento pueden comportarse de forma diferente al omitir el nombre de host. Confirma conjuntamente la respuesta DNS y la ruta de la aplicación.
¿Debería cambiar permanentemente Home Assistant a 8.8.8.8 o 1.1.1.1?
No automáticamente. Los resolvedores públicos son útiles para probar nombres públicos, pero no pueden resolver registros privados de DNS dividido a menos que esos registros se publiquen intencionadamente en otro lugar. Corrige el resolvedor que debería tener autoridad sobre el nombre que presenta el fallo.
Soporte y Consejos
Más para leer

Señales de que una base de datos de Home Assistant necesita mantenimiento o reemplazo
Una base de datos grande de Home Assistant normalmente requiere tareas de retención o depuración; la corrupción o los errores de integridad recurrentes son...

¿Cuántos usuarios simultáneos puede gestionar Home Assistant antes de ralentizarse?
Home Assistant no tiene un límite fijo de usuarios que resulte útil: evalúa el rendimiento con clientes activos, paneles reales y actualizaciones de entidades,...

¿Puede Home Assistant usar una base de datos externa sin complicar las actualizaciones?
Una base de datos externa de Recorder puede sobrevivir a las actualizaciones, pero añade sus propias responsabilidades de disponibilidad, migración de esquemas, copias de...

