## Режим мультисайта

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

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

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

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

Поскольку охватить все случаи использования только с помощью настроек невозможно (даже с [внешними плагинами](https://docs.bunkerweb.io/1.6.15/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 (все серверы и/или конкретный блок server).

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

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

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

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

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

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

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

Чтобы всё работало вместе «как по волшебству», выделенный сервис под названием планировщик (scheduler) отвечает за:

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

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

# Установка

Собираете образы контейнеров или пакеты Linux из исходного кода? См. [руководство по сборке сообществом](https://github.com/bunkerity/bunkerweb/blob/master/docs/building.md).

<!--## BunkerWeb Cloud

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

BunkerWeb Cloud — это самый простой способ начать работу с BunkerWeb. Он предлагает вам полностью управляемый сервис BunkerWeb без лишних хлопот. Воспринимайте его как BunkerWeb-as-a-Service!

Вы найдёте больше информации о бета-версии BunkerWeb Cloud [здесь](https://www.bunkerweb.io/saas-offer-cloud/?utm_campaign=self&utm_source=docs), а подать заявку можно бесплатно [в панели BunkerWeb](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.15/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.6.15/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.15/docs/assets/img/integration-docker.svg" />
</p>

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

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

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

Вы найдёте больше информации в [разделе интеграции с Docker](https://docs.bunkerweb.io/1.6.15/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.15/docs/assets/img/integration-autoconf.svg" />
</p>

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

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

Вы найдёте больше информации в [разделе Docker autoconf](https://docs.bunkerweb.io/1.6.15/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.15/docs/assets/img/integration-kubernetes.svg" />
</p>

Autoconf действует как [Ingress-контроллер](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-чарт](https://helm.sh/) для BunkerWeb доступен в [репозитории bunkerity/bunkerweb-helm](https://github.com/bunkerity/bunkerweb-helm).

Вы найдёте больше информации в [разделе Kubernetes](https://docs.bunkerweb.io/1.6.15/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.15/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.15/misc/integrations/azure-arm-template.json).

Вы найдёте больше информации в [разделе Microsoft Azure](https://docs.bunkerweb.io/1.6.15/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.15/docs/assets/img/integration-swarm.svg" />
</p>

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

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

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

# Руководство по быстрому старту

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

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

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

Вы найдёте больше информации в [разделе настройки безопасности](https://docs.bunkerweb.io/1.6.15/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.15/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.15/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   | Автоматически сканирует загруженные файлы с помощью API VirusTotal и отклоняет запрос, когда файл определяется как вредоносный.          | [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.15/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.15/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.15/src/ui/app/static/locales/README.md) для получения полных рекомендаций.

# Поддержка

## Профессиональная

Получите техническую поддержку напрямую от сопровождающих BunkerWeb. Вы найдёте больше информации, посетив [Панель BunkerWeb](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)
- Категория help в [обсуждениях 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.15/LICENSE.md).

# Вклад

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

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

Мы относимся к ошибкам безопасности как к серьёзным проблемам и поощряем ответственное раскрытие; см. нашу [политику безопасности](https://github.com/bunkerity/bunkerweb/blob/master/.github/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>
-->