Netboot.xyz
Servidor PXE/iPXE local para arrancar instaladores y utilidades por red.
Resumen
Netboot.xyz sirve por TFTP el binario iPXE (netboot.xyz.kpxe) y encadena los
menús de netboot.xyz; permite arrancar por PXE cualquier equipo de la LAN sin
USB ni ISO. Se usa para instalar sistemas y lanzar
utilidades de rescate. El DHCP sigue en el gateway UniFi; este servicio solo
responde TFTP y publica una UI para gestionar menús.
Estado
| Campo |
Valor |
| Estado |
Operativo |
| Argo CD Application |
netbootxyz |
| Namespace |
netbootxyz |
Despliegue
| Campo |
Valor |
| Método |
Manifiestos (Argo CD) |
| Chart / imagen |
ghcr.io/netbootxyz/netbootxyz:0.7.6-nbxyz27 |
| Origen |
clusters/luka/config/netbootxyz |
| Config en el repo |
clusters/luka/apps/netbootxyz/, clusters/luka/config/netbootxyz/, clusters/luka/config/traefik-routes/netbootxyz-* y clusters/luka/config/authentik/blueprints.yaml |
Red
| Campo |
Valor |
| Service |
netbootxyz (ClusterIP, UI) y netbootxyz-pxe (LoadBalancer) |
| IP |
192.168.20.62 (MetalLB, PXE) |
| Puertos |
69/udp y 80/tcp en .62 (PXE); 3000/tcp ClusterIP (UI) |
| URL interna |
https://netbootxyz.local.gorkarevilla.com |
| URL externa |
— (solo LAN) |
| TLS |
cert-manager wildcard *.local.gorkarevilla.com |
- DHCP red Default:
next-server 192.168.20.62, filename netboot.xyz.kpxe.
- Firewall:
Internal → 192.168.20.62 UDP 69 y TCP 80.
Acceso y usuarios
- Usuarios/roles: solo el grupo
admins de Authentik.
- Credenciales: no hay credenciales propias; el SSO es Authentik.
- Break-glass:
kubectl -n netbootxyz port-forward deploy/netbootxyz 3000:3000 (sin SSO).
Configuración
TFTPD_OPTS=--tftp-single-port: todo el TFTP por el 69/udp para atravesar
kube-proxy/MetalLB (la imagen de linuxserver no lo soporta).replicas: 1, strategy: Recreate (estado en PVC).- Corre como root para bindear 69/80;
allowPrivilegeEscalation: false y
seccomp RuntimeDefault.
Almacenamiento
netbootxyz-config (2 GiB, Longhorn): menús iPXE y estado de la webapp.netbootxyz-assets (5 GiB, Longhorn): reservado para espejo local de assets
(hoy vacío; los kernels salen de los mirrors upstream).
Dependencias
- Depende de: MetalLB (IP
.62), Traefik/Gateway API, Authentik, Longhorn,
cert-manager (TLS wildcard).
- Usado por: clientes PXE de la VLAN Default; en Clientes el tráfico a
Servidores está permitido, pero el DHCP de PXE no está configurado allí.
Backup y recuperación
—. El contenido es regenerable desde upstream; no se hace backup.
Monitorización
- No expone métricas Prometheus nativas; no hay
ServiceMonitor.
- La disponibilidad se comprueba con TFTP (
get netboot.xyz.kpxe) y arranque
PXE real.
Referencias
Notas / TODO
- Soporte UEFI/ARM en DHCP (hoy solo BIOS legacy con
netboot.xyz.kpxe).
- Activar espejo local de assets si se quiere acelerar el arranque.