Saltar al contenido

Red IPv4

Administra pools, subredes y asignación de direcciones IPv4.

7 min de lectura

Esta guía crea una Red IPv4 usable en la activación de clientes: nombre, router, interfaz MikroTik, red y CIDR. Sin redes, el select Red IPv4 del servicio Internet queda vacío.

Antes de empezar:

  • Un router en Ajustes → Router → Mikrotik con API respondiendo (se cargan las interfaces).
  • Permiso ip_management_access (Gestión de direcciones IP).

1. Abrir el módulo

Menú Ajustes → Infraestructura → Red IPv4 (también Ajustes → IPv4 & IPv6 → Red IPv4) → /ipv4.

Vista: Red IPv4

En pantalla:

  • Título Red IPv4 — Gestiona subredes, pools y asignación de direcciones IPv4.
  • Breadcrumb Ajustes > Red IPv4.
  • KPIs: Total Redes, IPs Disponibles, IPs Usadas, Uso Total.
  • Lista de Redes IPv4 — columnas: ID, Nombre, Red, Uso IPs, CIDR, Router, Tipo, Acciones.
  • Botón Nueva Red.

En la tabla, el uso se muestra como {usadas} de {total} (ej. 5 de 254). Tipo: badge Estática. Sin router: Sin Router. Vacío: No hay redes registradas.

2. Crear la red

  1. Pulsa Nueva Red → modal Crear Red.
  2. Completa los campos y pulsa Guardar.
Campo UI Obligatorio Detalle
Nombre Sí Máx. 50; único por empresa/routers
Router Sí Placeholder Seleccione una opción
Interfaz MikroTik Sí Se habilita tras elegir router. Ayuda: Seleccione la interfaz donde se agregará el gateway IPv4. Ejemplo: bridge, vlan-clientes, ether2.
Red Sí Ej. 192.168.88.0 (ayuda en el form)
CIDR Sí Optgroups Clase A/B/C; por defecto /24
Tipo de Uso Sí Solo Estática

Estados del select de interfaz: Primero seleccione un router → Cargando interfaces... → Seleccione interfaz / No hay interfaces disponibles.

Al guardar, el sistema sincroniza la red/gateway en el MikroTik (upsertIpv4Network).

3. Editar, exportar y eliminar

  • Editar → modal Editar Red (mismos campos) → guardar.
  • Toolbar DataTables: Imprimir, Exportar CSV/Excel/PDF.
  • Eliminar: bloqueado si hay IPs asignadas o suscripciones ({N} IP(s) asignada(s) / suscripciones asociadas). Primero libera la IP en el servicio del cliente.

4. Usar la red en un cliente

Al crear/editar el servicio Internet:

  1. Elige Tipo IP: IPv4, IPv6 o Dual.
  2. Selecciona Red IPv4.
  3. Elige una IP en IPs disponibles (endpoint /customers/networks/{id}/free-ips).

La IP queda en subscriptions.ipv4 vinculada a network_id.

5. Tips

  • Planifica CIDR según clientes por segmento (/24 ≈ 254 usables).
  • El Nombre debe ser claro (Clientes-VLAN100, Pool-Residencial).
  • Si no cargan interfaces, revisa API del router antes de crear la red.
  • No borres una red con clientes; cambia primero la IP del servicio.

6. Checklist rápido

  1. Ajustes → Infraestructura → Red IPv4 → Nueva Red
  2. Nombre + Router + Interfaz MikroTik
  3. Red + CIDR + Tipo Estática → Guardar
  4. Confirmar fila y uso 0 de N
  5. Asignar IP desde el servicio Internet del cliente