Question 1

BunkerWeb에서 'No migration file found for database version: 1.6.11~rc1' 오류를 수정하는 방법?

Accepted Answer

오류는 버전 1.6.11~rc1이 업그레이드 대상으로 잘못 노출되어 발생합니다. 해결하려면 스케줄러를 중지하고 데이터베이스에서 버전을 업데이트한 후 다시 시작하십시오.

1. 스케줄러 중지:
   - Docker: `docker compose stop bw-scheduler`
   - Linux: `sudo systemctl stop bunkerweb-scheduler`
2. BunkerWeb 데이터베이스에 연결(Docker의 경우 `docker compose exec bw-db mysql -u bunkerweb -p bunkerweb`, sqlite3/mysql을 직접 사용 가능)한 후 다음을 실행하세요:
   ```sql
   UPDATE bw_metadata SET version = '1.6.11' WHERE id = 1;
   ```
3. 스케줄러를 다시 시작하세요:
   - Docker: `docker compose start bw-scheduler`
   - Linux: `sudo systemctl start bunkerweb-scheduler`

Question 2

BunkerWeb 웹 UI 로그인이 항상 'CSRF token is missing or invalid' 오류로 실패하는 이유는 무엇인가요?

Accepted Answer

이 문제는 공유된 `FLASK_SECRET`이 설정되지 않은 다중 워커 배포 환경(bw-ui가 여러 gunicorn 워커를 실행하는 경우)에서 발생합니다. 각 워커가 자체 임시 키로 세션을 서명하므로, 로그인 페이지 로딩 시 발급된 CSRF 토큰이 POST 요청을 처리하는 워커에서 검증에 실패하며, 비밀번호는 아예 확인되지도 않습니다. 해결 방법: 1) 안정적인 시크릿 생성: `openssl rand -hex 32`. 2) 이를 `bw-ui` 컨테이너의 `FLASK_SECRET` 환경 변수로 설정합니다. 예를 들어 docker-compose에서는 `environment: - FLASK_SECRET=<generated-secret>`와 같이 설정합니다. 3) bw-ui를 재시작합니다. 로그인이 즉시 작동합니다. 모든 워커/인스턴스가 동일한 시크릿 값을 공유하는지 확인하세요.

Question 3

BunkerWeb 뒤의 Znuny에서 HTML 자동 응답을 차단하는 ModSecurity 오탐지(HTTP 403)를 해결하는 방법

Accepted Answer

OWASP CRS 규칙 941100(libinjection을 통한 XSS)과 941160(NoScript XSS InjectionChecker)이 `Response` 매개변수에서 편집기가 생성한 HTML을 탐지하여 인바운드 이상 점수(anomaly score)가 임계값을 초과하게 되고, 이로 인해 규칙 949110이 403을 반환합니다. CRS 규칙보다 먼저 로드되는 서비스별 `modsec-crs` 사용자 지정 구성에 좁은 범위의 예외를 추가하여 이 문제를 해결하세요:

```
SecRule REQUEST_URI "@rx ^/otrs/index[.]pl(?:[?].*)?$" \
    "id:1002200,phase:2,pass,nolog,t:none,chain"
    SecRule REQUEST_METHOD "@streq POST" "t:none,chain"
        SecRule ARGS:Action "@streq AdminAutoResponse" "t:none,chain"
            SecRule ARGS:Subaction "@streq ChangeAction" \
                "t:none,ctl:ruleRemoveTargetById=941100;ARGS:Response,ctl:ruleRemoveTargetById=941160;ARGS:Response"
```

이렇게 하면 Znuny 자동 응답 업데이트(Action=AdminAutoResponse, Subaction=ChangeAction으로 /otrs/index.pl에 POST 요청)의 경우에만 규칙 941100과 941160의 검사 대상에서 `ARGS:Response`가 제외되며, 나머지 CRS 보호는 그대로 유지됩니다. 예외를 적용한 후에는 HTML 자동 응답 저장이 정상적으로 완료됩니다. BunkerWeb 1.6.15와 OWASP CRS 4.29.0에서 확인되었습니다.

Question 4

BunkerWeb에서 'client_body_timeout에 인수 개수가 잘못되었습니다' 오류로 nginx config test가 실패하는 이유는 무엇인가요?

Accepted Answer

BunkerWeb 1.6.9에서 client_body_timeout 같은 타임아웃 설정은 명시적으로 정의되지 않으면 기본값이 빈 값이 될 수 있으며, 이로 인해 nginx config test가 실패합니다. 해결 방법: 해당 환경 변수를 유효한 지속 시간(예: '60s')으로 설정하세요. Docker run 명령어나 서비스 정의에 `-e CLIENT_BODY_TIMEOUT=60s -e CLIENT_HEADER_TIMEOUT=60s -e KEEPALIVE_TIMEOUT=60s -e SEND_TIMEOUT=60s`를 추가하십시오. 이 버그는 issue #3450에서 추적되고 있으며 향후 릴리스에서 수정될 예정입니다.

Question 5

MariaDB를 사용하여 1.6.10-rc6을 클린 설치한 후 BunkerWeb 설정 마법사가 나타나지 않는 문제를 어떻게 해결하나요?

Accepted Answer

이는 Linux 설치 프로그램이 MariaDB를 자동으로 구성할 때 BunkerWeb 1.6.10~rc6에서 발생하는 회귀 문제로 보입니다. 설치 프로그램 요약에는 "Setup wizard: Enabled"로 표시되지만 `https://server-ip/setup`이 로드되지 않습니다. 해결 방법: 설치 프로그램을 다시 실행하고 `1. MariaDB` 대신 `3. Skip (keep SQLite, or configure DATABASE_URI manually later)`를 선택하세요. 요약에 `Database: SQLite`가 표시되면 설치를 완료하고 `https://server-ip/setup`에 다시 접속하세요. rc6에서는 설정 마법사가 SQLite에서 정상적으로 작동하므로, 버그가 수정될 때까지 자동 설치되는 MariaDB 옵션은 피하세요.

bunkerweb

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트