FileBrowser 是一个开源的轻量级网页文件管理器,它的核心价值在于:只需一个浏览器,就能像操作本地电脑一样,远程管理服务器、NAS或任何电脑上的文件。
当你成功部署后,上传下载、解压压缩、在线预览,甚至是与朋友分享文件,都只需要一个链接就能完成。GitHub地址:https://github.com/filebrowser/filebrowser
目前官方镜像新版本默认使用 UID/GID 1000 运行,不再使用 root 用户,因此部署时需要特别留意文件权限和挂载方式
下面我将通过一张架构图,帮你直观地理解它如何工作,并附上最推荐的 Docker 部署方式。

🐳 Docker 部署指南
这是最推荐的方式,便于管理。由于 FileBrowser 官方镜像在挂载文件时有个小坑,请按以下步骤操作:
# 1. 创建存放数据和配置的总目录
mkdir -p /docker/filebrowser/{data,storage}
# 2. 关键步骤:预先创建一个空的数据库文件
# 如果不做这一步,Docker 可能会创建一个名为 database.db 的目录,导致容器启动失败
touch /docker/filebrowser/data/database.db
一键运行容器
使用下面的 docker run 命令启动服务。记得把 /path/to/your/local/files 换成你真实的文件目录。
docker run -d \
--name filebrowser \
--restart always \ # 设置容器自动重启
-v /docker/filebrowser/data:/data \ # 挂载配置和数据库目录
-v /path/to/your/local/files:/srv \ # 【重要】挂载你的文件目录
-p 8080:80 \ # 端口映射,宿主机端口可改
--user $(id -u):$(id -g) \ # 使用当前用户权限运行
filebrowser/filebrowser
如果你的系统不支持自动获取UID,直接用 --user 1000:1000 通常是安全的
获取初始密码
容器首次启动时,会随机生成一个密码,通过查看日志可以获取
docker logs filebrowser 2>&1 | grep -i password
开始使用
在浏览器中输入 http://你的服务器IP:8080 即可访问。默认的用户名通常是 admin,密码就是上一步获取到的密码

- 腾讯VPS部署
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/filebrowser
🚀 登录与首次配置
- 修改密码:登录后,强烈建议第一时间修改密码。点击左侧 设置 (Settings) -> 个人设置 (Profile Settings) 进行修改。
- 切换中文:如果界面是英文,点击 设置 (Settings) -> 全局设置 (Global Settings),在 语言 (Language) 选项中选择
简体中文后保存即可。
🔧 进阶技巧与建议
- 多用户管理:可以在“设置”中添加多个用户,并为不同用户指定不同的访问目录(范围)和权限(只读或读写),非常适合团队使用。
- 公网访问:默认只能在局域网访问。如果想在任何地方连接家里的 FileBrowser,可以了解一下 内网穿透 工具(如 cpolar、ZeroNews、frp 等),它们能为你的服务分配一个公网地址。
- 数据安全:别忘了备份
/docker/filebrowser/data/目录下的database.db数据库文件,这里面保存了你所有的用户和配置信息。
部署成功后,你可以试试上传一张图片或一个文档,体验一下在线预览功能。如果在过程中遇到任何权限或访问问题,随时可以再来问我~
Centos7.9下用宝塔部署开源网盘程序Z-file:https://www.hao0564.com/2023.html
