VNOX-Client/docs/05-features/central-hub.md
loki5512344 ca3465daa5
docs: replace long dashes, document icons, emoji and avatar rules
Update the status of the client UX defects handled by the interface work.
2026-10-25 10:28:19 +01:00

3.5 KiB
Raw Blame History

Central Hub - опциональный координационный сервер

Мотивация

VNOX спроектирован как self-hosted платформа: каждый сам поднимает свой нод. Но для adoption нужна точка входа для тех, у кого нет своего сервера, и механизм обнаружения публичных нодов.

Central Hub - опциональный сервер, который не заменяет собственный нод и не хостит голос/чат. Он только координирует.

Что делает Central Hub

1. Discovery / Registry - реестр публичных нодов

Владельцы нодов могут опубликовать свой сервер в реестре:

  • адрес, название, описание, регион
  • теги (gaming, dev, ru, cs2, ...)
  • мета: онлайне, кол-во пользователей

Клиент может найти сервер по тегам/названию и подключиться. Без Central Hub - только прямой ввод адреса или закладки.

2. Global identity bridge - аккаунт без своего нода

Пользователь регистрирует ключ на Central Hub:

  • user@hub - глобальный идентификатор
  • никнейм, аватар (опционально)
  • привязка к одному или нескольким "гостевым" нодам

Позволяет зайти в VNOX без поднятия собственной инфраструктуры. При этом Central Hub не хранит сообщения, не релеит голос, не управляет каналами.

3. Push notification relay - поддержка мобильных

Мобильные клиенты не могут держать постоянное TCP/UDP соединение. Central Hub принимает пуш-уведомления от нодов:

  • входящее DM
  • упоминание в чате
  • звонок в войс

Без этого мобильный клиент будет получать сообщения только с задержками.

4. User directory / friend graph - глобальная социальная сеть

Список друзей и поиск пользователей не привязан к одному ноду:

  • @user ищется по Central Hub
  • запрос в друзья через хаб, а не через конкретный сервер
  • cross-node DM: хаб знает, на каком ноде сейчас пользователь

Границы (чего Central Hub НЕ делает)

  • ❌ Не хостит голосовые каналы
  • ❌ Не хостит текстовые каналы
  • ❌ Не хранит историю сообщений
  • ❌ Не управляет сессиями - только направляет
  • ❌ Не заменяет self-hosted нод - только дополняет

Hub - это телефонная книга и коммутатор, а не сам телефон.

Деплой

Central Hub - отдельный бинарник (например, vnox-hub). Работает на HTTP(S) / WebSocket, минимальные требования. Может быть поднят кем угодно, не обязательно авторами VNOX.