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

Защита веб-интерфейса

По умолчанию веб-интерфейс открывается без пароля для любого, кто дотянется до его порта. Вход по паролю и HTTPS защищают его, а переключатели Доступ из интернета определяют, доступен ли он или прокси b4 из интернета.

Требования​

  • Доступ к веб-интерфейсу.
  • Для HTTPS - сертификат и закрытый ключ в виде PEM-файлов на роутере.

Вход по паролю​

  1. Откройте Настройки > Система > Веб-сервер.
  2. В разделе Аутентификация заполните Имя пользователя и Пароль.
  3. Нажмите Сохранить.

После этого веб-интерфейс запрашивает логин. Вход по паролю работает, только когда заполнены оба поля. Сессия длится до перезапуска b4 или до 24 часов без использования. Новый пароль не закрывает уже открытые сессии, их закрывает перезапуск. После 5 неудачных попыток входа за 15 минут вход с этого адреса блокируется на 5 минут. Поля описаны в разделе Веб-сервер.

Включение HTTPS​

Без HTTPS логин, пароль и каждая сессия передаются по сети без шифрования.

  1. Скопируйте сертификат и ключ на роутер, например в папку файла конфигурации.
  2. Откройте Настройки > Система > Веб-сервер.
  3. Укажите пути к ним в полях TLS Сертификат и TLS Ключ.
  4. Нажмите Сохранить, затем Перезапустить сервис.
  5. Откройте веб-интерфейс по тому же адресу через https://.

Для локальной сети достаточно самоподписанного сертификата:

openssl req -x509 -newkey rsa:2048 -keyout server.key -out server.crt -days 365 -nodes -subj "/CN=b4"

Ключ должен быть PEM-файлом без пароля. Сохранение отклоняется, если файла нет, у ключа есть пароль или сертификат не подходит к ключу. Пароль снимается командой openssl pkey -in key.pem -out key-plain.pem. b4 читает файлы при запуске, поэтому обновлённый сертификат начинает действовать после перезапуска.

Доступ из интернета​

У каждого слушателя из таблицы ниже рядом с портом есть переключатель Доступ из интернета, по умолчанию выключенный. Если он включён, b4 добавляет на своём хосте правило файрвола, которое принимает TCP-соединения на этот порт с любого адреса, по IPv4 и IPv6. b4 возвращает правило после перезагрузки файрвола роутера и удаляет его, когда переключатель выключают или b4 останавливается. Переключатели применяются при сохранении.

СлушательПереключательПорт открывается, только если
Веб-интерфейсНастройки > Система > Веб-серверЗаданы имя пользователя и пароль
MTProto-проксиНастройки > Telegram > MTProto ПроксиПрокси включён
Порт relay WEB-проксиНастройки > Telegram > WEB-прокси Telegram DesktopВключены MTProto-прокси и его WEB-прокси, а в поле Порт relay указан порт
SOCKS5-проксиНастройки > Основные > SOCKS5Прокси включён с логином или списком Разрешённые источники, а у веб-интерфейса, если он работает, задан логин

Чтобы открыть веб-интерфейс из интернета:

  1. Настройте вход по паролю и HTTPS, как описано выше.
  2. Включите Доступ из интернета в Настройки > Система > Веб-сервер.
  3. Нажмите Сохранить.

Порт веб-интерфейса обслуживает также API, MCP-сервер и, если у WEB-прокси нет своего порта relay, сам relay, поэтому переключатель открывает их все вместе. После смены порта правило переезжает на новый порт при следующем перезапуске.

Клиент SOCKS5 может подключиться к любому адресу, в том числе к портам самого роутера и к веб-интерфейсу. Поэтому для открытия прокси нужен ещё и логин веб-интерфейса. SOCKS5 передаёт свой логин без шифрования. Правило покрывает только TCP, поэтому на хосте, который отбрасывает входящие соединения, UDP через прокси снаружи не работает.

Выключенный переключатель не добавляет правил, но и порт не блокирует. На хосте, который принимает входящие соединения, например на VPS без файрвола, любой слушатель на 0.0.0.0 доступен из интернета при любом положении переключателя. Закрытым слушатель остаётся благодаря полю Адрес привязки с адресом LAN или 127.0.0.1 либо собственному файрволу хоста.

Без входа по паролю

Любой, кто дотянется до веб-интерфейса без пароля, получает полное управление b4. Без имени пользователя и пароля b4 не открывает веб-интерфейс в интернет, но на хосте без файрвола адрес по умолчанию 0.0.0.0 всё равно доступен из интернета.

Что переключатель открыть не может​

Правило открывает порт только на хосте, где работает b4.

СитуацияЧто нужно
CGNAT: WAN-адрес из 100.64.0.0/10Из интернета до него по IPv4 не дойти. Публичный IPv6-адрес на WAN это не затрагивает.
Роутер или модем перед b4: частный WAN-адрес, например 192.168.x.xПроброс порта ещё и на этом устройстве, если провайдер его допускает.
Облачный файрвол: группы безопасности AWS, сетевые группы безопасности Azure, правила файрвола Google Cloud, списки безопасности Oracle CloudОтдельное правило в файрволе провайдера.
b4 в контейнере MikroTikПравило dst-nat на RouterOS, см. MikroTik.
firewalld, который владеет своей таблицей nftables, как в Fedora 42, RHEL 10 и Debian 13Открыть порт в самом firewalld: firewall-cmd --permanent --add-port=<порт>/tcp, затем firewall-cmd --reload. Лог называет эти команды.
Включено Пропустить настройку IPTables/NFTablesНичего: b4 не добавляет правил, а переключатели неактивны.

Как устроены эти правила, описано в разделе Перехват пакетов.

Проверка результата​

  • В приватном окне браузера веб-интерфейс запрашивает логин.
  • С HTTPS адрес открывается через https://.
  • Каждое изменение лог записывает строкой, начинающейся с Expose:. В ней названы открытые порты, включённый переключатель, который ничего не открыл, и правила, возвращённые после перезагрузки файрвола.
  • Для MTProto-прокси окно Поделиться подключением MTProto предупреждает, если порт не открыт.

Если не работает​

  • Вход отклоняется после нескольких попыток. Адрес заблокирован на 5 минут.
  • За обратным прокси страницы Логи, Трафик и Главная не показывают данные в реальном времени. Без входа по паролю b4 отправляет эти данные только странице на адресе из заголовка Host запроса. Прокси сохраняет исходный Host, как nginx с proxy_set_header Host $host;, и добавляет X-Forwarded-Proto, если оставляет порт в Host. Когда вход по паролю задан, адрес не проверяется. Отклонённую страницу лог называет в строке, которая начинается с Web server: refused.
  • Пароль забыт. b4 хранит только его хеш. Если остановить b4, удалить имя пользователя и пароль веб-сервера из файла конфигурации и снова запустить b4, вход по паролю отключится.
  • Интерфейс по-прежнему открывается по HTTP. Дашборд показывает TLS веб-сервера не работает, вместо него используется обычный HTTP с причиной, например перемещённым или заменённым файлом.
  • Порт не открывается снаружи. Причину называют строки Expose: в логе, а внешние причины перечислены в разделе Что переключатель открыть не может.