LibreQoS/docs-es/v2.0/operating-modes-es.md

Modos de operación y fuente de verdad

Propósito de esta página

Use esta página para decidir dónde deben hacerse los cambios permanentes de shaping antes de pasar a producción.

¿Necesita definiciones de términos usados aquí? Vea el Glosario.

LibreQoS soporta tres modos de operación comunes.

Integraciones incluidas (recomendado para la mayoría de operadores)

En este modo, su CRM/NMS es el lugar donde deben hacerse los cambios permanentes de topología y suscriptores, y LibreQoS se mantiene sincronizado desde allí.

Comportamiento clave:

• La sincronización de la integración refresca los datos de topología y shaping usados por LibreQoS.
• network.json queda reservado para despliegues DIY o manuales.
• Las ediciones manuales directas pueden sobrescribirse en el siguiente refresco del scheduler.
• El modo de topología flat simplifica el árbol cuando necesita menor sobrecarga.

Fuente de verdad personalizada

En este modo, sus propios scripts o sistemas generan network.json y ShapedDevices.csv.

Comportamiento clave:

• Su flujo externo es donde deben hacerse los cambios permanentes.
• Las ediciones por WebUI son válidas para cambios operativos rápidos.
• Mantenga los cambios de largo plazo en sus scripts o automatización.
• Use topology.compile_mode = "full" cuando los valores Parent Node de ShapedDevices.csv deban moldear bajo la jerarquía nombrada en network.json.
• Use flat solo cuando las colas generadas por CPU, como Generated_PN_1, sean la topología de colas deseada.

Modo archivos manuales

En este modo, usted mantiene network.json y ShapedDevices.csv directamente.

Comportamiento clave:

• Es más adecuado para redes pequeñas, pilotos cortos o soluciones temporales.
• La WebUI le ayuda a validar lo que LibreQoS está usando.
• Requiere disciplina manual porque no hay un sistema superior que mantenga esos archivos sincronizados.
• Use topology.compile_mode = "full" cuando el shaping por padres superiores, AP o Sitio deba seguir network.json.
• Si shaping_inputs.json muestra resolution_source: "flat_bucket", LibreQoS está en modo flat y los circuitos mostrarán colas padre generadas en vez de los nombres de network.json.

Lista de verificación de modo (antes de producción)

1. Elija un lugar principal para los cambios permanentes.
2. Confirme qué sistema escribe los datos de shaping en producción.
3. Confirme el comportamiento de refresco del scheduler y la cadencia de sobrescritura.
4. Documente su flujo de cambios rápidos (WebUI, editor externo, o ambos).
5. No mantenga ediciones en competencia en varios sistemas para los mismos objetos.

Expectativas de topología y modo

• Diseños single-interface (on-a-stick) y con VLAN son válidos, pero requieren validación explícita de colas/interfaces después de cambios.
• El modo integración es ideal cuando CRM/NMS debe controlar topología y datos de suscriptores.
• Si necesita una topología que su integración no puede representar, use modo fuente personalizada y mantenga clara la responsabilidad.

Vea también:

• Referencia avanzada de configuración
• Solución de problemas

Si está usando integraciones incluidas, continúe en Integraciones CRM/NMS.

Páginas relacionadas

• Configurar LibreQoS
• Integraciones CRM/NMS
• Referencia avanzada de configuración