## Modalità multisito

La modalità multisito è un concetto cruciale da comprendere quando si utilizza BunkerWeb. Poiché l'obiettivo è proteggere le applicazioni web, ereditiamo intrinsecamente il concetto di "virtual host" o "vhost" (ulteriori 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).

By default, 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 ha il proprio set di impostazioni. Il caso d'uso tipico è quando si hanno più applicazioni da proteggere e si desidera utilizzare una singola istanza di BunkerWeb (o un cluster, a seconda dell'integrazione).

## Configurazioni personalizzate

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

Sotto il cofano, BunkerWeb utilizza il noto 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 un blocco server specifico).

Un altro componente fondamentale di BunkerWeb è il firewall per applicazioni web ModSecurity: puoi anche utilizzare configurazioni personalizzate per correggere alcuni falsi positivi o aggiungere regole personalizzate, ad esempio.

## Database

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

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

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

Sono supportati i seguenti database backend: SQLite, MariaDB, MySQL e PostgreSQL.

## Scheduler

Per far funzionare le cose "automagicamente" insieme, un servizio dedicato chiamato scheduler è responsabile di:

- Archiviare le impostazioni e le configurazioni personalizzate nel database
- Eseguire vari compiti (chiamati job)
- Generare una configurazione comprensibile da BunkerWeb
- Essere l'intermediario per altri servizi (come web UI o autoconf)

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

# Setup

<!--## 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 è 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="Linux banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/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="Docker banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-docker.svg" />
</p>

Forniamo immagini precompilate pronte all'uso per le 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 archiviare la configurazione ed eseguire i job
- **Reti** per esporre le porte ai client e connettersi ai servizi web upstream

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

## 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>

Lo svantaggio dell'utilizzo delle variabili d'ambiente è che il container deve essere ricreato ogni volta che c'è un aggiornamento, il che non è molto comodo. Per contrastare questo problema, puoi utilizzare un'altra immagine chiamata **autoconf** che ascolterà gli eventi Docker e riconfigurerà automaticamente BunkerWeb in tempo reale senza ricreare il container.

Invece di definire variabili d'ambiente per il container BunkerWeb, devi semplicemente aggiungere **etichette** ai container delle tue applicazioni web e l'**autoconf** si occuperà "automagicamente" del resto.

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

## 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>

L'autoconf agisce come un [Ingress controller](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/) e configurerà le istanze BunkerWeb secondo le [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 le configurazioni personalizzate.

L'[Helm chart](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.14/integrations/?utm_campaign=self&utm_source=github#kubernetes) della documentazione.

## 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 è referenziato nell'[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.14/misc/integrations/azure-arm-template.json).

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

## 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>

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

Come per l'[integrazione Docker autoconf](https://docs.bunkerweb.io/1.6.14/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.14/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.14/quickstart-guide/?utm_campaign=self&utm_source=github) che coprirà 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.14/features/?utm_campaign=self&utm_source=github). Anche se i valori predefiniti delle impostazioni garantiscono una "sicurezza di default" minima, ti consigliamo vivamente di ottimizzarli. In questo modo potrai garantire un livello di sicurezza a tua scelta e gestire anche i falsi positivi.

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

# Impostazioni

Come regola generale, quando la modalità multisito è abilitata, se vuoi 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=/subdir`, `REVERSE_PROXY_HOST_1=http://myhost1`, `REVERSE_PROXY_URL_2=/anotherdir`, `REVERSE_PROXY_HOST_2=http://myhost2`, ...

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

# Web UI

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

La "Web UI" è un'applicazione web che ti aiuta a gestire la tua istanza BunkerWeb utilizzando un'interfaccia user-friendly invece di quella a riga di comando.

Ecco l'elenco delle funzionalità offerte dalla Web UI:

- Ottenere una visione 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 Web UI](https://docs.bunkerweb.io/1.6.14/web-ui/?utm_campaign=self&utm_source=github) della documentazione.

# Plugin

BunkerWeb viene fornito con un sistema di plugin che rende possibile 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.14/plugins/?utm_campaign=self&utm_source=github) della documentazione.

# Supporto linguistico e localizzazione

La UI 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.14/src/ui/app/static/locales/README.md) per i dettagli sulla provenienza delle traduzioni e sullo stato di revisione.

## Contribuire con le traduzioni

Accogliamo con piacere contributi per migliorare o aggiungere nuovi file di localizzazione!

**Come contribuire a una traduzione:**

1. Modifica il file `src/ui/app/lang_config.py` per aggiungere la tua lingua (codice, nome, bandiera, english_name).
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.14/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 [BunkerWeb Panel](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 le [GitHub issues](https://github.com/bunkerity/bunkerweb/issues) per chiedere aiuto; usale solo per segnalare bug e richiedere 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.14/LICENSE.md).

# Contribuisci

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

# Politica di sicurezza

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

<!-- Grafico Star History nascosto: GitHub ha limitato l'API degli stargazers, quindi il grafico mostra un avviso di errore
     invece dei dati. Rimuovi il commento quando upstream tornerà a servire grafici reali.

# 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>
-->