WAF防火墙导致File Browser无法上传文件问题

FileBrowser 是一个开源的轻量级网页文件管理器,它的核心价值在于:只需一个浏览器,就能像操作本地电脑一样,远程管理服务器、NAS或任何电脑上的文件。
当你成功部署后,上传下载、解压压缩、在线预览,甚至是与朋友分享文件,都只需要一个链接就能完成。GitHub地址:https://github.com/filebrowser/filebrowser

目前官方镜像新版本默认使用 UID/GID 1000 运行,不再使用 root 用户,因此部署时需要特别留意文件权限和挂载方式

这个报错是宝塔 WAF 拦截 + Nginx 缓冲区溢出,触发地址是 /api/tus/,这正是 FileBrowser 的TUS 断点续传上传接口。 FileBrowser 大文件上传使用 tus 协议,长 URL + 分块请求,被宝塔 WAF 判定为缓冲区溢出直接拦截,所以你上传文件失败,和前面 docker 容器内权限是两个独立问题。

方案 1(推荐,WAF 加 URL 白名单)

  1. 登录宝塔面板 → 网站 → 对应站点 → WAF
  2. 找到【URL 白名单】,添加这条正则:
^/api/tus/.*

含义:放行所有 /api/tus/ 开头的请求,也就是 FileBrowser 断点上传接口

  1. 保存,不用重启 nginx,重新上传测试。

注意:是 WAF 的 URL 白名单,不是网站的伪静态白名单。

WAF防火墙导致File Browser无法上传文件问题
WAF防火墙导致File Browser无法上传文件问题

方案 2(Nginx 调大 client 缓冲区,根治缓冲区溢出)

如果方案 1 还报错,需要修改 Nginx 的client_header_buffer_size和large_client_header_buffers

  1. 宝塔面板 → Nginx → 性能调整 找到这两项,修改:
client_header_buffer_size 128k;
large_client_header_buffers 4 128k;
  1. 保存配置,重载 Nginx

原理:tus 上传时 URL 很长,默认 header 缓冲区太小,Nginx 报缓冲区溢出。

方案 3(临时快速验证,适合测试)

临时关闭这个网站的 WAF,测试上传能不能成功。 ✅ 如果关闭 WAF 上传正常,就确认是 WAF 拦截,回到方案 1 添加白名单。 ⚠️ 不建议长期关闭 WAF,仅用于定位故障。

补充说明

  1. 这个报错不是 docker 容器内部权限问题,是宝塔 Nginx/WAF 在宿主机反向代理层面拦截了上传请求。
  2. FileBrowser 上传大文件依赖 /api/tus/ 断点续传接口,小文件不走这个接口,所以小文件可能正常,大文件上传直接报错。
  3. 如果你是宝塔反向代理到 docker 的 8282 端口,一定要在宝塔网站的 WAF 里加白名单。

额外排查点

  • 如果你设置了 Nginx 反向代理,确认代理配置里添加:
proxy_request_buffering off;
proxy_http_version 1.1;
proxy_set_header Connection "";

tus 断点续传需要 http1.1 支持。

你现在是宝塔反向代理访问 FileBrowser 对吧?需要我直接给你完整可用的 Nginx 反向代理配置段吗?

docker下部署File Browser:https://www.hao0564.com/5954.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注