Перейти к основному содержимому

Консоль модерации

Каждая версия каждого сета ждёт модератора, прежде чем попасть в каталог, и решение принимается в консоли. Консоль входит в 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.comexample.com
Запись www. без доменаодин www.example.comexample.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Журнал

Правка версии, заметки и метки ключей, сохранённые причины, уведомления и лимиты доступны только в консоли.