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 白名单)
- 登录宝塔面板 → 网站 → 对应站点 → WAF
- 找到【URL 白名单】,添加这条正则:
^/api/tus/.*
含义:放行所有
/api/tus/开头的请求,也就是 FileBrowser 断点上传接口
- 保存,不用重启 nginx,重新上传测试。
注意:是 WAF 的 URL 白名单,不是网站的伪静态白名单。

方案 2(Nginx 调大 client 缓冲区,根治缓冲区溢出)
如果方案 1 还报错,需要修改 Nginx 的client_header_buffer_size和large_client_header_buffers
- 宝塔面板 → Nginx → 性能调整 找到这两项,修改:
client_header_buffer_size 128k;
large_client_header_buffers 4 128k;
- 保存配置,重载 Nginx
原理:tus 上传时 URL 很长,默认 header 缓冲区太小,Nginx 报缓冲区溢出。
方案 3(临时快速验证,适合测试)
临时关闭这个网站的 WAF,测试上传能不能成功。 ✅ 如果关闭 WAF 上传正常,就确认是 WAF 拦截,回到方案 1 添加白名单。 ⚠️ 不建议长期关闭 WAF,仅用于定位故障。
补充说明
- 这个报错不是 docker 容器内部权限问题,是宝塔 Nginx/WAF 在宿主机反向代理层面拦截了上传请求。
- FileBrowser 上传大文件依赖
/api/tus/断点续传接口,小文件不走这个接口,所以小文件可能正常,大文件上传直接报错。 - 如果你是宝塔反向代理到 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
