HydraBridge

English

HydraBridge - единый HTTP API управления для HydraRoute Neo.

Это небольшой агент для роутеров Keenetic с Entware. Он запускается рядом с hrneo, но не маршрутизирует трафик самостоятельно. HydraBridge предоставляет приложениям, ботам, CLI-инструментам и новым web-интерфейсам стабильный API для настройки и диагностики возможностей HR Neo.

Статус

Компонент	Версия
HydraBridge	0.1.0
Поддерживаемый HR Neo	3.11.0-1
API	/api/v1

Лицензия: MIT.

Принципы

• hrneo.conf, domain.conf и ip.list остаются источником истины.
• HydraBridge не создает вторую модель маршрутизации поверх HR Neo.
• Удобные сгруппированные ответы API являются read-only представлениями.
• Точечные изменения сохраняют посторонние байты файлов конфигурации.
• Перед изменениями создаются резервные копии.
• Конкурентное редактирование защищено через ETag, X-Config-Revision и If-Match.

Возможности

• Bearer-аутентификация и ротация токена.
• Статус, Doctor и проверка совместимости.
• Raw и structured API для конфигов HR Neo.
• Точечное редактирование domain, GeoSite, CIDR и GeoIP-правил.
• Targets, PolicyOrder, DirectRoute и live runtime inspection.
• GeoData, import/export, диагностика доменов и IP.
• Резервные копии, восстановление, audit log и lifecycle HR Neo.
• OpenAPI-контракт для генерации клиентов.

Начало работы

• Установка на роутер
• Обзор API
• OpenAPI-контракт
• Политика безопасности

Документация

Документ	Назначение
Установка	opkg, ручная установка, обновление и первый запуск
API	Группы endpoint и правила работы клиентов
Соответствие HR Neo	Границы поддержки HR Neo 3.11.0-1
Безопасность	Модель доступа и сообщения об уязвимостях
Разработка	Сборка, упаковка и локальная проверка
Участие в разработке	Сборка, проверки и правила изменений
История изменений	Изменения между версиями

Русская документация является основной. Дополнительные английские материалы находятся в docs/en.

Границы проекта

HydraBridge поддерживает то, что уже реализовано HR Neo. Управление VPN-профилями Keenetic, составом подключений внутри policy, failover апстримов, XRay, подписками и мониторингом доступности не относятся к HR Neo и не входят в область ответственности HydraBridge.