## Мультисайтовый режим

Мультисайтовый режим — это ключевое понятие, которое необходимо понимать при использовании BunkerWeb. Поскольку цель состоит в защите веб-приложений, мы по своей сути наследуем концепцию «виртуального хоста» или «vhost» (подробнее [здесь](https://en.wikipedia.org/wiki/Virtual_hosting)), которая позволяет обслуживать несколько веб-приложений с одного (или кластера) экземпляра.

По умолчанию мультисайтовый режим BunkerWeb отключён, что означает, что будет обслуживаться только одно веб-приложение, и все настройки будут применяться к нему. Типичный сценарий использования — когда у вас есть одно приложение для защиты: вам не нужно беспокоиться о мультисайте, и поведение по умолчанию должно вам подойти.

Когда мультисайтовый режим включён, BunkerWeb будет обслуживать и защищать несколько веб-приложений. Каждое веб-приложение идентифицируется уникальным именем сервера и имеет свой собственный набор настроек. Типичный сценарий использования — когда у вас есть несколько приложений для защиты и вы хотите использовать один (или кластер, в зависимости от интеграции) экземпляр BunkerWeb.

## Пользовательские конфигурации

Поскольку решить все сценарии использования только с помощью настроек невозможно (даже с [внешними плагинами](https://docs.bunkerweb.io/1.6.14/plugins/?utm_campaign=self&utm_source=github)), вы можете использовать пользовательские конфигурации для решения своих конкретных задач.

Под капотом BunkerWeb использует известный веб-сервер NGINX, поэтому вы можете задействовать его систему конфигурации для своих конкретных нужд. Пользовательские конфигурации NGINX могут быть включены в разных [контекстах](https://docs.nginx.com/nginx/admin-guide/basic-functionality/managing-configuration-files/#contexts), например HTTP или server (все серверы и/или конкретный серверный блок).

Ещё один ключевой компонент BunkerWeb — это межсетевой экран для веб-приложений ModSecurity: вы также можете использовать пользовательские конфигурации, например, для исправления ложных срабатываний или добавления собственных правил.

## База данных

<p align="center">
	<img alt="Database model" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/bunkerweb_db.svg" />
</p>

Текущее состояние конфигурации BunkerWeb хранится в серверной базе данных, которая содержит следующие данные:

- Настройки, определённые для всех сервисов
- Пользовательские конфигурации
- Экземпляры BunkerWeb
- Метаданные о выполнении заданий
- Кэшированные файлы

Поддерживаются следующие серверные базы данных: SQLite, MariaDB, MySQL и PostgreSQL.

## Планировщик

Чтобы всё «автомагически» работало вместе, специальный сервис, называемый планировщиком, отвечает за:

- Хранение настроек и пользовательских конфигураций в базе данных
- Выполнение различных задач (называемых заданиями)
- Генерацию конфигурации, понятной BunkerWeb
- Роль посредника для других сервисов (например, веб-интерфейса или autoconf)

Другими словами, планировщик — это мозг BunkerWeb.

# Установка

<!--## BunkerWeb Cloud

<p align="center">
	<img alt="Docker banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/bunkerweb-cloud.webp" />
</p>

BunkerWeb Cloud is the easiest way to get started with BunkerWeb. It offers you a fully managed BunkerWeb service with no hassle. Think of it like a BunkerWeb-as-a-Service!

You will find more information about BunkerWeb Cloud beta [here](https://www.bunkerweb.io/cloud?utm_campaign=self&utm_source=docs) and you can apply for free [in the BunkerWeb panel](https://panel.bunkerweb.io/store/bunkerweb-cloud?utm_campaign=self&utm_source=docs).
-->
## Linux

<p align="center">
	<img alt="Linux banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-linux.svg" />
</p>

Список поддерживаемых дистрибутивов Linux:

- Debian 12 "Bookworm"
- Debian 13 "Trixie"
- Ubuntu 22.04 "Jammy"
- Ubuntu 24.04 "Noble"
- Ubuntu 26.04 "Resolute Raccoon"
- Fedora 43
- Fedora 44
- RHEL, CentOS, Rocky Linux и AlmaLinux 8, 9 и 10

Более подробную информацию вы найдёте в [разделе Linux](https://docs.bunkerweb.io/1.5.10/integrations/?utm_campaign=self&utm_source=github#linux) документации.

## Docker

<p align="center">
	<img alt="Docker banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-docker.svg" />
</p>

Мы предоставляем готовые предварительно собранные образы для платформ x64, x86, armv7 и arm64 на [Docker Hub](https://hub.docker.com/u/bunkerity).

Ключевые концепции интеграции Docker:

- **Переменные окружения** для настройки BunkerWeb
- **Контейнер планировщика** для хранения конфигурации и выполнения заданий
- **Сети** для открытия портов клиентам и подключения к вышестоящим веб-сервисам

Более подробную информацию вы найдёте в [разделе об интеграции Docker](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#docker) документации.

## Docker autoconf

<p align="center">
	<img alt="Docker autoconf banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-autoconf.svg" />
</p>

Недостаток использования переменных окружения в том, что контейнер необходимо пересоздавать при каждом обновлении, что не очень удобно. Чтобы решить эту проблему, вы можете использовать другой образ, называемый **autoconf**, который будет прослушивать события Docker и автоматически перенастраивать BunkerWeb в реальном времени без пересоздания контейнера.

Вместо определения переменных окружения для контейнера BunkerWeb вы просто добавляете **метки** к контейнерам ваших веб-приложений, а **autoconf** «автомагически» позаботится обо всём остальном.

Более подробную информацию вы найдёте в [разделе Docker autoconf](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#docker-autoconf) документации.

## Kubernetes

<p align="center">
	<img alt="Kubernetes banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-kubernetes.svg" />
</p>

autoconf действует как [Ingress controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) и настраивает экземпляры BunkerWeb в соответствии с [ресурсами Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/). Он также отслеживает другие объекты Kubernetes, такие как [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/), для пользовательских конфигураций.

Официальный [Helm chart](https://helm.sh/) для BunkerWeb доступен в [репозитории bunkerity/bunkerweb-helm](https://github.com/bunkerity/bunkerweb-helm).

Более подробную информацию вы найдёте в [разделе Kubernetes](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#kubernetes) документации.

## Microsoft Azure

<p align="center">
	<img alt="Azure banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-azure.webp" />
</p>

BunkerWeb представлен в [Azure Marketplace](https://azuremarketplace.microsoft.com/fr-fr/marketplace/apps/bunkerity.bunkerweb?tab=Overview), а ARM-шаблон доступен в [папке misc](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/misc/integrations/azure-arm-template.json).

Более подробную информацию вы найдёте в [разделе Microsoft Azure](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#microsoft-azure) документации.

## Swarm

<p align="center">
	<img alt="Swarm banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-swarm.svg" />
</p>

Для автоматической настройки экземпляров BunkerWeb специальный сервис, называемый **autoconf**, будет прослушивать события Docker Swarm, такие как создание или удаление сервисов, и автоматически настраивать **экземпляры BunkerWeb** в реальном времени без простоев.

Как и в [интеграции Docker autoconf](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#docker-autoconf), конфигурация веб-сервисов определяется с помощью меток, начинающихся со специального префикса **bunkerweb.**.

Более подробную информацию вы найдёте в [разделе Swarm](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#swarm) документации.

# Краткое руководство

После того как вы настроили BunkerWeb с помощью выбранной интеграции, вы можете следовать [краткому руководству](https://docs.bunkerweb.io/1.6.14/quickstart-guide/?utm_campaign=self&utm_source=github), которое охватывает установку и первую настройку для защиты веб-сервиса.

# Настройка безопасности

BunkerWeb предлагает множество функций безопасности, которые вы можете настроить с помощью [функций](https://docs.bunkerweb.io/1.6.14/features/?utm_campaign=self&utm_source=github). Даже если значения по умолчанию обеспечивают минимальную «безопасность по умолчанию», мы настоятельно рекомендуем вам их настроить. Таким образом вы сможете обеспечить желаемый уровень безопасности, а также управлять ложными срабатываниями.

Более подробную информацию вы найдёте в [разделе о настройке безопасности](https://docs.bunkerweb.io/1.6.14/advanced/?utm_campaign=self&utm_source=github#security-tuning) документации.

# Настройки

Как правило, когда мультисайтовый режим включён, если вы хотите применить настройки с мультисайтовым контекстом к конкретному серверу, вам нужно добавить основное (первое) имя сервера в качестве префикса, например `www.example.com_USE_ANTIBOT=captcha` или `myapp.example.com_USE_GZIP=yes`.

Когда настройки считаются «множественными», это означает, что вы можете иметь несколько групп настроек для одной и той же функции, добавляя числа в качестве суффиксов, например `REVERSE_PROXY_URL_1=/subdir`, `REVERSE_PROXY_HOST_1=http://myhost1`, `REVERSE_PROXY_URL_2=/anotherdir`, `REVERSE_PROXY_HOST_2=http://myhost2`, ...

Полный список см. в [разделе о функциях](https://docs.bunkerweb.io/1.6.14/features/?utm_campaign=self&utm_source=github) документации.

# Веб-интерфейс

https://github.com/user-attachments/assets/a3ed56f8-c124-4ca9-b8b3-4be0913b3078

«Веб-интерфейс» — это веб-приложение, которое помогает управлять вашим экземпляром BunkerWeb с помощью удобного интерфейса вместо командной строки.

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

- Полный обзор заблокированных атак
- Запуск, остановка, перезапуск и перезагрузка вашего экземпляра BunkerWeb
- Добавление, редактирование и удаление настроек для ваших веб-приложений
- Добавление, редактирование и удаление пользовательских конфигураций для NGINX и ModSecurity
- Установка и удаление внешних плагинов
- Просмотр кэшированных файлов
- Мониторинг выполнения заданий и их перезапуск при необходимости
- Просмотр журналов и поиск шаблонов

Более подробную информацию вы найдёте в [разделе о веб-интерфейсе](https://docs.bunkerweb.io/1.6.14/web-ui/?utm_campaign=self&utm_source=github) документации.

# Плагины

BunkerWeb поставляется с системой плагинов, позволяющей легко добавлять новые функции. После установки плагина вы можете управлять им с помощью дополнительных настроек, определённых плагином.

Вот список «официальных» плагинов, которые мы поддерживаем (см. репозиторий [bunkerweb-plugins](https://github.com/bunkerity/bunkerweb-plugins/?utm_campaign=self&utm_source=github) для получения дополнительной информации):

|      Название      | Версия | Описание                                                                                                                      |                                                Ссылка                                                 |
| :------------: | :-----: | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------: |
|   **ClamAV**   |   1.9   | Автоматически сканирует загруженные файлы с помощью антивирусного движка ClamAV и отклоняет запрос, когда файл обнаружен как вредоносный. |     [bunkerweb-plugins/clamav](https://github.com/bunkerity/bunkerweb-plugins/tree/main/clamav)     |
|   **Coraza**   |   1.9   | Проверяет запросы с помощью WAF Coraza (альтернатива ModSecurity).                                                              |     [bunkerweb-plugins/coraza](https://github.com/bunkerity/bunkerweb-plugins/tree/main/coraza)     |
|  **Discord**   |   1.9   | Отправляет уведомления о безопасности в канал Discord через Webhook.                                                            |    [bunkerweb-plugins/discord](https://github.com/bunkerity/bunkerweb-plugins/tree/main/discord)    |
|   **Slack**    |   1.9   | Отправляет уведомления о безопасности в канал Slack через Webhook.                                                              |      [bunkerweb-plugins/slack](https://github.com/bunkerity/bunkerweb-plugins/tree/main/slack)      |
| **VirusTotal** |   1.9   | Автоматически сканирует загруженные файлы с помощью VirusTotal API и отклоняет запрос, когда файл обнаружен как вредоносный.      | [bunkerweb-plugins/virustotal](https://github.com/bunkerity/bunkerweb-plugins/tree/main/virustotal) |
|  **WebHook**   |   1.9   | Отправляет уведомления о безопасности на пользовательскую HTTP-конечную точку через Webhook.                                     |    [bunkerweb-plugins/webhook](https://github.com/bunkerity/bunkerweb-plugins/tree/main/webhook)    |

Более подробную информацию вы найдёте в [разделе о плагинах](https://docs.bunkerweb.io/1.6.14/plugins/?utm_campaign=self&utm_source=github) документации.

# Поддержка языков и локализация

Веб-интерфейс BunkerWeb поддерживает несколько языков. Переводы хранятся в каталоге `src/ui/app/static/locales`. В настоящее время доступны следующие языки:

- Арабский (ar)
- Бенгальский (bn)
- Бразильский португальский (br)
- Немецкий (de)
- Английский (en)
- Испанский (es)
- Французский (fr)
- Хинди (hi)
- Итальянский (it)
- Корейский (ko)
- Польский (pl)
- Португальский (pt)
- Русский (ru)
- Турецкий (tr)
- Традиционный китайский (tw)
- Урду (ur)
- Упрощённый китайский (zh)

Подробности о происхождении переводов и статусе проверки см. в [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/src/ui/app/static/locales/README.md).

## Участие в переводах

Мы приветствуем вклад в улучшение существующих или добавление новых файлов локализации!

**Как внести свой перевод:**

1. Отредактируйте файл `src/ui/app/lang_config.py`, чтобы добавить свой язык (код, название, флаг, english_name).
2. Скопируйте `en.json` в качестве шаблона в `src/ui/app/static/locales/` и переименуйте его в код вашего языка (например, `de.json` для немецкого).
3. Переведите значения в вашем новом файле.
4. Обновите таблицу в `locales/README.md`, чтобы добавить свой язык и указать, кто его создал/проверил.
5. Отправьте pull request.

Для обновлений отредактируйте соответствующий файл и при необходимости обновите таблицу происхождения.

Полные рекомендации см. в [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/src/ui/app/static/locales/README.md).

# Поддержка

## Профессиональная поддержка

Получите техническую поддержку непосредственно от сопровождающих BunkerWeb. Более подробную информацию вы найдёте на [BunkerWeb Panel](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=github) — нашей специализированной платформе для профессиональных услуг.

Не стесняйтесь [связаться с нами](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=github), если у вас есть вопросы; мы будем рады удовлетворить ваши потребности.

## Сообщество

Для получения бесплатной поддержки сообщества вы можете использовать следующие каналы:

- Канал #help BunkerWeb на [сервере Discord](https://discord.com/invite/fTf46FmtyD)
- Категорию помощи в [обсуждениях GitHub](https://github.com/bunkerity/bunkerweb/discussions)
- Сабреддит [/r/BunkerWeb](https://www.reddit.com/r/BunkerWeb)
- Форумы [Server Fault](https://serverfault.com/) и [Super User](https://superuser.com/)

Пожалуйста, не используйте [GitHub issues](https://github.com/bunkerity/bunkerweb/issues) для получения помощи; используйте их только для сообщений об ошибках и запросов функций.

# Лицензия

Этот проект лицензирован на условиях [GNU Affero General Public License (AGPL) версии 3](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/LICENSE.md).

# Участие в разработке

Если вы хотите внести вклад в плагины, вы можете начать с чтения [руководства по внесению вклада](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/CONTRIBUTING.md).

# Политика безопасности

Мы относимся к ошибкам безопасности как к серьёзным проблемам и поощряем ответственное раскрытие информации; см. нашу [политику безопасности](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/SECURITY.md) для получения дополнительной информации.

<!-- Star History chart hidden: GitHub restricted the stargazers API, so the chart renders an error
     notice instead of data. Uncomment once upstream serves real charts again.

# Star History

<a href="https://star-history.com/#bunkerity/bunkerweb&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bunkerity/bunkerweb&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bunkerity/bunkerweb&type=Date" />
   Star History Chart
 </picture>
</a>
-->