前言
在日常的 文件管理与团队协作 中,我们经常会遇到以下问题:
👉 文件零散存放在不同服务器或本地电脑,难以统一管理;
👉 想要一个轻量级的 私人网盘,既能在线浏览,又能随时上传、下载;
👉 不希望依赖第三方云盘,担心隐私和数据安全;
👉 希望通过 开源方案 自主搭建,方便二次开发与功能扩展。
传统的文件管理方式往往依赖 FTP、Samba 或第三方云盘服务,不仅操作繁琐,还可能存在安全风险。而 Filebrowser 正是为此而生 —— 一款轻量级、开源的 Web 文件管理器,能够快速搭建属于你自己的 Web 私人网盘,支持浏览、上传、下载、分享、在线编辑等功能。
为什么选择 Filebrowser?
- 功能全面:支持多用户、文件预览、分享链接、权限控制、Markdown 渲染等;
- 开源免费:轻量化设计,遵循 Apache 2.0 协议,自由使用与二次开发;
- 界面友好:简洁直观的 Web UI,操作体验接近主流网盘;
- 部署简单:原生支持 Docker,只需几行命令即可完成部署,几分钟就能拥有属于自己的“私人云盘”。
无论你是 个人开发者、团队协作,还是 企业内部文件管理,Filebrowser 都能帮助你快速搭建一个高效、安全、可控的 Web 私人网盘。
1.项目
File Browser 是一个开源的、自托管的 Web 文件管理器。
它可以让你在浏览器中管理服务器上的文件,支持上传、下载、移动、预览、编辑、删除、压缩/解压等操作,相当于给你的服务器搭建了一个“网盘”。
1.1项目特点
主要功能
- 多用户支持:可创建不同用户和权限。
- 多存储支持:本地文件系统、FTP、S3、Dropbox、Azure Blob 等。
- 多种认证方式:JSON、数据库、WordPress 等。
- 多会话适配器:文件、PDO、Redis、MongoDB、Memcached 等。
- 前端基于 Vue.js,界面简洁现代。
- 支持断点续传、批量下载、无需数据库。
1.2项目展示




2.相关地址
gitHub开源项目:https://github.com/filebrowser/filebrowser
3.搭建环境
- 服务器:这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接:https://www.lcayun.com
- 资源配置:2核2G 30G硬盘
由于国内服务器访问海外源较慢,这边为了方便演示直接使用海外服务器搭建。 - 服务器系统:Debian-12
- 【必需】安装Docker:安装好 Docker、Docker-compose
- 【非必需】域名一枚,可用于解析到服务器上使用域名访问

4.搭建视频
哔哩哔哩:
5.搭建方式
5.1 安装docker和docker-compose
安装教程:服务器上安装docker和docker-compose教程
5.2 创建Filebrowser的docker文件
#在opt目录下创建Filebrowser文件夹
mkdir /opt/Filebrowser
#打开Filebrowser文件
cd /opt/Filebrowser
#编辑docker-compose.yml文件
vi docker-compose.yml
5.3 安装Filebrowser镜像
services:
filebrowser:
image: filebrowser/filebrowser:latest # 使用最新的 File Browser 镜像
container_name: filebrowser # 容器名称
restart: unless-stopped # 容器异常退出后自动重启
ports:
- "8080:80" # 宿主机 8080 端口映射到容器 80 端口
volumes:
- ./data:/srv # 映射的数据目录(存放需要管理的文件)
- ./database:/database # 存放 File Browser 数据库文件
- ./config:/config # 存放 File Browser 配置文件
environment:
- PUID=1000 # 宿主机用户ID(避免文件权限问题,可修改)
- PGID=1000 # 宿主机用户组ID(避免文件权限问题,可修改)
填完按esc键 输入 :wq 保存退出
#赋予权限
sudo chown -R 1000:1000 config database data
sudo:以超级用户(root)权限执行命令。
chown:Linux 命令,意思是 change owner(修改文件/目录的属主和属组)。
-R:递归修改,也就是包含目录里的所有子目录和文件。
1000:1000:
前面的 1000 表示 用户 ID (UID)
后面的 1000 表示 用户组 ID (GID)
(对应你 docker-compose.yml 里设置的 PUID=1000、PGID=1000)
config database data:要修改权限的三个目录名。
5.4 运行Filebrowser的docker镜像
我们先启动docker
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d
5.4 访问WEB端
访问IP:8080端口就可以有界面出现了。
http://ip:8080

初次启动会自动生成一个默认管理员账号密码(只在日志里显示一次)。
docker logs filebrowser


点击设置可以修改中文

接下来就可以自行使用了,这是一个简单又轻量的Web 文件管理器。
6.结尾
File Browser 不仅功能全面、界面简洁,而且支持多用户、多语言和 Docker 一键部署,让你轻松搭建私有云盘或团队文件管理平台。无论是个人存储、团队协作,还是文件分享,File Browser 都能帮你高效管理。
现在就动手部署一个属于你的 File Browser 吧,让你的文件管理更安全、更便捷、更高效!点击几步操作,就能在浏览器中自由管理文件,开启全新的数字办公体验。 🚀