当前位置： 首页 > news >正文

记一次 File Browser 上传失败排障：从 403 Forbidden 到权限修复

news 2026/5/7 9:54:48

问题现象

在 1Panel 中部署了 File Browser 文件管理器，并设置挂载目录为 ./data/mnt。无论是通过网页拖拽上传文件，还是使用 API 调用（带 Token），均返回 403 Forbidden 或 401 Unauthorized，但在登录和浏览目录时一切正常。

点击查看代码 
t: tus: unexpected response while creating upload, originated from request (method: POST, url: http://47.117.186.104:40071/api/tus/%E7%A8%8B%E5%BA%8F%E9%80%BB%E8%BE%91%E5…%E6%93%8E%E8%99%9A%E6%8B%9F%E6%9C%BA%E5%AE%9E%E7%8E%B0.docx?override=false, response code: 403, response text: 403 Forbidden
, request id: n/a)at t.value (index-B0tCXerS.js:4:8418)at index-B0tCXerS.js:4:10053
onError	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
setTimeout		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
setTimeout		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
setTimeout		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
setTimeout		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
setTimeout		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
Promise.then		
value	@	index-B0tCXerS.js:4
（匿名）	@	index-B0tCXerS.js:4
sh	@	index-B0tCXerS.js:4
Ch	@	index-B0tCXerS.js:4
await in Ch		
p	@	index-B0tCXerS.js:4
s	@	index-B0tCXerS.js:4
i	@	index-B0tCXerS.js:2
Av	@	index-B0tCXerS.js:4
i	@	index-B0tCXerS.js:4
index-B0tCXerS.js:4 POST http://47.117.186.104:40071/api/resources/test/?override=false 403 (Forbidden)
（匿名）	@	index-B0tCXerS.js:4
wh	@	index-B0tCXerS.js:4
Ch	@	index-B0tCXerS.js:4
d	@	index-B0tCXerS.js:4
（匿名）	@	i18n-DAsyoe9Q.js:4
zn	@	i18n-DAsyoe9Q.js:2
Bn	@	i18n-DAsyoe9Q.js:2
n	@	i18n-DAsyoe9Q.js:4
index-B0tCXerS.js:4 Starting conflict check, 1 possible conflict found.
index-B0tCXerS.js:4 0 conflicts found.
content_main.js:4529 Uncaught (in promise) fetchError: Failed to fetchat JS (content_main.js:4529:11258)at e.sendFrom (content_main.js:4529:2189)at async ry.sendWithHealth (content_main.js:4529:16104)at async kK (content_main.js:4529:21795)at async xe (content_main.js:4529:19832)
JS	@	content_main.js:4529
sendFrom	@	content_main.js:4529
await in sendFrom		
sendMessage	@	content_main.js:4529
（匿名）	@	content_main.js:4529
sendWithHealth	@	content_main.js:4529
kK	@	content_main.js:4529
xe	@	content_main.js:4529
await in xe		
Ne	@	content_main.js:4529
Vp	@	content_main.js:4529
（匿名）	@	content_main.js:4529
Promise.then		
oE	@	content_main.js:4529
hl	@	content_main.js:4529
（匿名）	@	content_main.js:4529
setTimeout		
（匿名）	@	content_main.js:4529
Promise.then		
oE	@	content_main.js:4529
hl	@	content_main.js:4529
WK	@	content_main.js:4529
await in WK		
wy	@	content_main.js:4529
await in wy		
de	@	content_main.js:4529
（匿名）	@	content_main.js:8260
x2	@	content_main.js:4515
Xe.__r	@	content_main.js:4515
y2	@	content_main.js:4515
（匿名）	@	content_main.js:4515
$m	@	content_main.js:4515
setTimeout		
h2	@	content_main.js:4515
w0.setState	@	content_main.js:4515
ZG.r.__c.r.__	@	content_main.js:4515
（匿名）	@	content_main.js:8260
setTimeout		
（匿名）	@	content_main.js:8260
F	@	content_main.js:8260

排查过程

1. 初看是认证问题

一开始测试 API 时 /api/login 能正常返回 Token，但携带 Token 请求任何需要认证的资源（如列出目录、上传文件）均返回 401。使用 curl 测试同样 401，怀疑是反向代理或配置丢弃了 Authorization 头。
尝试改用 Cookie 认证也无果。

2. 观察浏览器错误

发现网页上传时浏览器控制台报错：

POST /api/tus/... 403 (Forbidden)

同时，尝试创建文件夹也返回 403。说明问题并非认证头丢失，而是服务器直接拒绝了所有写入操作。

3. 检查日志，找到根因

查看 File Browser 容器日志，出现如下关键信息：

open /srv/程序逻辑可配功能方案.docx: permission denied
mkdir /srv/test: permission denied

问题确认：容器内运行用户对挂载目录 /srv 没有写入权限。

查看 docker-compose 挂载配置：

volumes:- ${MOUNT_PATH}:/srv

环境中 MOUNT_PATH 设定为 ./data/mnt。该宿主机目录的所有者与容器内运行用户（UID=1000）不一致，导致权限拒绝。

解决方案

通过 1Panel 的文件管理器修改宿主机目录权限：
image

  1. 定位宿主机绝对路径
    通常 1Panel 将应用数据放在 /opt/1panel/apps/filebrowser/ 下，进入该目录找到 data/mnt。

  2. 修改权限

    • 右键 mnt 目录 → 修改权限
    • 设置所有者为 UID 1000，用户组 1000
    • 权限设为 755 (rwxr-xr-x)
    • 勾选“同时修改子目录权限”
    • 确认
      image

  3. 重启容器使配置生效
    在 1Panel 应用列表点击 File Browser 的「重启」按钮。

再次测试，文件上传、文件夹创建全部恢复正常。

技术总结

  • File Browser 新版默认开启 TUS 断点续传，上传走 /api/tus，但仍需底层文件写入权限。
  • 容器化部署时，务必保证挂载卷的权限与容器内运行用户匹配。1Panel 安装的 File Browser 内部运行用户为 nobody 或普通用户（UID 1000），若宿主机目录属于 root 且不可写，则必现 403。
  • 日志是最直接的突破口，docker logs 可以迅速定位 permission denied 而不是在 API 认证上绕圈子。

延伸思考

若后续遇到类似问题，可按以下顺序排查：

  1. 查看容器日志，确认具体错误类型。
  2. 检查挂载目录的权限和所有者。
  3. 检查 File Browser 内部规则（Rules）是否禁止写入。
  4. 若前端 TUS 报错但普通上传正常，可尝试添加 ?tus=false 参数或禁用服务端 TUS。

标签：File Browser / Docker / 1Panel / 权限排障 / 403 Forbidden
日期：2026-05-07

这篇博客完整记录了从现象到解决的思路，希望对你有帮助。可以直接复制到你的技术博客平台，如有需要调整的细节可自行修改。

http://www.jsqmd.com/news/769362/

相关文章：

  • 3个关键步骤掌握Blender VRM插件：从零开始创建专业虚拟角色
  • 汽车电子高边电流检测技术解析与实践
  • Gitee SCA：为企业级开源治理构筑自动化防线
  • 5分钟实现专业级AI背景移除：OBS背景移除插件完全指南
  • 【 LangChain 1.2 实战（四）】构建一个模块化的天气查询 Agent
  • 亲测油敏肌不刺激防晒霜推荐，清爽不泛红，无限空瓶的6款宝藏防晒 - 全网最美
  • 房车验车服务推荐哪家？ - 速递信息
  • ESP-IDF构建系统的机制
  • 中小药企批量采购包材难？斯坦德生物医药定制化方案：高效完成相容性研究与密封性验证，助力中小药企合规推进产品上市进程 - 速递信息
  • Rex-Omni 开始
  • ix6780,ip87800,mg3580,mg3680,mg3620,TS3380,TS3340,X6800,iB4180报错5B00,P07,E08，1700，5b04废墨垫清零,亲测有用。
  • ngx_http_init_connection
  • 2026年第二季度国内化工流量计厂家深度解析与选型指南 - 流量计品牌
  • 进口真空烘箱/智能烘箱哪个厂家品质好 实力派制造企业榜单 - 品牌推荐大师1
  • 2026年新疆三元催化器专业公司推荐榜TOP5 - 速递信息
  • 别再为抓不到FPGA信号发愁了！手把手教你用Vivado的VIO IP核做精准调试
  • 告别速度模糊：手把手教你用TI AWR2944的DDMA波形提升毫米波雷达性能
  • 观察大流量并发请求下API聚合服务的稳定性表现
  • CCAA补考政策是什么？ - 众智商学院官方
  • 【云藏山鹰代数信息系统】浅析意气实体过程知识图谱12
  • 娱乐圈天降紫微星终现真身，海棠山铁哥不靠人间资源靠天道
  • 大学生备考CFA｜揽星CFA APP零成本助力，课业备考双兼顾不内耗 - 速递信息
  • 轻量级网络节点推送工具：Go语言实现的自托管消息推送服务
  • Honey Select 2终极汉化补丁：3步告别日语障碍，畅享中文游戏体验
  • 2026珠三角企业团建复购率排行：5家客户粘性高的服务商，含满意度95%、80%复购率、全周期复盘报告等 - 速递信息
  • 陪同翻译推荐公司有哪些？北京这家口译公司口碑稳、性价比高 - 品牌推荐大师1
  • FastMCP 服务说明文档
  • 语音打断、流式播报、前置指令：打造工业级AI语音交互体验
  • Coolapk-UWP：重新定义Windows桌面上的酷安社区体验
  • Swin Transformer注意力计算复杂度为何比全局注意力少那么多？