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 Web UI 登录总是失败，并提示“CSRF token is missing or invalid”错误？

Accepted Answer

这种情况发生在多 worker 部署中（bw-ui 运行多个 gunicorn worker），且未设置共享的 `FLASK_SECRET` 时。每个 worker 使用各自的临时密钥对会话进行签名，因此加载登录页面时签发的 CSRF token 在处理 POST 请求的 worker 上无法通过验证——密码甚至根本不会被检查。修复方法：1) 生成一个稳定的密钥：`openssl rand -hex 32`。2) 在 `bw-ui` 容器中将其设置为 `FLASK_SECRET` 环境变量，例如在 docker-compose 中：`environment: - FLASK_SECRET=<generated-secret>`。3) 重启 bw-ui。登录会立即恢复正常。请确保所有 worker/实例共享完全相同的密钥值。

Question 3

如何修复 ModSecurity 误报（HTTP 403）阻止位于 BunkerWeb 后方的 Znuny 的 HTML 自动回复？

Accepted Answer

OWASP CRS 规则 941100（通过 libinjection 检测 XSS）和 941160（NoScript XSS InjectionChecker）会标记 `Response` 参数中由编辑器生成的 HTML，导致入站异常评分超过阈值，从而使规则 949110 返回 403。修复方法：在特定服务的 `modsec-crs` 自定义配置中添加一条范围精确限定的排除规则，该配置会在 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 自动回复更新（即向 /otrs/index.pl 发起的、Action=AdminAutoResponse 且 Subaction=ChangeAction 的 POST 请求），将 `ARGS:Response` 从规则 941100 和 941160 的检查中移除，其余 CRS 防护保持不变。应用该排除规则后，保存 HTML 自动回复即可成功。已在 BunkerWeb 1.6.15 搭配 OWASP CRS 4.29.0 的环境下验证确认。

Question 4

为什么在 BunkerWeb 中 nginx 配置测试失败，出现 'invalid number of arguments in client_body_timeout' 错误？

Accepted Answer

在BunkerWeb 1.6.9中，若未显式定义超时设置（如client_body_timeout），其可能默认为空值，导致nginx配置测试失败。临时解决方案：将对应环境变量设置为有效时长（例如'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

这似乎是 BunkerWeb 1.6.10~rc6 中的一个回归问题，当 Linux 安装程序自动配置 MariaDB 时会出现。安装程序摘要显示“Setup wizard: Enabled”，但 https://server-ip/setup 无法加载。解决方法：重新运行安装程序，并选择 “3. Skip (keep SQLite, or configure DATABASE_URI manually later)” 而不是 “1. MariaDB”。当摘要显示 “Database: SQLite” 时，完成安装并再次访问 https://server-ip/setup。在 rc6 中，设置向导可正常配合 SQLite 使用；在该 bug 修复之前，请避免使用自动安装的 MariaDB 选项。

bunkerweb

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐