搬瓦工部署 FileBrowser Web 文件管理器完整教程

FileBrowser 是一款轻量级的 Web 文件管理器，让你通过浏览器即可管理服务器上的文件。它提供了直观的界面用于上传、下载、重命名、移动、删除文件，还支持在线编辑文本文件、创建分享链接和多用户管理。对于不熟悉 Linux 命令行的用户来说，FileBrowser 是一个非常实用的工具。本文将介绍如何在搬瓦工 VPS 上通过 Docker 快速部署 FileBrowser。

一、准备工作

1.1 系统要求

操作系统：Ubuntu 20.04+（推荐 Ubuntu 22.04）。
内存：FileBrowser 非常轻量，256MB 内存即可运行。
磁盘空间：程序仅约 15MB。
Docker：需提前安装，参考 Docker 安装教程。

1.2 创建目录

mkdir -p /opt/filebrowser/data
mkdir -p /opt/filebrowser/config

二、Docker Compose 部署

2.1 创建配置文件

首先创建 FileBrowser 的配置文件：

cd /opt/filebrowser
cat > config/settings.json <<'EOF'
{
  "port": 80,
  "baseURL": "",
  "address": "",
  "log": "stdout",
  "database": "/database/filebrowser.db",
  "root": "/srv"
}
EOF

然后创建 docker-compose.yml：

cat > docker-compose.yml <<'EOF'
version: '3.8'

services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/srv
      - ./config/settings.json:/.filebrowser.json
      - ./config:/database
EOF

2.2 启动服务

docker compose up -d

2.3 初始登录

浏览器访问 http://你的服务器IP:8080，使用默认凭据登录：

用户名：admin
密码：admin

登录后请立即在「设置」→「用户管理」中修改管理员密码。

三、基本操作

3.1 文件管理

FileBrowser 的界面类似于桌面文件管理器，支持以下操作：

浏览文件：点击文件夹进入，支持面包屑导航。
上传文件：点击上传按钮或直接拖拽文件到页面。
下载文件：选中文件后点击下载按钮，支持批量打包下载。
新建：创建新文件夹或新文件。
编辑：双击文本文件可在线编辑，内置代码高亮。
搜索：支持按文件名搜索。

3.2 文件分享

选中文件或文件夹后点击分享按钮，可以生成公开的下载链接。分享链接支持设置：

过期时间（小时/天/永不过期）。
密码保护。
访问单位（次数限制）。

3.3 在线编辑

FileBrowser 内置了 Monaco Editor（VS Code 的编辑器内核），支持语法高亮的文件类型包括 HTML、CSS、JavaScript、Python、JSON、YAML、Markdown 等。

四、管理多个目录

如果你想通过 FileBrowser 管理服务器上的多个目录，可以在 docker-compose.yml 中挂载多个卷：

    volumes:
      - /home:/srv/home
      - /var/www:/srv/websites
      - /opt:/srv/applications
      - ./config/settings.json:/.filebrowser.json
      - ./config:/database

这样在 FileBrowser 中就可以看到 home、websites、applications 三个顶级目录。

五、多用户管理

在「设置」→「用户管理」中可以创建多个用户，每个用户可以配置：

作用域：限制用户只能访问特定子目录，例如设置为 /home/user1。
权限：配置是否允许创建、修改、删除、下载、分享等操作。
语言：每个用户可以选择自己的界面语言。
角色：管理员或普通用户。

六、自定义命令

FileBrowser 支持自定义命令，可以在文件操作前后执行特定的 Shell 脚本。在「设置」→「全局设置」中配置命令钩子，例如：

上传完成后自动执行文件扫描。
删除文件前进行备份。
修改文件后触发自动部署。

七、Nginx 反向代理

server {
    listen 443 ssl http2;
    server_name files.example.com;

    ssl_certificate /etc/letsencrypt/live/files.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/files.example.com/privkey.pem;

    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_buffering off;
        proxy_request_buffering off;
    }
}

client_max_body_size 0 表示不限制上传文件大小，可以根据实际需要调整。

八、API 接口

FileBrowser 提供 RESTful API，可以通过脚本自动化文件管理操作。首先获取认证令牌：

# 获取令牌
TOKEN=$(curl -s -X POST "http://localhost:8080/api/login" \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your_password"}')

# 列出文件
curl -s -H "X-Auth: $TOKEN" "http://localhost:8080/api/resources/"

# 上传文件
curl -X POST -H "X-Auth: $TOKEN" \
  -T localfile.txt "http://localhost:8080/api/resources/remotepath/file.txt"

九、维护与更新

9.1 更新 FileBrowser

cd /opt/filebrowser
docker compose pull
docker compose up -d

9.2 备份数据

tar -czf filebrowser-backup.tar.gz -C /opt/filebrowser config/

总结

FileBrowser 是一款极其轻量但功能实用的 Web 文件管理器，非常适合在搬瓦工 VPS 上为服务器文件提供可视化的管理界面。无论是日常的文件上传下载，还是在线编辑配置文件，FileBrowser 都能轻松胜任。如果你需要更完整的网盘和协作功能，可以参考 Nextcloud 或 Seafile 教程。选购搬瓦工 VPS 请参考全部方案，购买时使用优惠码 NODESEEK2026 可享受 6.77% 的循环折扣。如遇问题，可前往搬瓦工官网提交工单。