docker-netbootxyz
Imagen Docker para desplegar netboot.xyz como servidor PXE local. Permite arrancar sistemas operativos desde red sin medios físicos, usando Alpine Linux, Node.js y Nginx. Incluye interfaz web para gestión de menús y soporte para Secure Boot.
Ficha actualizada 18 sept 2026, 21:20 · upstream 18 sept 2026, 19:09 · release sin release detectada
Qué es docker-netbootxyz
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este contenedor facilita la implementación de un servidor de arranque en red (PXE) basado en netboot.xyz, eliminando la necesidad de unidades ópticas o USB para instalaciones iniciales. Construido sobre Alpine Linux, integra una aplicación web en Node.js/Next.js para edición de menús en tiempo real, Nginx para servir activos locales y tftp-hpa para transferencias de archivos. El sistema está diseñado para funcionar tanto en entornos x86-64 como ARM, manteniendo un perfil de recursos bajo (1 CPU, 1GB RAM).
La arquitectura requiere un servidor DHCP externo preconfigurado para dirigir los clientes hacia la IP del contenedor mediante las opciones next-server y boot-file-name. Los servicios internos se gestionan con supervisord, asegurando la estabilidad de componentes como el servidor web y el registro de actividad syslog. Además, soporta descargas de activos desde repositorios remotos o espejos locales para acelerar el proceso de arranque en redes lentas.
Para despliegues productivos, es crucial configurar correctamente los permisos de volúmenes mediante las variables PUID y PGID para evitar problemas de acceso a archivos en /config y /assets. La imagen incluye imágenes firmadas de iPXE para UEFI Secure Boot, garantizando la integridad del proceso de arranque sin comprometer la seguridad del firmware.
- Instalación de sistemas operativos en máquinas sin unidad óptica o lector USB
- Creación de laboratorios de pruebas con múltiples arquitecturas (x86, ARM, EFI)
- Gestión centralizada de menús de arranque mediante interfaz web
- Despliegue seguro en entornos corporativos con UEFI Secure Boot activo
- Recuperación de hardware bloqueado o sin medios de instalación disponibles
- Espejo local de activos para reducir latencia en redes internas
- Soporte nativo para arquitecturas x86, ARM y Raspberry Pi 4
- Imágenes iPXE firmadas para compatibilidad con UEFI Secure Boot
- Interfaz web intuitiva para edición dinámica de menús de arranque
- Bajo consumo de recursos (Alpine Linux) ideal para hardware limitado
- Persistencia de datos mediante volúmenes montables en /config y /assets
- Gestión de servicios robusta con supervisord y logging vía syslog
- No incluye servidor DHCP propio; requiere configuración externa (dnsmasq, router)
- Dependencia de conexión a internet para descargar activos iniciales sin espejo local
- Configuración manual obligatoria de permisos de usuario (PUID/PGID) en volúmenes
- Puertos UDP 69 y TCP 80/3000 deben estar abiertos en firewalls corporativos
- No soporta ejecución nativa sin contenedor Docker o Podman
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.
Configurar servidor DHCP externo (ej. dnsmasq) apuntando a la IP del contenedor como next-server. Montar volúmenes persistentes para /config y /assets en el host. Asegurar que los puertos 69/udp, 80/tcp y 3000/tcp estén accesibles. Usar variables de entorno PUID=1000 y PGID=1000 si los volúmenes no son del usuario root. Para espejo local, modificar boot.cfg con la IP del servidor en lugar de GitHub. Verificar compatibilidad de firmware UEFI antes de usar imágenes firmadas.
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.