external-dns-provider-adguard
Proveedor webhook para ExternalDNS que gestiona reglas de filtrado en AdGuard Home dentro de Kubernetes, permitiendo sincronización automática de registros DNS.
Ficha actualizada 25 sept 2026, 0:17 · upstream 24 sept 2026, 23:51 · release v1.5.1
Qué es external-dns-provider-adguard
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa un proveedor webhook para ExternalDNS, facilitando la integración con AdGuard Home. La solución permite gestionar reglas de filtrado basadas en las directrices oficiales de AdGuard Home, asegurando que el proveedor solo gestione las reglas creadas por él mismo sin afectar a las existentes.
Está diseñado específicamente para entornos Kubernetes, integrándose con ExternalDNS mediante la API webhook. El despliegue se realiza típicamente junto con una instancia de ExternalDNS, utilizando imágenes Docker y variables de entorno para autenticación con AdGuard Home (URL, usuario y contraseña). Soporta tanto despliegues nativos como a través de Helm charts oficiales.
La implementación está escrita en Go y requiere un puerto 8888 para la comunicación webhook. Es compatible con versiones recientes de ExternalDNS (hasta v0.19.0) y AdGuard Home (hasta v0.107.62), permitiendo una gestión dinámica de registros DNS al detectar cambios en servicios o Ingresses.
- Automatizar la creación y eliminación de registros DNS en AdGuard Home al escalar o eliminar servicios en Kubernetes.
- Gestionar reglas de filtrado personalizadas para dominios específicos dentro de una infraestructura autoalojada.
- Integrar ExternalDNS con AdGuard Home sin necesidad de modificar manualmente las reglas de filtrado.
- Implementar un sistema de DNS dinámico que respeta la jerarquía de reglas de AdGuard Home.
- Gestión estricta del ciclo de vida de las reglas de filtrado, evitando conflictos con reglas preexistentes.
- Compatibilidad verificada con ExternalDNS v0.19.0 y AdGuard Home v0.107.62.
- Soporte para despliegue vía Helm chart oficial con gestión segura de credenciales mediante Secrets.
- Implementación en Go, garantizando rendimiento y portabilidad en entornos Kubernetes.
- Requiere una instancia externa de ExternalDNS configurada previamente para funcionar como proveedor webhook.
- La compatibilidad está limitada a versiones específicas de AdGuard Home y ExternalDNS mencionadas en el README.
- Necesita acceso de red al puerto 8888 del proveedor y al controlador de AdGuard Home (puerto 3000).
- No incluye soporte para Compose, requiriendo despliegue manual o Helm.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue en Kubernetes junto con ExternalDNS. Configurar variables ADGUARD_HOME_URL, ADGUARD_HOME_USER y ADGUARD_HOME_PASS mediante Secrets. Asegurar que el servicio de AdGuard Home esté accesible desde la red del cluster (puerto 3000). El proveedor escucha en localhost:8888 dentro del pod. Verificar registros en 'Filters' > 'Custom filtering rules' de AdGuard Home tras crear un servicio con anotación external-dns.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.