LibreQoS/docs-es/v2.0/quickstart-es.md

Quickstart: Ruta de Despliegue para ISP

Use esta página para pasar de instalación a piloto seguro con mínima ambigüedad.

¿Necesita definiciones de términos clave? Vea el Glosario.

1) Base de instalación común

Complete esto una vez:

1. Revise arquitectura y dimensionamiento:

• Escenarios de Despliegue
• Requisitos del Sistema

2. Prepare host y sistema operativo:

• Configuración del Servidor - Prerrequisitos
• Instalar Ubuntu Server 24.04

3. Configure el modo de puente:

• Configurar Puente de Regulación

4. Instale LibreQoS (.deb recomendado):

cd /tmp
sudo apt-get update
sudo apt-get upgrade
wget https://download.libreqos.com/{deb_url_v1_5}
sudo apt install ./{deb_url_v1_5}

Usar /tmp evita problemas de permisos con .deb locales cuando apt no puede acceder al paquete almacenado en un directorio home privado con el usuario _apt.

Hotfix de Ubuntu 24.04 si la instalación del .deb se detiene

En hosts Ubuntu 24.04 afectados que usan systemd-networkd, la instalación del .deb puede detenerse y mostrar un mensaje requiriendo el hotfix. Esto es esperado.

Si eso ocurre, ejecute:

sudo /opt/libreqos/src/systemd_hotfix.sh install
sudo reboot

El instalador del hotfix configura el repositorio APT de LibreQoS en https://repo.libreqos.com, instala el conjunto parchado de paquetes systemd de Noble y fija esos paquetes para futuras actualizaciones.

Después del reinicio, reanude la instalación:

cd /tmp
wget https://download.libreqos.com/{deb_url_v1_5}
sudo apt install ./{deb_url_v1_5}

5. Abra WebUI en http://your_shaper_ip:9123.

2) Puerta de salud en 10 minutos (obligatoria antes del piloto)

Ejecute:

sudo systemctl status lqosd lqos_scheduler
journalctl -u lqosd -u lqos_scheduler --since "10 minutes ago"

Confirme:

• Carga WebUI Dashboard.
• Scheduler Status está saludable.
• No hay errores urgentes/fatales de arranque en logs.

Si falla esto, vaya a Solución de problemas antes de continuar.

3) Decisión A: Etapa de despliegue

Elija una:

• Laboratorio primero: validar comportamiento en entorno controlado antes de tráfico inline.
• Piloto inline ahora: avanzar directo con alcance limitado de tráfico productivo.

Si elige laboratorio primero:

1. Arme topología de laboratorio.
2. Genere tráfico de prueba.
3. Valide Dashboard, Tree, Flow, Scheduler Status y Urgent Issues.
4. Continúe a la Decisión B.

4) Decisión B: Elija dónde hará los cambios permanentes

Si esto describe su caso	Modo	Dónde deben hacerse los cambios permanentes
Usa integración CRM/NMS soportada	Modo integración incluida	Jobs de integración
Genera network.json y ShapedDevices.csv con scripts propios	Modo fuente de verdad personalizada	Sus scripts
Mantiene archivos manualmente en red pequeña/simple	Modo archivos manuales	Edición manual

Regla: mantenga un solo lugar para los cambios permanentes de shaping.

5) Tarjetas de ruta

Modo Integración Incluida

Cuándo elegir:

• Su CRM/NMS está soportado por integraciones incluidas.

Haga esto ahora:

1. Configure integración en WebUI.
2. Ejecute sincronización inicial y valide datos importados de shaping/topología.
3. Coloque LibreQoS inline para tráfico piloto.
4. Valide Scheduler Status, Urgent Issues y vistas de topología/flujo.
5. Expanda alcance del piloto tras estabilidad.

Siguiente:

• Integraciones CRM/NMS
• Solución de problemas

Modo Fuente de Verdad Personalizada (Sus Scripts)

Cuándo elegir:

• Su CRM/NMS no está soportado y usted generará network.json + ShapedDevices.csv con su pipeline propio.

Haga esto ahora:

1. Implemente script/proceso para generar y refrescar archivos de shaping.
2. Trate las salidas del script como el lugar donde hará los cambios permanentes.
3. Coloque LibreQoS inline para tráfico piloto.
4. Use WebUI para checks operativos y ajustes de corto plazo.
5. Mantenga cambios permanentes en su flujo externo de scripts.

Referencia de formato:

• Vea las secciones network.json y ShapedDevices.csv en Referencia avanzada de configuración.

Siguiente:

• Modos de operación y fuente de verdad
• Solución de problemas

Modo Archivos Manuales (<100 suscriptores)

Cuándo elegir:

• Mantiene intencionalmente network.json + ShapedDevices.csv sin sincronización CRM/NMS.

Haga esto ahora:

1. Construya y mantenga archivos de shaping directamente.
2. Coloque LibreQoS inline para tráfico piloto.
3. Valide shaping y estado del scheduler en WebUI.
4. Mantenga disciplina estricta de cambios manuales.
5. Planifique migración a integración soportada o scripts si crece escala/volumen de cambios.

Siguiente:

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

6) Errores comunes en primera puesta en marcha

• No decidir con claridad dónde hará los cambios permanentes.
• Cambiar profundidad topológica antes de pasar la puerta de salud.
• Omitir validación de servicios/logs antes de tráfico piloto.

7) Páginas relacionadas

• Modos de operación y fuente de verdad
• Integraciones CRM/NMS
• Referencia avanzada de configuración
• Solución de problemas