hyperb1iss/unifly

hyperb1iss

CLI и TUI для управления сетями Ubiquiti UniFi: 29 команд для скриптов и интерактивный дашборд для мониторинга в терминале.

unifly — это инструмент командной строки и терминальный интерфейс для администрирования сетей Ubiquiti UniFi. Он нужен сетевым инженерам и разработчикам, которые хотят автоматизировать рутину и наблюдать за сетью без веб-панели.

Ключевые возможности

  • 29 команд верхнего уровня для управления устройствами, клиентами и VLAN
  • Встроенный TUI-дашборд для мониторинга в реальном времени
  • Единый интерфейс ко всем API UniFi, включая Site Manager и облачный коннектор
  • Потоковая передача событий и графики пропускной способности в терминале
  • Скилл для AI-агентов с версионно-зависимыми инструкциями

Для каких задач подходит

  • Автоматизация рутинных операций с сетью через скрипты и CI
  • Мониторинг состояния сети и клиентов без открытия веб-интерфейса
  • Диагностика проблем с VLAN и пропускной способностью
  • Предоставление AI-агентам доступа к управлению сетью через скилл

Подробнее

unifly объединяет несколько API UniFi в один согласованный интерфейс, поэтому пользователю не нужно выбирать, к какому эндпоинту обращаться. Инструмент написан на Rust и использует асинхронный движок tokio, что обеспечивает быструю работу и низкое потребление ресурсов. Он поставляется как один бинарный файл с 29 командами для сценариев и встроенным TUI на базе ratatui для интерактивного мониторинга.

В отличие от веб-панели UniFi, unifly ориентирован на терминал и автоматизацию. Он поддерживает потоковую передачу событий и графики пропускной способности, что удобно для наблюдения за сетью в реальном времени. Для AI-агентов предусмотрен отдельный скилл, который загружает инструкции, соответствующие версии инструмента.

Стоит учитывать, что для работы требуется доступ к контроллеру UniFi и совместимая версия API. Инструмент распространяется под лицензией Apache-2.0, что допускает коммерческое использование. Документация доступна на сайте проекта.

Частые вопросы

Как установить unifly?

Отдельной команды установки в README нет — склонируйте репозиторий и следуйте инструкции из README:

git clone https://github.com/hyperb1iss/unifly.git

Какие задачи решает unifly?

unifly решает задачи управления и мониторинга сетей UniFi: от автоматизации команд через скрипты до визуального наблюдения за устройствами и клиентами в терминале. Он также подходит для интеграции с AI-агентами через предоставляемый скилл.

Какие версии UniFi Controller поддерживаются?

В README не указан явный список поддерживаемых версий, но упоминается, что инструмент говорит на всех диалектах API UniFi, включая Site Manager и облачный коннектор. Для уточнения совместимости обратитесь к документации проекта.

Можно ли использовать unifly в коммерческих целях?

Да, проект распространяется под лицензией Apache-2.0, которая разрешает коммерческое использование, модификацию и распространение при соблюдении условий лицензии.

Чем unifly отличается от веб-интерфейса UniFi?

unifly предоставляет управление и мониторинг через терминал, ориентирован на автоматизацию и скрипты, а также включает TUI-дашборд и поддержку AI-агентов, тогда как веб-интерфейс предназначен для интерактивной работы через браузер.

О репозитории

Язык

Лицензия

Звёзды

272

Форки

17

Открытые issues

2

Контрибьюторы

0

Создан

13.02.2026

Обновлён

20.10.2026

Теги