Консоль модерации
Каждая версия каждого сета ждёт модератора, прежде чем попасть в каталог, и решение принимается в консоли. Консоль входит в b4hub, открывается по пути /admin на адресе хаба и доступна на английском и русском. У зеркала консоли нет, см. Свой хаб или зеркало.
Одну вещь консоль называет иначе, чем роутер: отчёт Работает или Не работает здесь называется голосом. Жалоба называется жалобой в обоих местах.
Вход
Пароль - это B4HUB_ADMIN_PASSWORD из окружения сервиса. Учётных записей и ролей нет: модератор - тот, у кого есть пароль. Сессия действует семь дней, а смена пароля завершает все открытые сессии. С одного адреса можно сделать десять попыток входа за 15 минут. Cookie сессии помечается как secure, когда запрос несёт X-Forwarded-Proto: https; этот заголовок должен выставлять обратный прокси.
Без пароля любой вход отклоняется, и модерировать можно только через b4hub moderate, см. Без консоли.
Публикация
Решение сразу меняет базу. Каталог, который скачивают роутеры, пересобирается в фоне примерно за 10 секунд, так что серия решений заканчивается одной сборкой. Неудачная сборка не отменяет решение: роутеры продолжают работать с предыдущим каталогом, пока какая-нибудь сборка не пройдёт.
Состояние на странице Обзор перечисляет, что требует внимания, со ссылкой у каждого пункта: неудачная сборка, манифест, который скоро истечёт, версия, ждущая решения больше 72 часов, зеркало со сбоями или открытые жалобы. Меню показывает число ждущих версий, сетов в каталоге, требующих внимания, ждущих зеркал и открытых жалоб.
Очередь
По карточке на каждую ждущую версию, старые первыми; карточка устроена как карточка сета на роутере. Полоса по верхнему краю подсвечивает части, которые настраивает сет: Цели, Разделение, Фейки, Маршрут или Блок и DNS. Щелчок по части открывает её настройки. Подсказка строки под названием показывает сеть, из которой пришла загрузка.
Автор показан как 16 символов HMAC ключа участника под секретом хаба. Сам ключ хаб не хранит.
Подсказка версии говорит, что сделает одобрение, например Новая версия сета, опубликованного как vN. Версия Старше опубликованной vN обведена оранжевым: её одобрение ничего не меняет в каталоге.
Отметки под целями показывают, на что посмотреть внимательнее:
| Отметка | Что означает |
|---|---|
| блокирует трафик, закрепляет адреса, только категории, шаблон, нужен payload | Что делает сет, каждая отметка объяснена в подсказке. блокирует трафик красная, только категории и шаблон оранжевые |
| похожие сеты: N | У хаба есть сеты с теми же целями, стратегией, доменами, названием или автором. Оранжевая для вероятного дубликата |
| автор заблокирован, сет снят с каталога | Версия остаётся вне каталога, даже если её одобрить |
| изменён, открытые жалобы: N | Версию изменил модератор, или на неё есть жалобы |
Щелчок по карточке открывает панель сета на этой версии со всем её содержимым. Сравнить с опубликованной vN в меню карточки показывает разницу с опубликованной версией.
Решения
| Действие | Причина | Результат |
|---|---|---|
| Одобрить | не нужна | Версия становится активной и попадает в каталог при следующей сборке |
| Отклонить | обязательна | Версия отклоняется, причина записывается |
| Скрыть | по желанию | Версия уходит из каталога при следующей сборке |
| Изменить | не нужна | Открывает редактор, см. Правка ждущей версии |
| Заблокировать автора | по желанию | См. Блокировка ключа |
Каждый диалог до подтверждения показывает, что будет с каталогом. Если скрыть опубликованную версию, вместо неё публикуется самая новая из более старых активных версий, если не отмечено Также снять весь сет с каталога. Открытые жалобы на версию закрываются вместе с решением, если не отмечено Оставить открытые жалобы открытыми. Отклонить как дубликат вписывает в причину сет, который дублируется.
Отклонение - вердикт по присланному. Его причина остаётся в консоли: роутер автора видит лишь, что сета нет в каталоге. Скрытие выводит версию из оборота, и скрытая версия продолжает считаться дубликатом для последующих отправок с той же стратегией.
Флажки на карточках или Выбрать все применяют одно решение сразу к нескольким версиям, не больше чем к 200. Каждый диалог с причиной предлагает сохранённые для этого действия причины, а Сохранить как шаблон сохраняет введённую.
Правка ждущей версии
Присланное с хорошей стратегией и неудачными целями можно исправить, а не отклонять. В редакторе есть название, описание, Заметка модератора, видимая только в консоли, и по полю на каждый вид целей. Показать полный JSON сета позволяет менять всё остальное, что несёт сет. Кнопка Опубликовать в хабе на роутере описания не отправляет, его можно написать здесь.
Проверить прогоняет результат через проверки свежей публикации. Изменение целей, названия или описания сохраняет отпечаток, и уже записанные голоса продолжают считаться. Изменение стратегии меняет отпечаток и удаляет голоса этой версии, а опубликованный сет перестаёт совпадать с копией автора. Результат, дублирующий сет, который у хаба уже есть, отклоняется. Предупреждения появляются под полями, к которым относятся, например о внутренних доменах, диапазоне /0 или отброшенном пине.
Синтаксиса со звёздочкой в b4 нет, а обычная запись покрывает все поддомены. Под полем Домены редактор отмечает четыре ошибки, а Применить предложения исправляет их одним действием:
| Проверка | Пример | Предложение |
|---|---|---|
| Запись, которая никогда не совпадёт | *.example.com | example.com |
Запись www. без домена | один www.example.com | example.com, который покрывает оба |
| Повтор | Example.com. после example.com | Убрать |
| Запись, уже покрытая другой | cdn.example.com рядом с example.com | Убрать |
Сохранить оставляет версию ждущей, Сохранить и одобрить сразу её одобряет. Обеим кнопкам нужна проверка текущего содержимого, которая нашла изменение и не нашла дубликата. Присланный сет сохраняется, поэтому карточка и панель показывают, что изменилось.
Правка текста опубликованной версии
Изменить название на версии вне очереди меняет её название и описание и больше ничего. Роутеры не видят новой версии, голоса продолжают считаться, а новые пользователи получают новое название со следующей сборки.
Сеты
Пять вкладок хранят то, что уже решено: В каталоге - версия каждого сета в каталоге; Устаревшие - более старые одобренные версии; Не публикуются - снятые сеты и сеты заблокированных авторов; Скрытые и Отклонённые - с причинами. Версии, скрытые по жалобам, ждут проверки на вкладке Скрытые.
Карточки добавляют оценку, которую роутеры получили в последней сборке: зелёная от 70%, оранжевая от 40%, красная ниже. Если следующая сборка изменит оценку, за ней идёт далее:. На вкладке В каталоге переключатель Требуют внимания оставляет сеты с отметками, которых роутеры не видят:
| Отметка | Когда |
|---|---|
| низкая оценка | Не меньше 3 взвешенных голосов и оценка ниже 30% |
| устарел | 60 дней без голосов, и вес почти не остался |
| ниже 50% | Независимых голосов достаточно для оценки, и она ниже 50% |
| открытые жалобы | На опубликованную версию есть открытые жалобы |
Карточка открывает панель сета со всеми версиями, голосами и Историей. Там можно вернуть скрытую версию и всё-таки одобрить отклонённую.
Снять сет в панели убирает весь сет из каталога при следующей сборке, а Вернуть в каталог возвращает ровно то, что было опубликовано. Новая версия снятого сета по-прежнему попадает в очередь. Удалить навсегда удаляет сет со всеми версиями, голосами, жалобами и неиспользуемыми файлами payload после ввода id сета. Это для записи, которой не должно было быть. Роутеры, применившие сет, сохраняют свою копию.
Ключи
По строке на каждого участника, по HMAC, с активностью и последней сетью. Поиск принимает и идентификатор ключа, который роутер показывает в блоке Авторский ключ. Заметки оператора добавляют имя, которое показывается вместо HMAC, заметку и метку. Метка свой ни на что не влияет. Метка тест выключает учёт голосов и жалоб ключа и убирает его активность из статистики.
Доверять перестаёт учитывать ключ в суточных лимитах на ключ; его сеты по-прежнему ждут модератора, а лимиты на сеть продолжают действовать. Снять доверие возвращает учёт.
Блокировка ключа
Блокировка - обратимый карантин. С момента блокировки:
- каждая новая запись, подписанная ключом, отклоняется;
- при следующей сборке его сеты уходят из каталога на вкладку Не публикуются;
- его голоса перестают учитываться, а жалобы - идти в счёт автоматического скрытия;
- его ждущие версии можно одобрить только со вторым подтверждением, и они остаются вне каталога.
Ничего не удаляется, и Разблокировать возвращает всё при следующей сборке. Диалог блокировки показывает, что она затронет, и называет зеркала, объявленные ключом. Блокировка оставляет их в манифесте, а убирает их отклонение на странице «Зеркала».
Зеркала
Все хабы, объявившие себя зеркалами этого, ждущие первыми, с ключом, которым они объявлены.
| Статус | Что означает |
|---|---|
| ожидает | Ждёт решения |
| отклонено | Никогда не объявляется, причина в подсказке |
| в манифесте | Одобрено и есть в манифесте |
| добавляется, уходит | Попадёт в манифест или уйдёт из него при следующей сборке |
| остаётся | Не проходит проверку, но остаётся в манифесте, пока ни одно зеркало её не проходит |
| нет в манифесте | Одобрено и попадёт в манифест после следующей успешной проверки |
Одобрить сразу запускает проверку, и зеркало попадает в список, как только она пройдена. Отклонить требует причины, и зеркало никогда не объявляется. Удалить забывает зеркало, после чего оно может объявить себя снова. Проверить сейчас и Проверить все запускают проверку вручную, а подсказка неудачной проверки называет шаг, на котором произошёл сбой. Отдаёт сравнивает каталог зеркала с каталогом этого хаба: актуально, отстаёт на несколько сборок, устарело или новее этого хаба.
Отзывы
Голоса - все голоса с весом, который несёт каждый, с фильтрами по виду, ASN и Стране. У голоса, который не учитывается, указано почему, например ключ заблокирован или помечен как тест.
Как голоса складываются в оценку
Голоса считаются по стратегии, в трёх ячейках: ASN и страна, из которых хаб увидел голос, и весь мир.
| Голос | Вес |
|---|---|
| «Работает» | +1 |
| «Не работает» | -1 |
| Сама публикация, засчитанная автору как «работает» | +1 |
| Голос без известной сети, например переданный одобренным зеркалом | четверть от указанного |
| Голос с ключа, впервые увиденного меньше недели назад | четверть от указанного |
Понижения перемножаются. Каждый голос теряет половину веса каждые две недели. Оценка считается как (работает + 1) / (все + 2). Роутер использует ячейку, когда в ней проголосовали хотя бы два устройства и общий вес не меньше единицы. У хаба есть и ограниченные веса для автоматических голосов от детектора DPI, мониторинга и Дискавери, но b4 их пока не отправляет.
Жалобы
Жалобы - входящие. Жалоба открыта, пока модератор не отметит её как отклонена или обработана, а Открыть снова возвращает её. Скрытие, отклонение, возврат и снятие сета закрывают открытые жалобы на то, что они затрагивают.
Опубликованная версия скрывается автоматически, когда на неё набирается три открытые жалобы от независимых ключей и сетей. Учитываются только жалобы с известной сетью от ключей, которые не заблокированы и не помечены как тест. Возврат версии отклоняет её открытые жалобы, и счёт начинается заново.
Каталог
Страница показывает опубликованные файлы, зеркала и отозванные ключи из манифеста и Историю сборок: каждую сборку, почему она запускалась, её результат и что она изменила.
| Операция | Что делает |
|---|---|
| Собрать сейчас | Собирает каталог из базы, даже если ничего не менялось |
| Начать новую эпоху | Сбрасывает порядковый номер. Каждый роутер считает новую эпоху более новой и скачивает каталог заново |
| Отозвать ключ подписи хаба | Добавляет id ключа в список, который несёт каждый манифест. Роутеры перестают доверять всему, что им подписано |
Сборка, которая не окажется новее опубликованного каталога или каталога, который отдаёт одобренное зеркало, отклоняется. Так бывает после восстановления из старой резервной копии, и опубликовать такую базу позволяет новая эпоха, см. Сохранность данных. В остальных случаях новая эпоха лишь заставляет каждый роутер заново скачать каталог.
Роутеры хранят каждый отзыв навсегда. Хаб отказывается отзывать ключ, которым сам подписывает, а для отзыва ключа, встроенного в b4, нужно отдельное подтверждение: это отрезает все роутеры, которые доверяют этому ключу.
Отзыв называет ключ подписи хаба или зеркала и доходит до каждого роутера. Блокировка называет участника и действует только на этом хабе.
Статистика и журнал
Статистика показывает активность по дням UTC, распределение опубликованных оценок и откуда приходят голоса. Журнал записывает каждое действие со временем, исполнителем, объектом, причиной и изменёнными полями. Исполнитель - консоль, вход по паролю, командная строка или автоматически.
Настройки
Шесть лимитов действуют со следующего запроса:
| Лимит | Период | По умолчанию |
|---|---|---|
| Сетов на ключ | сутки | 5 |
| Голосов на ключ | сутки | 20 |
| Жалоб на ключ | сутки | 20 |
| Объявлений зеркал на ключ | сутки | 48 |
| Новых ключей на сеть | сутки | 5 |
| Запросов на сеть | час | 2000 |
Сутки - календарный день UTC, час - часовой интервал. Счётчики хранятся в памяти и обнуляются при перезапуске сервиса. Сеть здесь - /24 отправителя, для IPv6 - /48. Отклонённая запись и отправка-дубликат квоту не расходуют. Что роутер показывает при достижении лимита, описано в разделе Ограничения.
Сохранённые причины - список готовых причин для каждого диалога решений.
Уведомления
Хаб отправляет сводку новых событий в чат Telegram, на webhook или туда и туда. Для Telegram нужны токен бота и id чата: число или @имя публичного канала, причём бот должен состоять в чате. У супергруппы, форума и канала id чата равен -(1000000000000 + n), где n - число из ссылки t.me/c/, поэтому такой id начинается с -100. Для webhook нужен URL, https:// или обычный http:// к loopback или частному адресу, и необязательный секрет для подписи.
B4HUB_TELEGRAM_TOKEN, B4HUB_TELEGRAM_CHAT, B4HUB_WEBHOOK_URL и B4HUB_WEBHOOK_SECRET в окружении сервиса важнее консоли, и она показывает такое поле только для чтения. Значения, введённые в консоли, хранятся зашифрованными ключом, выведенным из secret.
События - новые сеты в очереди, жалобы, версии, скрытые по жалобам, неудачные сборки и новые зеркала. До первого сохранения настроек выбраны новые сеты и жалобы. Первое событие после затишья уходит сразу, следующие - не чаще одного сообщения за интервал сводки: по умолчанию 60 секунд, допустимо от 30 до 3600. Неудачная доставка повторяется с растущей задержкой, до 30 минут. Отправить тест проверяет сохранённый канал.
Webhook получает POST с телом в JSON:
{
"hub": "https://hub.example",
"sent_at": "2026-09-27T12:41:15Z",
"counts": { "share": 2, "report": 1 },
"events": [
{ "kind": "share", "at": "2026-09-27T12:40:58Z", "set_id": "01J9...", "version": 1, "title": "Example", "author": "70837b639d58b777", "asn": "12389", "country": "RU", "url": "https://hub.example/admin/sets/01J9.../v/1" }
],
"more": 0,
"console": "https://hub.example/admin/queue"
}
Каждый запрос несёт X-B4hub-Timestamp - Unix-время отправки. Если задан секрет, есть и X-B4hub-Signature: sha256=<hex> - HMAC-SHA256 под секретом от времени, точки и тела запроса как есть. Перенаправления не выполняются, а любой статус вне 2xx считается сбоем.
Без консоли
b4hub moderate делает из командной строки то же, что консоль, с теми же проверками и записями в журнале. Команда открывает базу напрямую, пока сервис работает. Каждое изменение оставляет запрос на сборку, который b4hub serve подхватывает примерно за 10 секунд.
| Команды | Что делают |
|---|---|
list, approve, reject, hide, restore | Очередь и решения по версиям. Сет указывается как <id> или <id>/<версия>. Можно указать несколько сразу, и approve применяется ко всем или ни к одному |
withdraw, reinstate, delete | Сеты целиком. delete требует --confirm <id> |
ban, unban, trust, untrust | Ключи, по HMAC |
reports, dismiss-report, resolve-report, reopen-report | Входящие жалобы |
mirrors, approve-mirror, reject-mirror, remove-mirror, check-mirror | Зеркала |
status, builds, epoch, revoke | Публикация, история сборок, новая эпоха и отзыв ключа подписи хаба с --confirm <key_id> |
audit | Журнал |
Правка версии, заметки и метки ключей, сохранённые причины, уведомления и лимиты доступны только в консоли.