NetBox 4.5 para fibra rural: IP, racks y permisos
Inventariar fibra rural exige sitios, enlaces, IP y cambios con dueño. Guia tecnica con NetBox 4.5, PostgreSQL, Redis, API, permisos y backup.
La caída se repite cuando dos técnicos registran el mismo enlace con nombres distintos. Una cooperativa eléctrica con internet rural puede tener postes, nodos, IP y clientes bien atendidos, y aun así perder una reparación por inventario duplicado. NetBox 4.5 permite ordenar sitios, racks, equipos, prefijos y cambios. Esta guía explica qué guardar, quién lo toca y cómo probar salida antes de producción.
Por qué el inventario falla antes que el enlace
La cifra que corrige la rutina está en los requisitos oficiales: NetBox pide Python 3.12, 3.13 o 3.14, PostgreSQL 15+ y Redis 4.0+. Ese requisito marca otra categoría de trabajo: una aplicación que guarda relaciones entre sitios, dispositivos, cables, circuitos, direcciones IP y usuarios.
El enlace figura vivo en campo y muerto en la planilla.
El dato global ayuda a entender por qué conviene tratar el inventario como registro vivo. Octoverse 2025 informó 630 millones de repositorios en GitHub y 81,5% de contribuciones en repositorios privados. Las redes chicas también tienen trabajo público y privado: datos compartidos para soporte y datos restringidos para cambios.
La planilla de postes pierde dueño en cada guardia
El antagonista es la planilla llamada "nodos_actualizado_final.xlsx", enviada por chat después de una tormenta. El gerente de una cooperativa eléctrica con internet rural recibe reclamos de usuarios, cuadrillas y proveedores. Una camioneta blanca con escalera queda estacionada frente al nodo; el técnico anota puerto, fibra y caja en una libreta porque la versión compartida no abre en el teléfono.
NetBox permite cortar ese recorrido en objetos. El sitio guarda ubicación y rol. El rack guarda posición física. El dispositivo guarda modelo, serie y estado. La interfaz guarda puerto. El cable une extremos. IPAM guarda prefijos y direcciones. El cambio queda en historial. La API REST entrega esos datos a scripts, monitoreo o tableros sin copiar columnas a mano.
La versión 4.5.10, publicada el 4 de mayo, corrige filtros de interfaces, campos nulos y detalles del esquema OpenAPI. Para una red chica, esa lista suena lejana hasta que un cable incompleto aparece conectado en soporte.
Cómo funciona por dentro
El flujo mínimo tiene siete pasos. Primero, administración carga sitios, rutas y responsables. Segundo, la cuadrilla carga rack, dispositivo, puerto y cable. Tercero, redes asigna prefijo, VLAN, IP y servicio. Cuarto, NetBox valida relaciones y conserva historial de cambios. Quinto, PostgreSQL 15+ guarda objetos, usuarios, estados y auditoría. Sexto, Redis atiende caché y cola de trabajos. Séptimo, el backup copia base, archivos y configuración, y se prueba restaurando un sitio real.
PostgreSQL guarda registros estructurados que explican qué equipo vive en qué sitio y qué IP usa. Redis guarda datos temporales para responder rápido y ordenar trabajos de fondo. NetBox recibe datos de infraestructura y entrega vista web, API y exportaciones. El monitoreo puede leer API o exportar inventario; si NetBox cae, la red sigue pasando tráfico, pero soporte queda sin fuente común para actuar.
Los permisos importan desde el primer día. La cuadrilla puede editar puerto, cable y foto de instalación. Redes edita prefijos, VLAN y servicios. Administración lee sitios y clientes asociados. Gerencia ve reportes. Borrados de dispositivos y prefijos quedan restringidos a un rol de cambio. Cada ajuste debe dejar usuario, fecha y comentario.
Qué se instala o configura primero
La pila inicial usa NetBox 4.5, PostgreSQL 15, Redis, HTTPS, backups diarios, grupos de permisos y un proceso de alta de sitios. El piloto cuesta entre USD 1.200 y USD 3.800, entre ARS 1,70 y 5,39 millones al dólar vendedor oficial de $1.418 informado por Bluelytics. Incluye instalación, carga de inventario base, roles, API de consulta y restauración.
El plazo va de tres a cinco semanas. UMSA suele pedir un entregable verificable: diez sitios, cincuenta dispositivos, prefijos cargados, dos cuadrillas con permisos separados, una consulta API y una restauración completa. El primer valor no aparece en una pantalla linda; aparece cuando soporte encuentra el puerto correcto sin llamar a tres personas.
Conviene empezar por el tramo que más falla: nodos rurales, cámaras, fibra troncal o CPE de clientes críticos. Cada objeto necesita nombre, estado, ubicación y responsable. Si un campo queda libre para cualquier texto, el inventario vuelve a duplicar nombres.
El primer tablero debe mostrar sitios sin responsable, dispositivos sin serie, prefijos sin uso y cambios de la última semana. Esos cuatro cortes alcanzan para encontrar deuda de inventario antes de cargar toda la red.
Dónde se rompe y cómo probarlo
Primer riesgo: nombres sin convención. La señal aparece cuando el mismo sitio figura con abreviaturas distintas. La prueba importa veinte sitios y busca duplicados por localidad, coordenada y alias. Segundo riesgo: permisos de edición abiertos. La señal aparece cuando una cuadrilla borra un prefijo. La prueba usa usuarios separados y fuerza alta, edición, consulta y borrado.
Tercer riesgo: inventario sin API. La señal es una exportación manual antes de cada reporte. La prueba consulta sitios y dispositivos desde la API y compara conteos. Cuarto riesgo: backup incompleto. La señal es NetBox restaurado sin historial o archivos. La documentación de replicación obliga a pensar base y medios juntos. La prueba restaura un sitio con dispositivos, cables, IP y comentarios. El inventario sirve cuando la guardia lo cree.