Llevo ya un año usando NetBox de forma continua, y si tuviera que resumir en una frase lo que ha cambiado en mi forma de trabajar, sería esta: he dejado de fiarme de mi memoria y de hojas de Excel para saber qué IP tengo libre o en qué rack está montado cada equipo. Antes de NetBox, la documentación de red era ese proyecto eterno que «algún día» iba a ponerse al día, y que en la práctica siempre acababa desactualizado a las pocas semanas.
NetBox lo cambió por completo. Es una herramienta de código abierto pensada específicamente para el inventario de redes, que combina en una sola plataforma la gestión de direcciones IP (IPAM) y la gestión de infraestructura física de centros de datos (DCIM). En esta entrada te cuento qué es exactamente, para qué sirve, qué ventajas tiene frente a llevar todo esto en hojas de cálculo, con qué otros sistemas se integra y cómo los plugins amplían todavía más lo que puedes hacer con ella. Todo desde la experiencia real de tenerla funcionando en producción desde hace un año.
Índice
- ¿Qué es NetBox?
- Para qué sirve NetBox en el día a día
- Ventajas de usar NetBox frente a hojas de cálculo o documentación manual
- Tabla: qué puedes gestionar con NetBox
- Integraciones con otros sistemas
- Plugins: cómo extender NetBox más allá de lo básico
- Mi experiencia tras un año usando NetBox
- Conclusión
1. ¿Qué es NetBox?
NetBox es una plataforma de código abierto para la gestión de infraestructura de red e IPAM (IP Address Management), originalmente desarrollada por DigitalOcean para resolver un problema muy concreto: la mayoría de herramientas de gestión de infraestructura física (DCIM) y las de gestión de direcciones IP (IPAM) existían por separado, obligando a los equipos de red a ir saltando entre sistemas distintos para tener una imagen completa de su infraestructura.
NetBox une ambos mundos en una sola plataforma, funcionando como lo que en el sector se conoce como «fuente de verdad» (source of truth): un sistema único y autoritativo donde queda registrado, de forma estructurada, todo lo relacionado con tu infraestructura de red, desde el espacio de direcciones IP hasta la posición exacta de cada dispositivo dentro de un rack físico.
Hoy en día, NetBox está mantenido activamente por NetBox Labs, cuenta con una comunidad enorme en GitHub, y se ha convertido en el estándar de facto para equipos de ingeniería de redes, proveedores de servicios (ISPs), operadores de centros de datos y equipos de automatización de infraestructura en todo el mundo.
2. Para qué sirve NetBox en el día a día
En la práctica, NetBox sirve para responder rápidamente a preguntas que, sin una herramienta así, obligan a bucear en varios documentos, tickets antiguos o preguntar a la persona que «se acuerda de todo»: ¿dónde está físicamente este servidor?, ¿qué IPs tengo libres en esta subred?, ¿qué cable conecta este puerto con el switch del rack de al lado?, ¿qué dispositivos dependen de este circuito de operador si se cae?
El flujo de trabajo típico con NetBox empieza modelando la jerarquía de tu infraestructura: regiones, sedes, racks, dispositivos, interfaces, prefijos IP, VLANs y circuitos. A medida que ese modelo de datos crece, NetBox conecta la infraestructura física con el diseño lógico de la red, permitiendo trazar relaciones que antes vivían en documentos separados y desconectados entre sí.
Además, al exponer todos estos datos a través de una API REST, NetBox deja de ser solo documentación pasiva y se convierte en la base de datos que alimenta scripts de automatización, pipelines de validación, generación de configuraciones e inventarios dinámicos para herramientas como Ansible.
3. Ventajas de usar NetBox frente a hojas de cálculo o documentación manual
- Datos estructurados, no texto libre. Una hoja de Excel no impide que alguien escriba una IP mal formateada o repita una dirección ya asignada. NetBox valida los datos según un modelo relacional: no puedes asignar dos veces la misma IP dentro de la misma VRF, por ejemplo.
- Una única fuente de verdad. Cuando todo el equipo confía en que «si está en NetBox, es correcto», se elimina el problema clásico de tener media documentación en un Excel, otra media en un Visio y el resto en la cabeza de una sola persona.
- API para automatización real. Puedes generar inventarios dinámicos para Ansible, disparar webhooks cuando cambia un estado, o alimentar pipelines de validación de configuración directamente desde los datos de NetBox, algo que una hoja de cálculo nunca podrá ofrecerte.
- Historial de cambios. NetBox registra quién ha modificado qué y cuándo, algo esencial en auditorías o cuando necesitas entender por qué una configuración cambió.
- Visualización de racks y cableado. Puedes ver la elevación visual de un rack (rack diagram), qué dispositivos ocupan cada posición, y seguir visualmente qué cable conecta cada interfaz, algo que en una hoja de cálculo simplemente no existe.
- Escalable de forma progresiva. No hace falta modelar toda tu infraestructura de golpe: el principio recomendado por la propia comunidad es priorizar completitud sobre amplitud. Es mejor tener el IPAM completo y fiable al 100% que tener IPAM, DCIM y circuitos todos a medias y sin que nadie confíe en los datos.
4. Tabla: qué puedes gestionar con NetBox
| Módulo | Qué gestiona | Ejemplos concretos |
|---|---|---|
| IPAM | Direcciones IP y espacio de red | Prefijos, subredes, VLANs, VRFs, agregados, asignación de IPs a interfaces |
| DCIM | Infraestructura física | Regiones, sedes, salas, racks, dispositivos, fabricantes, modelos, número de serie, posición en rack |
| Cableado | Conexiones físicas | Cables entre interfaces, tipo de cable, longitud, trazabilidad extremo a extremo |
| Circuitos | Conectividad con proveedores | Circuitos de operador, proveedores, terminaciones, ancho de banda contratado |
| Virtualización | Infraestructura virtual | Clústeres, hosts virtuales, máquinas virtuales, interfaces virtuales |
| Organización | Estructura multi-cliente/multi-sede | Tenants (inquilinos), grupos de tenants, roles de dispositivo |
| Automatización | Contexto para generación de configuración | Config contexts, plantillas de configuración, datos personalizados por dispositivo |
| API y eventos | Integración con otros sistemas | API REST y GraphQL, webhooks, exportación de datos |
5. Integraciones con otros sistemas
Uno de los grandes puntos fuertes de NetBox es que no pretende sustituir todas las herramientas de tu stack, sino convertirse en la fuente de datos que las alimenta a todas. Algunas de las integraciones más habituales:
- Ansible: NetBox puede actuar como inventario dinámico, de forma que tus playbooks obtienen la lista de dispositivos, IPs y variables directamente desde NetBox en lugar de un archivo de inventario estático que hay que mantener a mano.
- Herramientas de monitorización (Zabbix, LibreNMS, Checkmk, entre otras): muchas se integran con NetBox para poblar automáticamente sus propios inventarios de dispositivos a monitorizar, evitando duplicar el trabajo de dar de alta cada equipo dos veces.
- Sistemas de gestión de configuración y CI/CD: mediante la API REST y GraphQL, NetBox puede alimentar pipelines de validación que comprueben, por ejemplo, que la configuración real de un dispositivo coincide con lo que NetBox tiene documentado como «estado deseado».
- Webhooks: NetBox puede notificar automáticamente a sistemas externos (por ejemplo, un sistema de tickets o un canal de Slack/Teams) cada vez que se produce un cambio relevante, como la creación de un nuevo dispositivo o la modificación de un prefijo IP.
- Terraform: existe un proveedor de Terraform para NetBox que permite gestionar los objetos de NetBox como código, dentro del mismo flujo de Infraestructura como Código que ya uses para el resto de tu infraestructura.
- Contenedores y despliegue: NetBox se distribuye oficialmente también como proyecto Docker (netbox-docker), lo que facilita enormemente levantar una instancia completa en minutos, tanto para pruebas como para producción.
6. Plugins: cómo extender NetBox más allá de lo básico
NetBox está diseñado desde su arquitectura para ser extensible mediante plugins, que amplían el modelo de datos, los paneles y los flujos de trabajo del núcleo sin necesidad de modificar el código base ni forzar a todos los equipos a trabajar exactamente igual. Esto es clave, porque cada organización acaba necesitando cosas ligeramente distintas de su inventario de red.
Algunos ejemplos de plugins muy usados en la comunidad:
- Plugins de gestión de topología, que generan diagramas de red automáticamente a partir de los datos ya existentes en NetBox, sin tener que mantener diagramas por separado en otra herramienta.
- Plugins de generación de configuración, que aprovechan los «config contexts» de NetBox para generar automáticamente la configuración de dispositivos a partir de plantillas y de los propios datos documentados.
- Plugins de gestión de circuitos avanzada, que amplían el módulo de circuitos nativo con funcionalidades específicas para operadores e ISPs.
- Plugins de reporting y cumplimiento, pensados para auditorías, que generan informes automáticos sobre el estado de la infraestructura documentada.
La lista de plugins disponibles crece constantemente gracias a la comunidad, y el propio ecosistema de NetBox Labs mantiene un repositorio de plugins destacados. Si en algún momento sientes que «a NetBox le falta tal cosa», lo más probable es que ya exista un plugin que lo resuelva, o que puedas desarrollar el tuyo propio siguiendo su framework de extensión, ya que todo el proyecto está construido sobre Django y Python.
7. Mi experiencia tras un año usando NetBox
Después de un año con NetBox en producción, lo que más valoro no es ninguna funcionalidad concreta, sino el cambio de mentalidad que provoca en todo el equipo: cuando sabes que los datos de NetBox son fiables, dejas de perder tiempo verificando «a mano» cosas que ya deberían estar claras. La búsqueda de una IP libre, que antes podía llevarme varios minutos revisando un Excel desactualizado, ahora es prácticamente instantánea.
Si tengo que ser honesto, la parte que más cuesta no es técnica, sino de disciplina: NetBox solo es tan bueno como los datos que mantengas actualizados en él. Empezar intentando modelarlo todo de golpe (IPAM, DCIM, circuitos, cableado) es la forma más rápida de acabar con un sistema que nadie usa porque «puede estar desactualizado». Lo que mejor me ha funcionado es justo lo contrario: empezar por el IPAM, dejarlo fiable al 100%, y desde ahí ir ampliando el alcance poco a poco.
8. Conclusión
NetBox no es simplemente «otra herramienta más» de las muchas que existen para documentar redes: es un cambio de enfoque, que pasa de la documentación estática y siempre desactualizada a un modelo de datos vivo, estructurado y con API, capaz de convertirse en el corazón de tu automatización de red. Tanto si gestionas un centro de datos completo como si simplemente quieres dejar de perder el hilo de qué IPs tienes libres, NetBox merece muchísimo la pena, y su naturaleza open source hace que puedas empezar a probarlo sin ningún coste, por ejemplo levantando una instancia con netbox-docker en cuestión de minutos.
Después de un año usándolo a diario, no me imagino volver a gestionar una red sin él. Si te animas a probarlo, cuéntame en los comentarios qué tal te va, o si ya lo usas, qué plugins te han resultado más útiles en tu caso.
