docker-ddns
Servidor DNS dinámico autoalojado basado en Docker, Go y Bind9. Permite gestionar registros A/AAAA para acceder a dispositivos domésticos desde cualquier lugar mediante una API REST o integración directa con routers compatibles como Fritz!Box.
Ficha actualizada 18 sept 2026, 20:39 · upstream 9 oct 2022, 9:53 · release 1.5.0
Qué es docker-ddns
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
docker-ddns es una solución de software libre que implementa un servidor DNS dinámico utilizando la librería Bind9 y el lenguaje Go, empaquetado en contenedores Docker. Su objetivo principal es permitir a los usuarios conectar dispositivos locales, como servidores NAS o estaciones de trabajo, desde fuera de su red doméstica sin depender de servicios comerciales de DDNS. La instalación es sencilla mediante imágenes precompiladas en DockerHub o construcción desde el repositorio oficial, soportando tanto despliegues individuales como orquestación con Docker Compose para persistencia de datos.
El proyecto expone tres puertos principales: 53/TCP y 53/UDP para consultas DNS, y 8080/TCP para una API REST de gestión que facilita la actualización dinámica de registros mediante secretos compartidos. Esta API está diseñada para ser compatible con clientes estándar como ddclient y routers populares (Ubiquiti, D-Link), permitiendo configuraciones manuales o automáticas sin necesidad de modificar el firmware del dispositivo cliente.
A pesar de su simplicidad, requiere una configuración DNS delegada en la zona raíz del dominio para funcionar correctamente. Es crucial gestionar los permisos de escritura en el volumen persistente de Bind9 y evitar conflictos con servicios locales como systemd-resolved en distribuciones Linux que ocupen el puerto 53 por defecto.
- Acceso remoto seguro a servidores NAS o estaciones multimedia desde la red móvil
- Configuración de DDNS en routers domésticos sin soporte nativo (ej. Ubiquiti, D-Link)
- Sustitución de servicios comerciales de DNS dinámico para reducir costes mensuales
- Centralización de gestión de registros DNS mediante una API REST personalizada
- Implementación en Go con contenedorización Docker para alta eficiencia y ligereza
- Compatibilidad nativa con protocolos DynDNS (v1, v2, v3) y API REST propia
- Documentación detallada sobre integración con routers específicos y configuración DNS
- Soporte para persistencia de datos mediante volúmenes Docker para Bind9
- Requiere un servidor VPS propio con acceso a la zona DNS delegada
- Riesgo de seguridad si la API REST se expone directamente sin proxy inverso HTTPS
- Posibles conflictos en hosts Linux con systemd-resolved ocupando el puerto 53
- No incluye autenticación avanzada más allá del secreto compartido simple
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.
Persistir datos en /var/cache/bind y asegurar permisos de escritura para UID=0. Desactivar DNSStubListener en systemd-resolved si es necesario. Usar proxy inverso HTTPS antes de la API 8080. Delegar subdominio 'dyndns' o similar en el registro NS del dominio raíz.
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.