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