## マルチサイトモード

マルチサイトモードは、BunkerWebを使用する際に理解すべき重要な概念です。目標はWebアプリケーションを保護することであるため、単一（またはクラスター）のインスタンスから複数のWebアプリケーションを提供できるようにする「仮想ホスト」または「vhost」の概念（詳細は[こちら](https://en.wikipedia.org/wiki/Virtual_hosting)）を本質的に継承しています。

デフォルトでは、BunkerWebのマルチサイトモードは無効になっており、1つのWebアプリケーションのみが提供され、すべての設定がそのアプリケーションに適用されることを意味します。典型的なユースケースは、保護するアプリケーションが1つだけの場合です。マルチサイトを心配する必要はなく、デフォルトの動作が最適であるはずです。

マルチサイトモードが有効な場合、BunkerWebは複数のWebアプリケーションを提供し保護します。各Webアプリケーションは一意のサーバー名で識別され、独自の設定セットを持ちます。典型的なユースケースは、保護するアプリケーションが複数あり、BunkerWebの単一（または統合によってはクラスター）のインスタンスを使用したい場合です。

## カスタム設定

設定のみですべてのユースケースに対応することは（[外部プラグイン](https://docs.bunkerweb.io/1.6.14/plugins/?utm_campaign=self&utm_source=github)を使用しても）不可能なため、特定の課題を解決するためにカスタム設定を使用できます。

内部では、BunkerWebは有名なNGINX Webサーバーを使用しているため、特定のニーズに合わせてその設定システムを活用できます。カスタムNGINX設定は、HTTPやserver（全サーバーおよび/または特定のサーバーブロック）などのさまざまな[コンテキスト](https://docs.nginx.com/nginx/admin-guide/basic-functionality/managing-configuration-files/#contexts)に含めることができます。

BunkerWebのもう1つの中核コンポーネントは、ModSecurity Webアプリケーションファイアウォールです。例えば、いくつかの誤検知を修正したり、カスタムルールを追加したりするために、カスタム設定を使用することもできます。

## データベース

<p align="center">
	<img alt="データベースモデル" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/bunkerweb_db.svg" />
</p>

BunkerWebの現在の設定状態は、以下のデータを含むバックエンドデータベースに保存されます：

- すべてのサービスに対して定義された設定
- カスタム設定
- BunkerWebインスタンス
- ジョブ実行に関するメタデータ
- キャッシュされたファイル

以下のバックエンドデータベースがサポートされています：SQLite、MariaDB、MySQL、PostgreSQL。

## スケジューラー

物事が魔法のように自動的に連携して動作するように、スケジューラーと呼ばれる専用サービスが以下を担当します：

- 設定とカスタム設定をデータベース内に保存すること
- さまざまなタスク（ジョブと呼ばれる）を実行すること
- BunkerWebが理解できる設定を生成すること
- 他のサービス（Web UIやautoconfなど）の仲介役となること

言い換えれば、スケジューラーはBunkerWebの頭脳です。

# セットアップ

<!--## BunkerWeb Cloud

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

BunkerWeb CloudはBunkerWebを始める最も簡単な方法です。手間のかからないフルマネージドのBunkerWebサービスを提供します。BunkerWeb-as-a-Serviceのようなものだと考えてください！

BunkerWeb Cloudベータの詳細は[こちら](https://www.bunkerweb.io/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バナー" 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バナー" 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を設定するための**環境変数**
- 設定を保存してジョブを実行する**スケジューラー**コンテナ
- クライアントにポートを公開し、アップストリームのWebサービスに接続するための**ネットワーク**

詳細は、ドキュメントの[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バナー" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-autoconf.svg" />
</p>

環境変数を使用する欠点は、更新のたびにコンテナを再作成する必要があり、あまり便利ではないことです。この問題に対処するために、**autoconf**と呼ばれる別のイメージを使用できます。これはDockerイベントを監視し、コンテナを再作成することなくBunkerWebをリアルタイムで自動的に再設定します。

BunkerWebコンテナに環境変数を定義する代わりに、Webアプリケーションのコンテナに**ラベル**を追加するだけで、**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バナー" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-kubernetes.svg" />
</p>

autoconfは[Ingressコントローラー](https://kubernetes.io/docs/concepts/services-networking/ingress-controllers/)として機能し、[Ingressリソース](https://kubernetes.io/docs/concepts/services-networking/ingress/)に従ってBunkerWebインスタンスを設定します。また、カスタム設定用の[ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/)などの他のKubernetesオブジェクトも監視します。

BunkerWebの公式[Helmチャート](https://helm.sh/)は、[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バナー" 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バナー" 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)と同様に、Webサービスの設定は、特別な**bunkerweb.**プレフィックスで始まるラベルを使用して定義されます。

詳細は、ドキュメントの[Swarmセクション](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#swarm)をご覧ください。

# クイックスタートガイド

お好みの統合でBunkerWebをセットアップしたら、Webサービスを保護するためのインストールと最初の設定を説明する[クイックスタートガイド](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)で設定できる多くのセキュリティ機能を提供します。設定のデフォルト値が最小限の「デフォルトで安全（security by default）」を保証していますが、それらをチューニングすることを強くお勧めします。そうすることで、選択したセキュリティレベルを確保できるだけでなく、誤検知も管理できます。

詳細は、ドキュメントの[セキュリティチューニングセクション](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`のようにします。

設定が「複数（multiple）」と見なされる場合、同じ機能に対して複数の設定グループを持つことができ、サフィックスとして数字を追加します。例：`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)を確認してください。

# Web UI

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

「Web UI」は、コマンドラインインターフェースの代わりにユーザーフレンドリーなインターフェースを使用してBunkerWebインスタンスを管理するのに役立つWebアプリケーションです。

Web UIが提供する機能のリストは次のとおりです：

- ブロックされた攻撃の包括的なビューを取得
- BunkerWebインスタンスの開始、停止、再起動、およびリロード
- Webアプリケーションの設定の追加、編集、削除
- NGINXおよびModSecurityのカスタム設定の追加、編集、削除
- 外部プラグインのインストールとアンインストール
- キャッシュされたファイルの探索
- ジョブ実行の監視と必要に応じた再起動
- ログの表示とパターンの検索

詳細は、ドキュメントの[Web UIセクション](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   | Coraza WAF（ModSecurityの代替）を使用してリクエストを検査します。                                                              |     [bunkerweb-plugins/coraza](https://github.com/bunkerity/bunkerweb-plugins/tree/main/coraza)     |
|  **Discord**   |   1.9   | Webhookを使用してセキュリティ通知をDiscordチャンネルに送信します。                                                                |    [bunkerweb-plugins/discord](https://github.com/bunkerity/bunkerweb-plugins/tree/main/discord)    |
|   **Slack**    |   1.9   | Webhookを使用してセキュリティ通知をSlackチャンネルに送信します。                                                                  |      [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   | Webhookを使用してカスタムHTTPエンドポイントにセキュリティ通知を送信します。                                                           |    [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 UIは複数の言語をサポートしています。翻訳は`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. プルリクエストを送信します。

更新の場合は、関連するファイルを編集し、必要に応じて出典テーブルを更新してください。

完全なガイドラインについては、[locales/README.md](https://github.com/bunkerity/bunkerweb/raw/v1.6.14/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)ください。お客様のニーズに喜んでお応えします。

## コミュニティ

無料のコミュニティサポートを受けるには、以下のメディアを利用できます：

- [Discordサーバー](https://discord.com/invite/fTf46FmtyD)のBunkerWeb #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.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)をご覧ください。

<!-- スターヒストリーのチャートは非表示：GitHubがスターゲイザーAPIを制限したため、チャートはデータの代わりにエラー通知を表示します。
     アップストリームが再び実際のチャートを提供するようになったらコメントを解除してください。

# スターヒストリー

<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" />
   スターヒストリーチャート
 </picture>
</a>
-->