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

Карта публичной wiki Qarvix. Разделы ниже помогают быстро найти нужную тему: от первого подключения устройства до сетевых маршрутов, журналов, лицензирования и диагностики.

Карта wiki

Старт

Быстрое подключение устройств

Пошаговый маршрут для подключения управляемого роутера или статического WireGuard-клиента.

Оборудование

Поддерживаемое оборудование

Какие устройства уже поддерживаются и как быстро добавляется новое оборудование на OpenWrt.

Схемы

Схемы включения

SIM, роутер, hub, LAN-подсети, камеры, API устройств, датчики и несколько объектов.

Выбор подхода

Свой WireGuard-сервер vs управляемый контур

Где ручная настройка WireGuard работает нормально, а где начинает не хватать управляемого контура.

Основа

Первые шаги в Qarvix

Минимальный путь после входа в панель: организация, сеть, устройство, доступ и проверка связи.

Структура

Организации и сети

Как разделять клиентов, филиалы, команды, сети и устройства по границам ответственности.

Доступ

Пользователи, роли и SSO

Приглашения, роли, 2FA, API-токены, OIDC SSO и отзыв доступа сотрудников или подрядчиков.

Узлы

Устройства и VPN-адреса

Управляемые устройства, статические клиенты, токены подключения, VPN IP и статусы.

Сети

Сети, маршруты и ACL

Участники сети, exit node, peer mesh, subnet routes и правила доступа между узлами.

Интеграции

API устройств через туннель

Доступ к локальным API камер, PLC, датчиков, приборов учета и сервисов за роутером.

Контроль

Журналы и отчеты

Аудит действий, журнал устройств, события подключений и материалы для разбора инцидентов.

Коммерция

Лицензирование

Принципы лицензий, лимиты, продление, состояние лицензии и договорные условия.

Закрытый контур

Offline-развертывание

Установка и эксплуатация Qarvix в изолированных средах без постоянного доступа к интернету.

Поддержка

Диагностика и типовые проблемы

Проверки для WSS, WireGuard, маршрутов, VPN IP, LAN/API и прав доступа.

Как Qarvix работает под капотом

Фактическая схема ниже показывает техническую механику системы: оператор работает через HTTPS/REST, агент роутера держит WSS-канал управления, пользовательский трафик идет по WireGuard UDP, а hub является WireGuard-интерфейсом на хосте контроллера.

Фактическая схема

Контур управления, hub, агент и статичный клиент

Схема помогает не смешивать control plane и data plane: WSS нужен для команд, конфигурации и heartbeat агента, WireGuard UDP - для защищенного пользовательского трафика.

Ключевой смысл: управляемый роутер держит две связи с одним контуром - WSS для команд и конфигурации, WireGuard для трафика. Статичный клиент имеет только WireGuard, поэтому его online-статус определяется по свежести handshake на hub, а не по heartbeat агента.

Мультиязычность

Сейчас основной язык сайта - русский. Для будущих переводов Grav можно вести по стандартной схеме: рядом с default.md добавлять default.en.md и default.kk.md, сохраняя одинаковую структуру страниц и те же пути к изображениям.