proxmox-service-discovery
Servidor DNS que descubre automáticamente VMs y contenedores (LXCs) en un clúster Proxmox, creando registros A y AAAA para acceso por nombre en lugar de IP.
Ficha actualizada 18 sept 2026, 21:38 · upstream 3 jul 2026, 2:13 · release sin release detectada
Qué es proxmox-service-discovery
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Proxmox Service Discovery es un servidor DNS escrito en Go que monitorea un clúster Proxmox mediante su API REST. Detecta automáticamente el estado de las máquinas virtuales (QEMU) y contenedores (LXC), creando registros DNS dinámicos cuando estos se inician, detienen o modifican sus direcciones IP.
El software soporta tanto IPv4 como IPv6, permitiendo la creación de registros A y AAAA. Incluye un sistema de filtrado flexible basado en tipos de recurso, etiquetas y rangos CIDR para controlar qué recursos aparecen en las zonas DNS configuradas. También proporciona una interfaz web de depuración para inspeccionar los registros activos.
La autenticación se realiza mediante credenciales PAM o tokens de API, recomendándose el uso de tokens con permisos limitados (como PVEAuditor) para seguridad. El programa puede ejecutarse como servicio systemd en Linux y soporta persistencia de caché para evitar pérdida de estado tras fallos de conexión.
- Acceder a VMs y contenedores Proxmox por nombre (ej: vm-web.lab.local) en lugar de direcciones IP estáticas
- Integración con servidores DNS existentes como BIND o PowerDNS para resolución dinámica de recursos virtualizados
- Aislamiento de redes mediante filtrado CIDR para excluir direcciones privadas o VPNs del registro DNS público
- Monitoreo visual de estado de recursos mediante la interfaz web de depuración en puerto 8080
- Descubrimiento automático de VMs y contenedores sin intervención manual
- Soporte nativo para IPv4 (A) e IPv6 (AAAA)
- Filtrado por etiquetas, tipo de recurso y rangos CIDR
- Interfaz web de depuración incluida en puerto 8080
- Persistencia de caché opcional para resiliencia ante fallos de API
- Requiere acceso a la API de Proxmox con permisos de lectura adecuados
- No incluye dependencias externas ni contenedores Docker nativos
- La verificación TLS puede desactivarse (--tls-no-verify) pero no se recomienda
- Depende de que el clúster Proxmox esté accesible desde la red del servidor DNS
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 binario o compilar con Go. Configurar como servicio systemd en /etc/systemd/system/. Usar tokens de API en lugar de contraseñas. Habilitar CAP_NET_BIND_SERVICE para escuchar en puerto 53. Asegurar que el servidor DNS tenga acceso a la API de Proxmox y configurar zona DNS externa.
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.