## Modo multisite

O modo multisite é um conceito crucial para entender ao usar o BunkerWeb. Como o objetivo é proteger aplicações web, herdamos inerentemente o conceito de "virtual host" ou "vhost" (mais informações [aqui](https://en.wikipedia.org/wiki/Virtual_hosting)), que possibilita servir várias aplicações web a partir de uma única instância (ou de um cluster de instâncias).

Por padrão, o modo multisite do BunkerWeb está desativado, o que significa que apenas uma aplicação web será servida e todas as configurações serão aplicadas a ela. O caso de uso típico é quando você tem uma única aplicação para proteger: você não precisa se preocupar com o multisite, e o comportamento padrão deve ser o ideal para você.

Quando o modo multisite está ativado, o BunkerWeb servirá e protegerá várias aplicações web. Cada aplicação web é identificada por um nome de servidor exclusivo e possui seu próprio conjunto de configurações. O caso de uso típico é quando você tem várias aplicações para proteger e deseja usar uma única instância do BunkerWeb (ou um cluster, dependendo da integração).

## Configurações personalizadas

Como atender a todos os casos de uso apenas com as configurações não é uma opção (mesmo com [plugins externos](https://docs.bunkerweb.io/1.6.14/plugins/?utm_campaign=self&utm_source=github)), você pode usar configurações personalizadas para resolver seus desafios específicos.

Por baixo dos panos, o BunkerWeb usa o renomado servidor web NGINX, e é por isso que você pode aproveitar o sistema de configuração dele para suas necessidades específicas. Configurações personalizadas do NGINX podem ser incluídas em diferentes [contextos](https://docs.nginx.com/nginx/admin-guide/basic-functionality/managing-configuration-files/#contexts), como HTTP ou server (todos os servidores e/ou blocos de servidor específicos).

Outro componente essencial do BunkerWeb é o Web Application Firewall ModSecurity: você também pode usar configurações personalizadas para corrigir alguns falsos positivos ou adicionar regras personalizadas, por exemplo.

## Banco de dados

<p align="center">
	<img alt="Modelo do banco de dados" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/bunkerweb_db.svg" />
</p>

O estado da configuração atual do BunkerWeb é armazenado em um banco de dados de backend que contém os seguintes dados:

- Configurações definidas para todos os serviços
- Configurações personalizadas
- Instâncias do BunkerWeb
- Metadados sobre a execução de tarefas (jobs)
- Arquivos em cache

Os seguintes bancos de dados de backend são suportados: SQLite, MariaDB, MySQL e PostgreSQL.

## Scheduler

Para fazer as coisas funcionarem de forma automágica em conjunto, um serviço dedicado chamado scheduler é responsável por:

- Armazenar as configurações e as configurações personalizadas no banco de dados
- Executar várias tarefas (chamadas de jobs)
- Gerar uma configuração que seja compreendida pelo BunkerWeb
- Servir de intermediário para outros serviços (como a web UI ou o autoconf)

Em outras palavras, o scheduler é o cérebro do BunkerWeb.

# Instalação

<!--## BunkerWeb Cloud

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

O BunkerWeb Cloud é a maneira mais fácil de começar a usar o BunkerWeb. Ele oferece um serviço BunkerWeb totalmente gerenciado, sem complicações. Pense nele como um BunkerWeb-como-Serviço!

Você encontrará mais informações sobre o beta do BunkerWeb Cloud [aqui](https://www.bunkerweb.io/cloud?utm_campaign=self&utm_source=docs) e pode se candidatar gratuitamente [no painel do BunkerWeb](https://panel.bunkerweb.io/store/bunkerweb-cloud?utm_campaign=self&utm_source=docs).
-->
## Linux

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

Lista de distribuições Linux suportadas:

- 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 e AlmaLinux 8, 9 e 10

Você encontrará mais informações na [seção Linux](https://docs.bunkerweb.io/1.5.10/integrations/?utm_campaign=self&utm_source=github#linux) da documentação.

## Docker

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

Fornecemos imagens pré-construídas prontas para uso para as plataformas x64, x86, armv7 e arm64 no [Docker Hub](https://hub.docker.com/u/bunkerity).

Os conceitos-chave da integração Docker são:

- **Variáveis de ambiente** para configurar o BunkerWeb
- Container **Scheduler** para armazenar a configuração e executar tarefas (jobs)
- **Redes** para expor portas para os clientes e conectar-se aos serviços web upstream

Você encontrará mais informações na [seção de integração com Docker](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#docker) da documentação.

## Docker autoconf

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

A desvantagem de usar variáveis de ambiente é que o container precisa ser recriado sempre que há uma atualização, o que não é muito conveniente. Para contornar esse problema, você pode usar outra imagem chamada **autoconf**, que escuta os eventos do Docker e reconfigura automaticamente o BunkerWeb em tempo real, sem recriar o container.

Em vez de definir variáveis de ambiente para o container do BunkerWeb, basta adicionar **labels** aos containers das suas aplicações web e o **autoconf** cuidará do resto "automagicamente".

Você encontrará mais informações na [seção Docker autoconf](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#docker-autoconf) da documentação.

## Kubernetes

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

O autoconf atua como um [Ingress controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) e configurará as instâncias do BunkerWeb de acordo com os [Ingress resources](https://kubernetes.io/docs/concepts/services-networking/ingress/). Ele também monitora outros objetos do Kubernetes, como [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/), para configurações personalizadas.

O [Helm chart](https://helm.sh/) oficial para o BunkerWeb está disponível no [repositório bunkerity/bunkerweb-helm](https://github.com/bunkerity/bunkerweb-helm).

Você encontrará mais informações na [seção Kubernetes](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#kubernetes) da documentação.

## Microsoft Azure

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

O BunkerWeb está listado no [Azure Marketplace](https://azuremarketplace.microsoft.com/fr-fr/marketplace/apps/bunkerity.bunkerweb?tab=Overview) e um modelo ARM está disponível na [pasta misc](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/misc/integrations/azure-arm-template.json).

Você encontrará mais informações na [seção Microsoft Azure](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#microsoft-azure) da documentação.

## Swarm

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

Para configurar automaticamente as instâncias do BunkerWeb, um serviço especial chamado **autoconf** escuta os eventos do Docker Swarm, como criação ou exclusão de serviços, e configura automaticamente as **instâncias do BunkerWeb** em tempo real, sem tempo de inatividade.

Assim como na [integração Docker autoconf](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#docker-autoconf), a configuração dos serviços web é definida usando labels que começam com o **bunkerweb.** como prefixo especial.

Você encontrará mais informações na [seção Swarm](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#swarm) da documentação.

# Guia de início rápido

Depois de configurar o BunkerWeb com a integração de sua escolha, você pode seguir o [guia de início rápido](https://docs.bunkerweb.io/1.6.14/quickstart-guide/?utm_campaign=self&utm_source=github), que abordará a instalação e a primeira configuração para proteger um serviço web.

# Ajuste de segurança

O BunkerWeb oferece muitos recursos de segurança que você pode configurar com [features](https://docs.bunkerweb.io/1.6.14/features/?utm_campaign=self&utm_source=github). Mesmo que os valores padrão das configurações garantam uma "segurança por padrão" mínima, recomendamos fortemente que você os ajuste. Ao fazer isso, você poderá garantir um nível de segurança de sua escolha e também gerenciar falsos positivos.

Você encontrará mais informações na [seção de ajuste de segurança](https://docs.bunkerweb.io/1.6.14/advanced/?utm_campaign=self&utm_source=github#security-tuning) da documentação.

# Configurações

Como regra geral, quando o modo multisite está ativado, se você quiser aplicar configurações com contexto multisite a um servidor específico, você precisará adicionar o nome do servidor primário (o primeiro) como prefixo, como `www.example.com_USE_ANTIBOT=captcha` ou `myapp.example.com_USE_GZIP=yes`, por exemplo.

Quando as configurações são consideradas "múltiplas", isso significa que você pode ter vários grupos de configurações para o mesmo recurso adicionando números como sufixos, como `REVERSE_PROXY_URL_1=/subdir`, `REVERSE_PROXY_HOST_1=http://myhost1`, `REVERSE_PROXY_URL_2=/anotherdir`, `REVERSE_PROXY_HOST_2=http://myhost2`, ... por exemplo.

Consulte a [seção de features](https://docs.bunkerweb.io/1.6.14/features/?utm_campaign=self&utm_source=github) da documentação para obter a lista completa.

# Web UI

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

A "Web UI" é uma aplicação web que ajuda você a gerenciar sua instância do BunkerWeb usando uma interface amigável, em vez da interface de linha de comando.

Aqui está a lista de recursos oferecidos pela web UI:

- Obter uma visão abrangente dos ataques bloqueados
- Iniciar, parar, reiniciar e recarregar sua instância do BunkerWeb
- Adicionar, editar e excluir configurações para suas aplicações web
- Adicionar, editar e excluir configurações personalizadas para NGINX e ModSecurity
- Instalar e desinstalar plugins externos
- Explorar os arquivos em cache
- Monitorar a execução de tarefas (jobs) e reiniciá-las quando necessário
- Visualizar os logs e pesquisar padrões

Você encontrará mais informações na [seção Web UI](https://docs.bunkerweb.io/1.6.14/web-ui/?utm_campaign=self&utm_source=github) da documentação.

# Plugins

O BunkerWeb vem com um sistema de plugins que torna possível adicionar novos recursos facilmente. Depois que um plugin é instalado, você pode gerenciá-lo usando configurações adicionais definidas pelo plugin.

Aqui está a lista de plugins "oficiais" que mantemos (consulte o repositório [bunkerweb-plugins](https://github.com/bunkerity/bunkerweb-plugins/?utm_campaign=self&utm_source=github) para obter mais informações):

|      Nome      | Versão | Descrição                                                                                                                      |                                                Link                                                 |
| :------------: | :-----: | :------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------: |
|   **ClamAV**   |   1.9   | Escaneia automaticamente os arquivos enviados com o mecanismo antivírus ClamAV e nega a solicitação quando um arquivo é detectado como malicioso. |     [bunkerweb-plugins/clamav](https://github.com/bunkerity/bunkerweb-plugins/tree/main/clamav)     |
|   **Coraza**   |   1.9   | Inspeciona solicitações usando o WAF Coraza (alternativa ao ModSecurity).                                                              |     [bunkerweb-plugins/coraza](https://github.com/bunkerity/bunkerweb-plugins/tree/main/coraza)     |
|  **Discord**   |   1.9   | Envia notificações de segurança para um canal do Discord usando um Webhook.                                                                |    [bunkerweb-plugins/discord](https://github.com/bunkerity/bunkerweb-plugins/tree/main/discord)    |
|   **Slack**    |   1.9   | Envia notificações de segurança para um canal do Slack usando um Webhook.                                                                  |      [bunkerweb-plugins/slack](https://github.com/bunkerity/bunkerweb-plugins/tree/main/slack)      |
| **VirusTotal** |   1.9   | Escaneia automaticamente os arquivos enviados com a API do VirusTotal e nega a solicitação quando um arquivo é detectado como malicioso.          | [bunkerweb-plugins/virustotal](https://github.com/bunkerity/bunkerweb-plugins/tree/main/virustotal) |
|  **WebHook**   |   1.9   | Envia notificações de segurança para um endpoint HTTP personalizado usando um Webhook.                                                           |    [bunkerweb-plugins/webhook](https://github.com/bunkerity/bunkerweb-plugins/tree/main/webhook)    |

Você encontrará mais informações na [seção de plugins](https://docs.bunkerweb.io/1.6.14/plugins/?utm_campaign=self&utm_source=github) da documentação.

# Suporte a idiomas e localização

A Web UI do BunkerWeb suporta vários idiomas. As traduções são gerenciadas no diretório `src/ui/app/static/locales`. Os seguintes idiomas estão disponíveis atualmente:

- Árabe (ar)
- Bengali (bn)
- Português brasileiro (br)
- Alemão (de)
- Inglês (en)
- Espanhol (es)
- Francês (fr)
- Hindi (hi)
- Italiano (it)
- Coreano (ko)
- Polonês (pl)
- Português (pt)
- Russo (ru)
- Turco (tr)
- Chinês tradicional (tw)
- Urdu (ur)
- Chinês simplificado (zh)

Consulte o [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/src/ui/app/static/locales/README.md) para obter detalhes sobre a proveniência das traduções e o status de revisão.

## Contribuindo com traduções

Agradecemos contribuições para melhorar ou adicionar novos arquivos de locale!

**Como contribuir com uma tradução:**

1. Edite o arquivo `src/ui/app/lang_config.py` para adicionar seu idioma (code, name, flag, english_name).
2. Copie `en.json` como modelo em `src/ui/app/static/locales/`, renomeie-o para o código do seu idioma (por exemplo, `de.json` para alemão).
3. Traduza os valores no seu novo arquivo.
4. Atualize a tabela em `locales/README.md` para adicionar seu idioma e indicar quem o criou/revisou.
5. Envie um pull request.

Para atualizações, edite o arquivo relevante e atualize a tabela de proveniência conforme necessário.

Consulte o [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/src/ui/app/static/locales/README.md) para obter as diretrizes completas.

# Suporte

## Profissional

Obtenha suporte técnico diretamente dos mantenedores do BunkerWeb. Você encontrará mais informações visitando o [BunkerWeb Panel](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=github), nossa plataforma dedicada a serviços profissionais.

Não hesite em [entrar em contato conosco](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=github) se tiver alguma dúvida; ficaremos mais do que felizes em atender às suas necessidades.

## Comunidade

Para obter suporte gratuito da comunidade, você pode usar os seguintes canais:

- O canal #help do BunkerWeb no [servidor Discord](https://discord.com/invite/fTf46FmtyD)
- A categoria de ajuda do [GitHub Discussions](https://github.com/bunkerity/bunkerweb/discussions)
- O subreddit [/r/BunkerWeb](https://www.reddit.com/r/BunkerWeb)
- Os fóruns [Server Fault](https://serverfault.com/) e [Super User](https://superuser.com/)

Por favor, não use [GitHub issues](https://github.com/bunkerity/bunkerweb/issues) para pedir ajuda; use-o apenas para relatos de bugs e solicitações de recursos.

# Licença

Este projeto está licenciado sob os termos da [GNU Affero General Public License (AGPL) versão 3](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/LICENSE.md).

# Contribua

Se você quiser contribuir com os plugins, pode ler as [diretrizes de contribuição](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/CONTRIBUTING.md) para começar.

# Política de segurança

Levamos bugs de segurança a sério e incentivamos a divulgação responsável; consulte nossa [política de segurança](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/SECURITY.md) para obter mais informações.

<!-- Gráfico de Star History oculto: o GitHub restringiu a API de stargazers, então o gráfico exibe um
     aviso de erro em vez de dados. Descomente quando o upstream voltar a servir gráficos reais.

# 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" />
   Gráfico de Star History
 </picture>
</a>
-->