## Modalità multisito

La modalità multisito è un concetto cruciale da comprendere quando si utilizza BunkerWeb. Poiché l'obiettivo è proteggere applicazioni web, ereditiamo intrinsecamente il concetto di "host virtuale" o "vhost" (maggiori informazioni [qui](https://en.wikipedia.org/wiki/Virtual_hosting)) che rende possibile servire più applicazioni web da una singola istanza (o da un cluster di istanze).

Per impostazione predefinita, la modalità multisito di BunkerWeb è disabilitata, il che significa che verrà servita una sola applicazione web e tutte le impostazioni verranno applicate ad essa. Il caso d'uso tipico è quando si ha una singola applicazione da proteggere: non devi preoccuparti del multisito e il comportamento predefinito dovrebbe essere quello giusto per te.

Quando la modalità multisito è abilitata, BunkerWeb servirà e proteggerà più applicazioni web. Ogni applicazione web è identificata da un nome server univoco e dispone di un proprio set di impostazioni. Il caso d'uso tipico è quando si hanno più applicazioni da proteggere e si desidera utilizzare una singola istanza (o un cluster a seconda dell'integrazione) di BunkerWeb.

## Configurazioni personalizzate

Poiché soddisfare tutti i casi d'uso utilizzando solo le impostazioni non è un'opzione (nemmeno con [plugin esterni](https://docs.bunkerweb.io/1.6.13/plugins/?utm_campaign=self&utm_source=github)), puoi utilizzare configurazioni personalizzate per risolvere le tue sfide specifiche.

Sotto il cofano, BunkerWeb utilizza il famoso server web NGINX, ecco perché puoi sfruttare il suo sistema di configurazione per le tue esigenze specifiche. Le configurazioni NGINX personalizzate possono essere incluse in diversi [contesti](https://docs.nginx.com/nginx/admin-guide/basic-functionality/managing-configuration-files/#contexts) come HTTP o server (tutti i server e/o blocco server specifico).

Un altro componente fondamentale di BunkerWeb è il Web Application Firewall ModSecurity: puoi anche utilizzare configurazioni personalizzate per correggere alcuni falsi positivi o aggiungere regole personalizzate, per esempio.

## Database

<p align="center">
	<img alt="Modello del database" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.13/docs/assets/img/bunkerweb_db.svg" />
</p>

Lo stato della configurazione corrente di BunkerWeb è memorizzato in un database backend che contiene i seguenti dati:

- Impostazioni definite per tutti i servizi
- Configurazioni personalizzate
- Istanze di BunkerWeb
- Metadati sull'esecuzione dei job
- File memorizzati nella cache

I seguenti database backend sono supportati: SQLite, MariaDB, MySQL e PostgreSQL.

## Scheduler

Per far funzionare le cose in modo automatico, un servizio dedicato chiamato scheduler è responsabile di:

- Memorizzare le impostazioni e le configurazioni personalizzate nel database
- Eseguire varie attività (chiamate job)
- Generare una configurazione comprensibile da BunkerWeb
- Essere l'intermediario per altri servizi (come l'interfaccia web o autoconf)

In altre parole, lo scheduler è il cervello di BunkerWeb.

# Configurazione

<!--## BunkerWeb Cloud

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

BunkerWeb Cloud è il modo più semplice per iniziare con BunkerWeb. Ti offre un servizio BunkerWeb completamente gestito senza problemi. Pensalo come un BunkerWeb-as-a-Service!

Troverai maggiori informazioni sulla beta di BunkerWeb Cloud [qui](https://www.bunkerweb.io/cloud?utm_campaign=self&utm_source=docs) e puoi fare domanda gratuitamente [nel pannello BunkerWeb](https://panel.bunkerweb.io/store/bunkerweb-cloud?utm_campaign=self&utm_source=docs).
-->
## Linux

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

Elenco delle distribuzioni Linux supportate:

- 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

Troverai maggiori informazioni nella [sezione Linux](https://docs.bunkerweb.io/1.5.10/integrations/?utm_campaign=self&utm_source=github#linux) della documentazione.

## Docker

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

Forniamo immagini predefinite pronte all'uso per piattaforme x64, x86, armv7 e arm64 su [Docker Hub](https://hub.docker.com/u/bunkerity).

I concetti chiave dell'integrazione Docker sono:

- **Variabili d'ambiente** per configurare BunkerWeb
- **Contenitore scheduler** per memorizzare la configurazione ed eseguire i job
- **Reti** per esporre le porte per i client e connettersi ai servizi web upstream

Troverai maggiori informazioni nella [sezione integrazione Docker](https://docs.bunkerweb.io/1.6.13/integrations/?utm_campaign=self&utm_source=github#docker) della documentazione.

## Docker autoconf

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

Lo svantaggio dell'utilizzo delle variabili d'ambiente è che il contenitore deve essere ricreato ogni volta che c'è un aggiornamento, il che non è molto comodo. Per ovviare a questo problema, puoi utilizzare un'altra immagine chiamata **autoconf** che rimane in ascolto degli eventi Docker e riconfigura automaticamente BunkerWeb in tempo reale senza ricreare il contenitore.

Invece di definire variabili d'ambiente per il contenitore BunkerWeb, ti basta aggiungere **etichette** ai contenitori delle tue applicazioni web e **autoconf** si occuperà "automaticamente" del resto.

Troverai maggiori informazioni nella [sezione Docker autoconf](https://docs.bunkerweb.io/1.6.13/integrations/?utm_campaign=self&utm_source=github#docker-autoconf) della documentazione.

## Kubernetes

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

L'autoconf funge da [Ingress controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) e configurerà le istanze di BunkerWeb in base alle [risorse Ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/). Monitora anche altri oggetti Kubernetes come [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/) per configurazioni personalizzate.

Il [chart Helm](https://helm.sh/) ufficiale per BunkerWeb è disponibile nel repository [bunkerity/bunkerweb-helm](https://github.com/bunkerity/bunkerweb-helm).

Troverai maggiori informazioni nella [sezione Kubernetes](https://docs.bunkerweb.io/1.6.13/integrations/?utm_campaign=self&utm_source=github#kubernetes) della documentazione.

## Microsoft Azure

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

BunkerWeb è referenziato nel [Azure Marketplace](https://azuremarketplace.microsoft.com/fr-fr/marketplace/apps/bunkerity.bunkerweb?tab=Overview) e un modello ARM è disponibile nella [cartella misc](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/misc/integrations/azure-arm-template.json).

Troverai maggiori informazioni nella [sezione Microsoft Azure](https://docs.bunkerweb.io/1.6.13/integrations/?utm_campaign=self&utm_source=github#microsoft-azure) della documentazione.

## Swarm

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

Per configurare automaticamente le istanze di BunkerWeb, un servizio speciale chiamato **autoconf** rimane in ascolto degli eventi Docker Swarm come la creazione o l'eliminazione di servizi e configura automaticamente le **istanze BunkerWeb** in tempo reale senza tempi di inattività.

Come per l'[integrazione Docker autoconf](https://docs.bunkerweb.io/1.6.13/integrations/?utm_campaign=self&utm_source=github#docker-autoconf), la configurazione per i servizi web è definita utilizzando etichette che iniziano con il prefisso speciale **bunkerweb.**.

Troverai maggiori informazioni nella [sezione Swarm](https://docs.bunkerweb.io/1.6.13/integrations/?utm_campaign=self&utm_source=github#swarm) della documentazione.

# Guida rapida

Una volta configurato BunkerWeb con l'integrazione di tua scelta, puoi seguire la [guida rapida](https://docs.bunkerweb.io/1.6.13/quickstart-guide/?utm_campaign=self&utm_source=github) che copre l'installazione e la prima configurazione per proteggere un servizio web.

# Ottimizzazione della sicurezza

BunkerWeb offre molte funzionalità di sicurezza che puoi configurare con le [funzionalità](https://docs.bunkerweb.io/1.6.13/features/?utm_campaign=self&utm_source=github). Anche se i valori predefiniti delle impostazioni garantiscono una "sicurezza di default" minima, ti raccomandiamo vivamente di ottimizzarli. In questo modo, potrai garantire un livello di sicurezza a tua scelta, ma anche gestire i falsi positivi.

Troverai maggiori informazioni nella [sezione di ottimizzazione della sicurezza](https://docs.bunkerweb.io/1.6.13/advanced/?utm_campaign=self&utm_source=github#security-tuning) della documentazione.

# Impostazioni

Come regola generale, quando la modalità multisito è abilitata, se desideri applicare impostazioni con contesto multisito a un server specifico, dovrai aggiungere il nome del server primario (il primo) come prefisso, ad esempio `www.example.com_USE_ANTIBOT=captcha` o `myapp.example.com_USE_GZIP=yes`.

Quando le impostazioni sono considerate "multiple", significa che puoi avere più gruppi di impostazioni per la stessa funzionalità aggiungendo numeri come suffissi, ad esempio `REVERSE_PROXY_URL_1=/sottodir`, `REVERSE_PROXY_HOST_1=http://myhost1`, `REVERSE_PROXY_URL_2=/altradir`, `REVERSE_PROXY_HOST_2=http://myhost2`, ... per esempio.

Consulta la [sezione delle funzionalità](https://docs.bunkerweb.io/1.6.13/features/?utm_campaign=self&utm_source=github) della documentazione per l'elenco completo.

# Interfaccia web

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

L'"Interfaccia web" è un'applicazione web che ti aiuta a gestire la tua istanza BunkerWeb utilizzando un'interfaccia intuitiva invece della riga di comando.

Ecco l'elenco delle funzionalità offerte dall'interfaccia web:

- Visualizzare una panoramica completa degli attacchi bloccati
- Avviare, fermare, riavviare e ricaricare la tua istanza BunkerWeb
- Aggiungere, modificare ed eliminare impostazioni per le tue applicazioni web
- Aggiungere, modificare ed eliminare configurazioni personalizzate per NGINX e ModSecurity
- Installare e disinstallare plugin esterni
- Esplorare i file memorizzati nella cache
- Monitorare l'esecuzione dei job e riavviarli quando necessario
- Visualizzare i log e cercare pattern

Troverai maggiori informazioni nella [sezione Interfaccia web](https://docs.bunkerweb.io/1.6.13/web-ui/?utm_campaign=self&utm_source=github) della documentazione.

# Plugin

BunkerWeb include un sistema di plugin per permettere di aggiungere facilmente nuove funzionalità. Una volta installato un plugin, puoi gestirlo utilizzando le impostazioni aggiuntive definite dal plugin.

Ecco l'elenco dei plugin "ufficiali" che manteniamo (vedi il repository [bunkerweb-plugins](https://github.com/bunkerity/bunkerweb-plugins/?utm_campaign=self&utm_source=github) per maggiori informazioni):

|      Nome      | Versione | Descrizione                                                                                                                      |                                                Link                                                |
| :------------: | :------: | :------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------: |
|   **ClamAV**   |   1.9    | Scansiona automaticamente i file caricati con il motore antivirus ClamAV e nega la richiesta quando un file viene rilevato come dannoso. |     [bunkerweb-plugins/clamav](https://github.com/bunkerity/bunkerweb-plugins/tree/main/clamav)     |
|   **Coraza**   |   1.9    | Ispeziona le richieste utilizzando il WAF Coraza (alternativa a ModSecurity).                                                              |     [bunkerweb-plugins/coraza](https://github.com/bunkerity/bunkerweb-plugins/tree/main/coraza)     |
|  **Discord**   |   1.9    | Invia notifiche di sicurezza a un canale Discord utilizzando un Webhook.                                                                |    [bunkerweb-plugins/discord](https://github.com/bunkerity/bunkerweb-plugins/tree/main/discord)    |
|   **Slack**    |   1.9    | Invia notifiche di sicurezza a un canale Slack utilizzando un Webhook.                                                                  |      [bunkerweb-plugins/slack](https://github.com/bunkerity/bunkerweb-plugins/tree/main/slack)      |
| **VirusTotal** |   1.9    | Scansiona automaticamente i file caricati con l'API VirusTotal e nega la richiesta quando un file viene rilevato come dannoso.          | [bunkerweb-plugins/virustotal](https://github.com/bunkerity/bunkerweb-plugins/tree/main/virustotal) |
|  **WebHook**   |   1.9    | Invia notifiche di sicurezza a un endpoint HTTP personalizzato utilizzando un Webhook.                                                           |    [bunkerweb-plugins/webhook](https://github.com/bunkerity/bunkerweb-plugins/tree/main/webhook)    |

Troverai maggiori informazioni nella [sezione plugin](https://docs.bunkerweb.io/1.6.13/plugins/?utm_campaign=self&utm_source=github) della documentazione.

# Supporto linguistico e localizzazione

L'interfaccia di BunkerWeb supporta più lingue. Le traduzioni sono gestite nella directory `src/ui/app/static/locales`. Le seguenti lingue sono attualmente disponibili:

- Arabo (ar)
- Bengalese (bn)
- Portoghese brasiliano (br)
- Tedesco (de)
- Inglese (en)
- Spagnolo (es)
- Francese (fr)
- Hindi (hi)
- Italiano (it)
- Coreano (ko)
- Polacco (pl)
- Portoghese (pt)
- Russo (ru)
- Turco (tr)
- Cinese tradizionale (tw)
- Urdu (ur)
- Cinese semplificato (zh)

Vedi [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/src/ui/app/static/locales/README.md) per i dettagli sulla provenienza e lo stato di revisione delle traduzioni.

## Contribuire alle traduzioni

Accogliamo con favore i contributi per migliorare o aggiungere nuovi file di traduzione!

**Come contribuire con una traduzione:**

1. Modifica il file `src/ui/app/lang_config.py` per aggiungere la tua lingua (codice, nome, bandiera, nome in inglese).
2. Copia `en.json` come modello in `src/ui/app/static/locales/`, rinominalo con il codice della tua lingua (es. `de.json` per il tedesco).
3. Traduci i valori nel tuo nuovo file.
4. Aggiorna la tabella in `locales/README.md` per aggiungere la tua lingua e indicare chi l'ha creata/revisionata.
5. Invia una pull request.

Per gli aggiornamenti, modifica il file pertinente e aggiorna la tabella di provenienza secondo necessità.

Vedi [locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/src/ui/app/static/locales/README.md) per le linee guida complete.

# Supporto

## Professionale

Ottieni supporto tecnico direttamente dai manutentori di BunkerWeb. Troverai maggiori informazioni visitando il [Pannello BunkerWeb](https://panel.bunkerweb.io/?utm_campaign=self&utm_source=github), la nostra piattaforma dedicata ai servizi professionali.

Non esitare a [contattarci](https://panel.bunkerweb.io/contact.php?utm_campaign=self&utm_source=github) se hai domande; saremo più che felici di rispondere alle tue esigenze.

## Community

Per ottenere supporto gratuito dalla community, puoi utilizzare i seguenti canali:

- Il canale #help di BunkerWeb nel [server Discord](https://discord.com/invite/fTf46FmtyD)
- La categoria help delle [discussioni GitHub](https://github.com/bunkerity/bunkerweb/discussions)
- Il subreddit [/r/BunkerWeb](https://www.reddit.com/r/BunkerWeb)
- I forum [Server Fault](https://serverfault.com/) e [Super User](https://superuser.com/)

Per favore, non utilizzare [GitHub issues](https://github.com/bunkerity/bunkerweb/issues) per chiedere aiuto; usalo solo per segnalazioni di bug e richieste di funzionalità.

# Licenza

Questo progetto è concesso in licenza secondo i termini della [GNU Affero General Public License (AGPL) versione 3](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/LICENSE.md).

# Contribuisci

Se desideri contribuire ai plugin, puoi leggere le [linee guida per i contributi](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/CONTRIBUTING.md) per iniziare.

# Politica di sicurezza

Prendiamo seriamente i bug di sicurezza e incoraggiamo la divulgazione responsabile; consulta la nostra [politica di sicurezza](https://github.com/bunkerity/bunkerweb/raw/v1.6.13/SECURITY.md) per maggiori informazioni.

# Cronologia delle stelle

<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" />
   <img alt="Grafico della cronologia delle stelle" src="https://assets.kitploit.com/production/public/readmes/placeholders/f0fc86cfe65f76d40e15aaec61704ec8220a56dc89d4be03c46f67cb31b9fa8c.svg" />
 </picture>
</a>