pihole-unbound-docker
Configuración Docker Compose que combina Pi-hole con Unbound como DNS recursivo local, ofreciendo filtrado de anuncios, malware y privacidad sin depender de servidores externos.
Ficha actualizada 18 sept 2026, 21:32 · upstream 17 feb 2024, 4:41 · release sin release detectada
Qué es pihole-unbound-docker
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una solución completa para autogestionar un servidor DNS seguro en el hogar o en entornos pequeños. Utiliza dos contenedores Docker: uno para Pi-hole (filtrado de anuncios y bloqueo de malware) y otro para Unbound (resolución recursiva de DNS). La arquitectura está diseñada para mantener ambos servicios separados, facilitando las actualizaciones independientes de cada componente y minimizando la complejidad de configuración.
La solución se basa en imágenes oficiales de Pi-hole y una imagen personalizada de MatthewVance para Unbound, lo que permite un despliegue sencillo mediante docker-compose. El sistema está pensado para ser accesible 24/7 desde cualquier cliente de la red local, requiriendo solo Docker Compose v2 instalado previamente. La configuración se gestiona principalmente a través de variables de entorno en un archivo .env y archivos de configuración específicos para cada servicio.
- Bloqueo de anuncios y malware en toda la red doméstica mediante Pi-hole
- Resolución recursiva de DNS local con Unbound para mejorar la privacidad y reducir latencia
- Implementación en servidores NAS o dispositivos IoT como alternativa a proveedores externos
- Configuración de registros A locales para dominios internos sin depender de resolvers externos
- Uso de imágenes oficiales de Pi-hole para garantizar compatibilidad y actualizaciones seguras
- Arquitectura modular que permite actualizar cada componente independientemente
- Soporte para persistencia de datos mediante volúmenes Docker configurables en docker-compose.yml
- Documentación clara con ejemplos de configuración avanzada como A-records locales y ajuste de Unbound
- No soporta arquitectura ARM (ej. Raspberry Pi) sin modificar manualmente el Dockerfile de Unbound
- Watchtower no es compatible con la imagen actual de Unbound debido a su construcción stateless
- Requiere configuración manual de persistencia para evitar pérdida de datos tras reinicios
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.
Requiere Docker Compose v2 y al menos 2 núcleos CPU/2GB RAM. Cambiar el DNS por defecto del sistema a la IP del servidor es obligatorio. Para producción, configurar volúmenes persistentes en /etc/pihole/ y /etc/dnsmasq.d/. Verificar compatibilidad de arquitectura antes de desplegar.
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.