Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

unifi-cli

CLI en Rust/Python para controladores UniFi Network con dashboard TUI. Gestiona clientes, dispositivos, eventos y redes mediante comandos interactivos o scripts.

Ficha actualizada 27 sept 2026, 19:12 · upstream 27 sept 2026, 19:08 · release v0.4.3

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es unifi-cli

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

unifi-cli es una herramienta de línea de comandos diseñada para interactuar con controladores UniFi Network, permitiendo operaciones sobre clientes, dispositivos, redes, eventos y un dashboard en modo TUI. Soporta tanto operadores humanos como agentes de IA mediante diseño API-friendly y salida JSON estructurada.

La instalación es flexible: se puede compilar desde fuente con Rust (cargo), usar pip para Python o ejecutar binarios precompilados para Linux, macOS y Windows. La configuración admite múltiples perfiles de controlador mediante variables de entorno, archivos de configuración o flags CLI, priorizando la seguridad con permisos 0600 en sistemas Unix.

Destaca por su capacidad de gestión destructiva segura (confirmaciones obligatorias), monitorización en tiempo real de puertos PoE y soporte para DNS estático del controlador. Incluye completions para shells comunes y es compatible con automatización mediante scripts.

CASOS DE USO
  • Automatizar despliegue y gestión de dispositivos UniFi mediante scripts o agentes de IA
  • Monitorizar tráfico y estado de clientes en tiempo real desde terminal
  • Gestionar DNS estático y políticas de red sin interfaz gráfica
  • Ciclar puertos PoE para reiniciar dispositivos conectados sin tocar el switch completo
PUNTOS DESTACADOS
  • Diseñado explícitamente para agentes de IA con salida JSON predecible
  • Soporte nativo para múltiples perfiles de controlador en un solo ejecutable
  • Monitorización en vivo de puertos PoE con telemetría detallada
  • Comandos destructivos con confirmación obligatoria y detección de errores
PRECAUCIONES
  • No incluye contenedorización nativa (sin Dockerfile ni compose)
  • Requiere configuración manual de credenciales API en el controlador UniFi
  • Algunas operaciones DNS dependen de versiones antiguas de la API v2
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Instalar vía cargo, pip o binarios precompilados según plataforma. Configurar credenciales mediante unifi config init o variables de entorno. Para entornos no seguros, habilitar UNIFI_ACCEPT_INVALID_CERTS=true solo en redes confiables. Verificar compatibilidad con versión del controlador UniFi antes de usar comandos destructivos.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
RustPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.