FileBrowser 是一个开源的轻量级网页文件管理器,它的核心价值在于:只需一个浏览器,就能像操作本地电脑一样,远程管理服务器、NAS或任何电脑上的文件。
当你成功部署后,上传下载、解压压缩、在线预览,甚至是与朋友分享文件,都只需要一个链接就能完成。GitHub地址:https://github.com/filebrowser/filebrowser
一,在腾讯VPS用docker安装部署内容如下:
docker run \
-v /home/docker/filebrowser/data/Downloads/Downloads/:/srv \
-v /home/docker/filebrowser/filebrowser.db:/database.db \
-v /home/docker/filebrowser/settings.json:/config.json \
-e PUID=$(id -u) \
-e PGID=$(id -g) \
-p 8282:80 \
--restart unless-stopped \
filebrowser/filebrowse
二,问题解决方案参考
你遇到的 mkdir /srv/11: permission denied 错误,核心原因是运行 FileBrowser 容器的用户 (UID/GID 1000:1000),没有对你宿主机上要管理的目录 /home/docker/filebrowser/data/Downloads/Downloads/ 的写入权限。
这个新版本的 FileBrowser 为了安全,默认不再使用 root 用户运行,因此需要你手动将宿主机目录的权限赋予它默认的用户 1000:1000。
这里有三种解决方法,推荐你先从第一种开始尝试。
方案一:修改宿主机目录权限(推荐)
这是最直接且安全的做法,直接给 FileBrowser 开放它需要的目录的写入权限。
- 停止并删除当前容器(这不会删除你的配置和数据):
docker stop <你的容器名>
docker rm <你的容器名>
如果不确定容器名,可以用 docker ps -a 查看。
- 修改宿主机目录的所有者:在宿主机上执行以下命令,将你准备让 FileBrowser 管理的目录 (
/home/docker/filebrowser/data/Downloads/Downloads/) 的所有权,递归地赋予给 UID 和 GID 都为1000的用户。这是 FileBrowser 容器内部默认使用的用户
sudo chown -R 1000:1000 /home/docker/filebrowser/data/Downloads/Downloads
#修改后问题得到解决
sudo chown -R 1000:1000 /home/docker/filebrowser
- 重新用原命令部署容器:修改权限后,再次运行你最初的
docker run命令即可。
方案二:修改 FileBrowser 的启动用户(备选)
如果你想保留目录现有的所有者,也可以让 FileBrowser 以你宿主机上的指定用户身份运行,但这个用户必须对目录有写入权限。
在你的 docker run 命令中,将 -e PUID=$(id -u) -e PGID=$(id -g) 替换为 --user 参数。例如,如果你当前登录的用户是 pi,并且想让他来运行容器,可以这样做:
- 首先,确保
pi用户对目录有写入权限。如果没有,可以用sudo chown -R pi:pi <目标目录>来修改。
- 使用
--user参数启动容器:
docker run \
-v /home/docker/filebrowser/data/Downloads/Downloads/:/srv \
-v /home/docker/filebrowser/filebrowser.db:/database.db \
-v /home/docker/filebrowser/settings.json:/config.json \
--user $(id -u):$(id -g) \ # 替换原来的 PUID/PGID 参数
-p 8282:80 \
--restart unless-stopped \
filebrowser/filebrowser
- # 替换原来的 PUID/PGID 参数 -p 8282:80 \ –restart unless-stopped \ filebrowser/filebrowser
$(id -u)和$(id -g)会自动替换为你当前用户的 UID 和 GID。
方案三:使用 Root 权限运行(不推荐)
这是最简单但最不安全的方法,仅适合在内网测试环境快速验证问题。将 --user root 加入你的 docker run 命令中即可。
# 在 docker run 命令中加入 --user root
docker run \
--user root \
... # 其他参数保持不变
总结与验证
你可以通过以下命令快速定位问题。在宿主机上执行:
# 检查目录的实际所有者,如果不是 1000 或你指定的用户,就会出现权限错误 ls -ld /home/docker/filebrowser/data/Downloads/Downloads/ # 检查运行容器的用户 docker exec <容器名> id
通常情况下,执行方案一后问题即可解决。如果仍有问题,请检查你的 settings.json 和 filebrowser.db 文件是否也已正确创建并赋予权限。
docker下部署File Browser:https://www.hao0564.com/5954.html
