adguard-sync-mdw
Herramienta ligera para sincronizar configuración de múltiples servidores AdGuard Home desde un primario a seguidores, usando API HTTP y detección de desviación.
Ficha actualizada 26 sept 2026, 4:42 · upstream 26 sept 2026, 4:21 · release v1.2.2
Qué es adguard-sync-mdw
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
AdGuard Sync es una herramienta basada en contenedores que mantiene la configuración de uno o más servidores AdGuard Home alineada con un servidor primario. Utiliza exclusivamente la API HTTP de control de AdGuard Home para replicar listas de bloqueo, reglas personalizadas, reescrituras DNS y configuraciones de upstream sin editar archivos locales del servidor objetivo.
El sistema opera mediante un bucle de polling que detecta cambios entre el primario y los seguidores antes de aplicarlos. Incluye una interfaz web construida con FastAPI y HTMX que permite visualizar el estado, la historia de sincronizaciones y las desviaciones (drift). La configuración se gestiona a través de un archivo YAML o directamente desde el panel de control, con soporte para TLS por defecto y gestión segura de credenciales mediante variables de entorno.
La herramienta soporta despliegue en entornos heterogéneos gracias a imágenes multi-arquitectura (amd64, arm64) y ofrece modos de seguridad como 'dry-run' para validar cambios antes de aplicarlos. La persistencia de datos se realiza mediante SQLite local, gestionando historial de cambios y registros de desviación.
- Centralizar la gestión de listas de bloqueo en un servidor primario y replicarlas automáticamente a múltiples nodos downstream.
- Mantener consistencia en reglas personalizadas y reescrituras DNS entre instancias de AdGuard Home distribuidas geográficamente.
- Auditar cambios de configuración mediante el registro de desviaciones (drift) antes de aplicar actualizaciones en seguidores.
- Operar entornos de producción con validación previa de cambios mediante el modo dry-run para evitar modificaciones no deseadas.
- Sincronización completa bidireccional: añade, actualiza, reemplaza o elimina elementos en seguidores basándose en el primario.
- Detección automática de desviación (drift) que registra diferencias antes de aplicar cambios para auditoría.
- Interfaz web moderna con FastAPI y HTMX que incluye modo oscuro/claro y gestión de configuración en vivo.
- Soporte nativo para sincronización de servicios bloqueados (blocked-services) desde AdGuard Home v0.107.x o superior.
- Seguridad por defecto: HTTPS auto-firmado, credenciales en variables de entorno y autenticación básica opcional.
- Imágenes multi-arquitectura disponibles para x86, ARM (Raspberry Pi) y NAS.
- Dependencia de la API HTTP de AdGuard Home; no soporta versiones anteriores a v0.107.x para sincronización de servicios bloqueados.
- No edita archivos de configuración local del servidor AdGuard (AdGuardHome.yaml), operando exclusivamente vía API.
- El historial de datos se almacena en SQLite local, lo que puede requerir gestión manual de copias de seguridad de la base de datos.
- La sincronización es unidireccional (primario a seguidores); cambios manuales en seguidores no se propagan al primario.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Desplegar con Docker o Compose. Usar modo dry-run inicialmente para validar cambios. Montar certificados TLS propios si se requiere validación de CA externa. Configurar autenticación básica (DASHBOARD_USER/DASHBOARD_PASSWORD) si el puerto 8080 está expuesto a redes no confiables. Asegurar que los volúmenes /config y /data sean legibles por el contenedor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.