LibreQoE

Primeros Pasos

  • Quickstart (Empieza Aquí)
    • 1) Base común de instalación
      • Hotfix de Ubuntu 24.04 si la instalación del .deb se detiene
    • 2) Abra la WebUI y complete el primer inicio de sesión
    • 3) Use Complete Setup para elegir la fuente de topología
      • Integración incluida
      • Importador personalizado
      • Archivos manuales
    • 4) Verificación de salud de 10 minutos
    • 5) Comience con un piloto limitado
    • 6) Errores comunes al inicio
    • 7) El día 1 termina cuando
    • 8) Páginas relacionadas
  • Escenarios de Despliegue
    • Despliegue inline estándar
      • NAT/CG-NAT
      • MPLS/VPLS
      • Enrutamiento dinámico: ruta de bypass
      • Opción 1: Enrutamiento dinámico (recomendado)
    • Despliegue de laboratorio (opcional)
  • Requisitos del Sistema
    • Guía rápida de dimensionamiento (empiece aquí)
    • Servidor Físico (Bare Metal)
      • CPU
      • Hyper-threading
      • Memory
      • Espacio en Disco
      • Recomendaciones de Dispositivos
        • Dispositivo de Espacio Pequeño (1G a 10G)
        • Servidores Rackmount (10G to 100G)
        • Server Setup Prerequisites
      • Requisitos de Interfaces de Red
    • Máquina Virtual
  • Requisitos previos para la configuración del servidor
    • Servidores e hipervisores
      • Desactivar Hyper-Threading
      • Desactivar SR-IOV en la BIOS
    • Hipervisores
      • Proxmox
      • Hyper-V
        • Suplantación de MAC en Hyper-V (Si está dentro de una máquina virtual)
  • Instalar Servidor de Ubuntu
  • Configurar el Puente de Regulación
    • Elegir el Tipo de Puente
    • Opción A: Configuración de Netplan para un puente regular de Linux (Recomendado)
    • Opción B: Configuración de Netplan para el puente Bifrost con XDP

Gestionando LibreQoS (v1.5 a v2.0):

  • Configurar LibreQoS
    • Propósito de esta página
    • Configuración inicial en la WebUI
    • Configuración mediante la interfaz web
      • Dónde en la WebUI
    • Fuente de verdad
    • Notas importantes
    • Perfiles QoO (Quality of Outcome) (qoo_profiles.json)
      • Dónde vive el archivo
      • Selección de perfil
      • Aplicación de cambios
    • ¿Necesita cambios por CLI o por archivos?
    • Páginas relacionadas
  • Glosario
    • Fuente de verdad
    • Ciclo de refresco de integración
    • Override
    • Cambio persistente
    • Cambio transitorio
    • Sobrescribible por integración
    • ShapedDevices.csv
    • network.json
    • Circuito mapeado
    • Límite de circuitos mapeados
    • Estado del scheduler
    • Impacto inmediato en runtime
  • Modos de operación y fuente de verdad
    • Propósito de esta página
    • Integraciones incluidas (recomendado para la mayoría de operadores)
    • Fuente de verdad personalizada
    • Modo archivos manuales
    • Lista de verificación de modo (antes de producción)
    • Expectativas de topología y modo
    • Páginas relacionadas
  • Referencia avanzada de configuración
    • Guardrails de patrones topológicos
    • Configuración por línea de comando
      • Archivo de Configuración Principal
      • /etc/lqos.conf
      • Netflow (opcional)
      • Integraciones con CRM/NMS
      • Límite de Fuente de Verdad para Usuarios de Integración
      • Modo de compilación de topología para archivos DIY/manuales
      • Overrides en runtime (lqos_overrides.json)
    • Jerarquía de Red
      • Network.json
        • Nodos virtuales (solo lógicos)
        • Consideraciones de CPU
        • Ayudante para convertir CSV a JSON
    • Circuitos
      • ShapedDevices.csv
        • TreeGuard y SQM por circuito
        • Múltiples IPs por Circuito
        • Edición Manual mediante WebUI
        • Edición Manual mediante CLI
  • Integraciones CRM/NMS
    • Propósito de esta página
    • Elegir ruta de integración
    • Dónde en la WebUI
    • Integraciones incluidas
    • Comportamiento importante de refresco
    • Soporte para IDs de nodos de topología
    • Manejo común de velocidades de cliente
    • Páginas relacionadas
  • Componentes de software de LibreQoS
    • Servicios systemd
      • lqosd
      • lqos_scheduler
      • Verificación de estado
      • Depuración de lqos_scheduler
    • Modo privacidad en WebUI
    • Canal de problemas urgentes
    • Indicador de estado del scheduler
    • Solución de problemas de componentes
  • Interfaz WebUI (Node Manager) de LibreQoS
    • Vistas principales
      • Dashboard
      • Vista de árbol de red
      • Topology Probes
      • Site Map
      • Flow Globe
      • ASN Analysis
      • Página de circuito
      • Ethernet Caps
      • Árbol/ponderación de CPU
      • Editor de Shaped Devices
      • Páginas de configuración
      • Problemas urgentes
      • Estado del scheduler
    • Modo privacidad / redacción
    • Comportamiento de vistas vacías
    • Páginas relacionadas
  • StormGuard
    • Qué hace StormGuard
    • Configuración
    • UI y depuración
    • Patrón de despliegue seguro
    • Solución de problemas
    • Páginas relacionadas
  • TreeGuard
    • Qué Hace TreeGuard
    • Comportamiento por Defecto en LibreQoS v2.0
    • Modelo de Conmutación SQM por Circuito
    • Configuración (/etc/lqos.conf)
    • Patrón de Despliegue Seguro
    • Overrides y Notas Operativas
    • Páginas Relacionadas
  • Alta Disponibilidad y Dominios de Falla
    • Alcance y Supuestos
    • Modelo HA Activo/Respaldo
    • Ejemplo OSPF (Costo 1 Primario, Costo 100 Respaldo)
    • Equivalente en BGP (Si Usa BGP en Lugar de OSPF)
    • Recuperación y Retorno (Runbook Conceptual)
    • Mantenimiento Planificado (Procedimiento Conceptual)
    • Lista de Verificación de Preparación HA
    • Límites Conocidos
    • Documentación Relacionada
  • Escalado y diseño de topología
    • Principios de diseño
    • Selección de estrategia por escala
    • Distribución padre/hijo
    • Nodos virtuales y agrupación lógica
    • Guardrails de colas/clasificadores
    • Checklist de despliegue para cambios de topología
    • Páginas relacionadas
  • Recetas de Despliegue
    • Alcance
    • Indice de Recetas
      • Receta: WISP/FISP con Integracion CRM/NMS Incorporada
        • Ajuste
        • Prerrequisitos
        • Implementacion
        • Ilustracion de Flujo de Datos
        • Checklist de Validacion
        • Fallas Comunes
        • Rollback
        • Paginas Relacionadas
      • Receta: Maritimo con WAN Variable y StormGuard
        • Ajuste
        • Prerrequisitos
        • Patron de Topologia
        • Configuracion de StormGuard
        • Ilustracion de Loop de Control
        • Secuencia de Rollout
        • Checklist de Validacion
        • Rollback
        • Paginas Relacionadas
      • Receta: Event WiFi con Shaping por Grupos de Subred
        • Ajuste
        • Patron
        • Implementacion
        • Checklist de Validacion
        • Rollback
        • Paginas Relacionadas
      • Receta: Hoteleria y Hospitalidad con Shaping por Dispositivo
        • Ajuste
        • Guardrails de Capacidad
        • Patron
        • Ejemplo
        • Checklist de Validacion
        • Rollback
        • Paginas Relacionadas
      • Receta: Fabric Switch-Centric con Bypass de Mantenimiento (incluye SD-WAN)
        • Ajuste
        • Patron Topologico
        • Ilustraciones Topologicas
        • Ejemplo MikroTik RouterOS v7 (OSPF conceptual)
        • Implementacion
        • Checklist de Validacion
        • Variante SD-WAN
        • Rollback
        • Paginas Relacionadas
      • Receta: Despliegue Proxmox VM con 3 NICs
        • Ajuste
        • Seleccion de Patron
        • Roles de Interfaces
        • Patron A (Recomendado): Bridges de Shaping Dedicados
        • Patron B (Alternativo): Bridge Unico con NICs Taggeadas
        • Prerrequisitos
        • Patron Netplan
        • Checklist de Validacion
        • Rollback
        • Paginas Relacionadas
    • Paginas Relacionadas
  • Casos de Estudio (Anonimizados)
    • Historia 1: WISP Regional Estandariza en Integracion UISP
    • Historia 2: Operador Maritimo Mejora Calidad con WAN Variable
    • Historia 3: Red de Hospitalidad Migra a Equidad por Dispositivo
    • Paginas Relacionadas
  • Insumos para Desarrollo Futuro
    • Alcance y Metodo
    • Temas Recurrentes
    • 1) Claridad de UI y confianza operativa
    • 2) Comportamiento de integraciones y seguridad de fuente de verdad
    • 3) Friccion en onboarding y despliegue temprano
    • 4) Guardrails de escala/topologia y advertencias proactivas
    • 5) Ajuste de rendimiento y encaje de hardware
    • Direcciones Candidatas Bajo Evaluacion
    • Fuera de Alcance
    • Paginas Relacionadas
  • Actualización
    • Si instalaste el .deb
      • Hotfix de Ubuntu 24.04 si la actualización se detiene
      • Reinicio posterior a la actualización
      • Validación obligatoria post-actualización
    • Si instalaste desde Git
      • Hotfix de Ubuntu 24.04 para instalaciones desde Git
    • Síntomas para pausar y hacer triage
  • Solución de problemas
    • Empiece aquí: triage por síntoma
    • Problemas comunes
      • Dónde en la WebUI
      • Antes de pedir ayuda en chat: recolecte esta evidencia
      • La contraseña de usuario no funciona
      • No hay WebUI en x.x.x.x:9123 o en la URL HTTPS
      • LibreQoS está en ejecución, pero no hace shaping
      • On-a-stick: shaping incorrecto o una dirección débil
      • El servicio lqosd no se ejecuta o falla al iniciar
      • Depuración avanzada de lqosd
      • El servicio lqos_scheduler muestra errores
      • El estado del scheduler en WebUI aparece no saludable
      • RTNETLINK answers: Invalid argument
      • Todas las IPs de clientes aparecen como Unknown IPs
      • Flow Globe / Tree Overview / ASN Analysis aparecen en blanco
      • Los circuitos muestran Generated_PN en vez de nombres de network.json
      • Colisión de promoción de nodo virtual (network.json)
      • Se alcanzó el límite de circuitos mapeados
      • Códigos de problemas urgentes y primeras acciones
    • Páginas relacionadas

Funciones Con Licencia

  • LibreQoS Insight
    • Acerca de Insight
    • Interfaz de Insight
      • Barra de tareas
      • Selector de tiempo
      • Panel (Dashboard)
        • Pestaña Traffic Overview
        • Pestaña Shaper
        • Pestaña Children
        • Heatmaps
        • Site Rankings
      • Node Map
      • Libby (Asistente IA)
      • Site Heatmap
      • Tree History
      • Reports
      • Alerts
    • Comportamiento de licenciamiento de Insight (lado nodo)
      • Material de claves local y grants offline
      • Límites de circuitos mapeados y estado de licencia
  • API del Nodo de LibreQoS
    • Requisitos
    • Fuente de verdad y pruebas
    • Instalar y habilitar
    • Autenticación
    • Qué pueden hacer los ISPs con la API
      • 1) Ciclo de vida de suscriptores/circuitos
      • 2) Gestión de overrides y políticas
      • 3) Topología y archivos de entrada de shaping
      • 4) Monitoreo y diagnóstico
      • 5) Operaciones de control y reload
    • Modelo de persistencia (importante)
    • Flujo recomendado para producción
    • Hardening de despliegue

Misceláneo

  • Arquitectura Backend y Diseño de Colas de LibreQoS
    • Contexto de Fuente
    • 1) Modelo Mental del Backend
    • 2) Invariantes de Ejecución
    • 3) Ruta End-to-End de Paquetes y Control
    • 4) Diseño del Plano de Datos
      • 4.1 Pipeline XDP y clasificación
      • 4.2 Por qué cpumap es central
      • 4.3 Cache, generaciones y reducción de presión por locks
    • 5) Jerarquía de Colas: mq -> HTB -> qdisc hoja
      • 5.1 Internals de HTB que importan en producción
    • 6) AQM en LibreQoS: fq_codel y CAKE
      • 6.1 División de responsabilidades
      • 6.2 Por qué AQM sigue ayudando incluso por debajo de la saturación de la tasa de línea
      • 6.3 CAKE vs fq_codel en términos de LibreQoS
      • 6.4 Cuándo los beneficios bajo la tasa máxima pueden ser menores
    • 7) Bakery y Comportamiento de Recarga
      • 7.1 Colas perezosas y expiración
      • 7.2 Límite entre incremental y recarga completa
      • 7.3 Reglas rápidas para límites de recarga
      • 7.4 Salvaguardas de seguridad para recargas completas
    • 8) Límites de Diseño para Operadores
      • 8.1 Límites de observabilidad
      • 8.2 Factores de riesgo de capacidad y mitigaciones
    • 9) Matriz de Troubleshooting: Síntoma a Causa
    • 10) Flujo de Validación de Cambios
      • 10.1 Antes del cambio
      • 10.2 Durante el cambio
      • 10.3 Después del cambio
      • 10.4 Checklist mínimo de comandos
    • 11) Secuencia Práctica de Ajuste
    • 12) Glosario
    • Lectura Relacionada
  • HTB + fq-codel / CAKE
    • 1) Por Qué Existen Estos Tres Componentes Juntos
    • 2) Ubicación en Tiempo de Ejecución en LibreQoS
    • 3) Resumen de HTB para Usuarios de AQM
      • 3.1 Mecánicas centrales de HTB
      • 3.2 Controles clave de HTB
      • 3.3 Por qué importa para fq_codel y CAKE
      • 3.4 Comportamiento de tráfico no definido en LibreQoS
      • 3.5 Esqueleto compacto HTB (patrón de referencia)
    • 4) Profundización en fq_codel
      • 4.1 Qué es fq_codel
      • 4.2 Comportamiento del scheduler y ventaja para flujos esporádicos
      • 4.3 Modelo de hash de flujos
      • 4.4 Parámetros de fq_codel que realmente se ajustan
      • 4.5 Observabilidad fq_codel (tc -s qdisc show)
    • 5) Profundización en CAKE
      • 5.1 Arquitectura de CAKE
      • 5.2 Operación con shaping vs sin shaping
      • 5.3 Modos de aislamiento de flujo
      • 5.4 Conciencia de NAT
      • 5.5 Modos DiffServ y tins
      • 5.6 Mapeo DSCP diffserv4 en LibreQoS
      • 5.7 Compensación de overhead y framing
      • 5.8 Manejo de GSO (split-gso)
      • 5.9 Filtrado ACK
      • 5.10 Modo ingress y autorate
      • 5.11 Observabilidad CAKE (tc -s qdisc show)
    • 6) Marco de Política en LibreQoS: CAKE vs fq_codel
    • 7) Notas Operativas de LibreQoS
    • 8) Flujo Práctico de Observabilidad
    • 9) Malentendidos Comunes
    • 10) Contexto HTB HOWTO (Histórico, Aún Útil)
    • 11) Referencias
  • Ajuste de rendimiento
    • Triage por síntoma
    • Base de CPU e IRQ
    • Presión por topología/colas
    • Frecuencia del scheduler y carga
    • Despliegue de StormGuard
    • Arranque lento / dependencias de red
    • Convergencia de ruteo (OSPF)
    • Páginas relacionadas de optimización y resiliencia
  • Extras
    • Flamegraph
    • Cómo habilitar CAKE o fq_codel en enlaces de respaldo (menor capacidad) en redes MikroTik
LibreQoE
  • Búsqueda

© Derechos de autor 2026, LibreQoE, LLC.

Compilado con Sphinx usando un tema proporcionado por Read the Docs.