## 멀티사이트 모드

멀티사이트 모드는 BunkerWeb을 사용할 때 반드시 이해해야 하는 핵심 개념입니다. 웹 애플리케이션을 보호하는 것이 목표이기 때문에, 단일(또는 클러스터) 인스턴스에서 여러 웹 애플리케이션을 서비스할 수 있게 해주는 "가상 호스트"(virtual host) 또는 "vhost" 개념을 본질적으로 상속받습니다(자세한 정보는 [여기](https://en.wikipedia.org/wiki/Virtual_hosting) 참조).

기본적으로 BunkerWeb의 멀티사이트 모드는 비활성화되어 있으며, 이는 하나의 웹 애플리케이션만 서비스되고 모든 설정이 해당 애플리케이션에 적용된다는 의미입니다. 전형적인 사용 사례는 보호할 단일 애플리케이션이 있는 경우입니다. 멀티사이트에 대해 걱정할 필요가 없으며 기본 동작이 적합할 것입니다.

멀티사이트 모드가 활성화되면 BunkerWeb은 여러 웹 애플리케이션을 서비스하고 보호합니다. 각 웹 애플리케이션은 고유한 서버 이름으로 식별되며 자체 설정 세트를 보유합니다. 전형적인 사용 사례는 보호할 여러 애플리케이션이 있고 단일(또는 통합 방식에 따라 클러스터) BunkerWeb 인스턴스를 사용하려는 경우입니다.

## 사용자 정의 구성

설정만으로 모든 사용 사례를 충족하는 것은 불가능하기 때문에([외부 플러그인](https://docs.bunkerweb.io/1.6.14/plugins/?utm_campaign=self&utm_source=github)을 사용하더라도), 특정 문제를 해결하기 위해 사용자 정의 구성을 사용할 수 있습니다.

내부적으로 BunkerWeb은 유명한 NGINX 웹 서버를 사용하므로 특정 요구 사항에 맞게 NGINX의 구성 시스템을 활용할 수 있습니다. 사용자 정의 NGINX 구성은 HTTP 또는 server와 같은 다양한 [컨텍스트](https://docs.nginx.com/nginx/admin-guide/basic-functionality/managing-configuration-files/#contexts)(모든 서버 및/또는 특정 서버 블록)에 포함될 수 있습니다.

BunkerWeb의 또 다른 핵심 구성 요소는 ModSecurity 웹 애플리케이션 방화벽(WAF)입니다. 예를 들어 일부 오탐(false positives)을 수정하거나 사용자 정의 규칙을 추가하기 위해 사용자 정의 구성을 사용할 수도 있습니다.

## 데이터베이스

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

BunkerWeb의 현재 구성 상태는 다음 데이터가 포함된 백엔드 데이터베이스에 저장됩니다:

- 모든 서비스에 대해 정의된 설정
- 사용자 정의 구성
- BunkerWeb 인스턴스
- 작업 실행에 대한 메타데이터
- 캐시된 파일

지원되는 백엔드 데이터베이스는 SQLite, MariaDB, MySQL 및 PostgreSQL입니다.

## 스케줄러

모든 것이 자동으로 함께 작동하도록 하기 위해 스케줄러라는 전용 서비스가 다음을 담당합니다:

- 데이터베이스에 설정 및 사용자 정의 구성 저장
- 다양한 작업(잡(job)이라고 함) 실행
- BunkerWeb이 이해할 수 있는 구성 생성
- 다른 서비스(예: 웹 UI 또는 autoconf)의 중개자 역할

즉, 스케줄러는 BunkerWeb의 두뇌입니다.

# 설치

<!--## 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 is the easiest way to get started with BunkerWeb. It offers you a fully managed BunkerWeb service with no hassle. Think of it like a BunkerWeb-as-a-Service!

You will find more information about BunkerWeb Cloud beta [here](https://www.bunkerweb.io/cloud?utm_campaign=self&utm_source=docs) and you can apply for free [in the BunkerWeb panel](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>

지원되는 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 banner" 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을 구성하기 위한 **환경 변수**
- 구성을 저장하고 작업을 실행하는 **스케줄러** 컨테이너
- 클라이언트에게 포트를 노출하고 업스트림 웹 서비스에 연결하기 위한 **네트워크**

문서의 [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 banner" src="https://raw.githubusercontent.com/bunkerity/bunkerweb/v1.6.14/docs/assets/img/integration-autoconf.svg" />
</p>

환경 변수 사용의 단점은 업데이트가 있을 때마다 컨테이너를 다시 생성해야 하므로 그리 편리하지 않다는 점입니다. 이 문제를 해결하기 위해 **autoconf**라는 다른 이미지를 사용할 수 있습니다. autoconf는 Docker 이벤트를 수신하고 컨테이너를 다시 생성하지 않고도 BunkerWeb을 실시간으로 자동 재구성합니다.

BunkerWeb 컨테이너에 환경 변수를 정의하는 대신, 웹 애플리케이션 컨테이너에 **라벨**을 추가하기만 하면 **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 banner" 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 banner" 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 banner" 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)과 마찬가지로, 웹 서비스 구성은 특수 **bunkerweb.** 접두사로 시작하는 라벨을 사용하여 정의됩니다.

문서의 [Swarm 섹션](https://docs.bunkerweb.io/1.6.14/integrations/?utm_campaign=self&utm_source=github#swarm)에서 자세한 정보를 확인할 수 있습니다.

# 빠른 시작 가이드

원하는 통합 방식으로 BunkerWeb을 설정한 후에는 [빠른 시작 가이드](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)을 보장하더라도, 이를 튜닝할 것을 강력히 권장합니다. 그렇게 하면 원하는 보안 수준을 보장할 수 있을 뿐만 아니라 오탐(false positives)도 관리할 수 있습니다.

문서의 [보안 튜닝 섹션](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 UI가 제공하는 기능 목록은 다음과 같습니다:

- 차단된 공격에 대한 종합적인 조회
- BunkerWeb 인스턴스 시작, 중지, 재시작 및 리로드
- 웹 애플리케이션 설정 추가, 편집 및 삭제
- 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. `src/ui/app/static/locales/`에서 `en.json`을 템플릿으로 복사하고 언어 코드로 이름을 변경합니다(예: 독일어의 경우 `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 discussions](https://github.com/bunkerity/bunkerweb/discussions)의 help 카테고리
- [/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)를 사용하지 마세요. GitHub 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)을 참조하세요.

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