Pi-hole-Unbound-PiAlert-Setup
Suite de instalación y gestión para Pi-hole + Unbound en Raspberry Pi (Debian). Proporciona bloqueo de anuncios, resolución DNS segura con DNSSEC y herramientas de mantenimiento/rescate mediante scripts bash.
Ficha actualizada 28 sept 2026, 0:12 · upstream 27 sept 2026, 23:43 · release sin release detectada
Qué es Pi-hole-Unbound-PiAlert-Setup
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio ofrece una solución completa para desplegar un stack de seguridad DNS en servidores Debian/Ubuntu o Raspberry Pi. Combina Pi-hole (v6.x) para el bloqueo de anuncios y trackers con Unbound configurado como resolutivo recursivo local, validando DNSSEC sin depender de terceros. La arquitectura sigue la cadena Client → Pi-hole (53) → Unbound (5335) → Internet.
El instalador automatiza la configuración inicial, pero requiere que el usuario ejecute el script con sudo y como un usuario normal (no root). Incluye tres interfaces de gestión: un menú interactivo para tareas diarias, un menú de rescate para recuperación de fallos DNS y una herramienta de mantenimiento por lotes. También ofrece una API REST opcional en FastAPI para monitorización avanzada.
Las herramientas de rescute permiten restaurar configuraciones conocidas como buenas, realizar copias de seguridad manuales o reconfigurar el upstream de Pi-hole si se rompe la conexión con Unbound. Es ideal para entornos domésticos o pequeños servidores donde se requiere control total y simplicidad operativa.
- Despliegue rápido de bloqueo de anuncios y resolución DNS segura en Raspberry Pi 3/4/5
- Gestión diaria de servicios DNS mediante menú interactivo sin necesidad de línea de comandos compleja
- Recuperación rápida ante fallos de DNS con opciones de bypass o restauración de última configuración válida
- Monitorización básica de la red y estado del sistema a través de scripts de diagnóstico integrados
- Instalación automatizada que configura Pi-hole, Unbound y la cadena DNS correcta en un solo paso
- Herramientas de rescate robustas para restaurar configuraciones o reconfigurar el upstream de Pi-hole
- API REST opcional en FastAPI para monitorización JSON sin exponer servicios al exterior por defecto
- Scripts de mantenimiento programable (actualizaciones, gravedad, escaneos de seguridad) con flags granulares
- No utiliza Docker ni Compose; requiere gestión manual de dependencias y paquetes del sistema
- La API opcional debe configurarse manualmente con claves seguras y no está habilitada por defecto
- Requiere Debian Bookworm/Trixie o Raspberry Pi OS compatible, sin soporte para otras distribuciones
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.
Instalar como usuario normal (ej. 'pi') ejecutando sudo ./install.sh. Verificar que Pi-hole use Unbound en 127.0.0.1#5335 tras la instalación. Para API opcional, crear .env con SUITE_API_KEY y activar el entorno virtual Python. Actualizar manualmente durante ventanas de mantenimiento usando pihole -up o apt list --upgradable.
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.