前言

在日常的 文件管理与团队协作 中，我们经常会遇到以下问题：
👉 文件零散存放在不同服务器或本地电脑，难以统一管理；
👉 想要一个轻量级的 私人网盘，既能在线浏览，又能随时上传、下载；
👉 不希望依赖第三方云盘，担心隐私和数据安全；
👉 希望通过 开源方案 自主搭建，方便二次开发与功能扩展。

传统的文件管理方式往往依赖 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.搭建视频

哔哩哔哩：https://www.bilibili.com/video/BV1GLYVzxEwT/

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 吧，让你的文件管理更安全、更便捷、更高效！点击几步操作，就能在浏览器中自由管理文件，开启全新的数字办公体验。 🚀

教你用docker搭建一款开源的Web私人网盘—FileBrowser

前言