前言#

六月份的时候，原版 filebrowser 宣布冻结，项目进入仅维护模式，不再接受新的功能请求问题和 PR。于是核心开发者出来单做了一个新版。Quantum 是一种带有强烈方向性与主观设计理念的分支，开发者为了掌控整体体验，进行了“重大且富有偏见”的改动（如去除终端、执行器、命令行参数等）。目前项目已经进入Beta 测试阶段，稳定版本将于2025年下半发布。

与原来的 filebrowser 有哪些不同？#

FileBrowser Quantum 在功能、性能和体验上与原项目相比有以下显著区别：

1. 高级功能集（Feature-Rich）#

多源支持（Multiple sources）
支持 OIDC 登录、密码 + 2FA、代理登录等多种身份验证方式
响应式且可定制的 UI
简化的 config.yaml 配置文件 GitHub。

2. 高效索引与实时更新#

实时搜索建议
UI 实时监控变化
支持文件/文件夹大小显示和过滤筛选 GitHub。

3. 优化的文件浏览体验#

更丰富的文件类型预览（办公文件、视频等）
切换视图或排序方式无需重新加载数据
显示文件夹大小，记忆上次滚动位置 GitHub。

4. 灵活的共享与访问控制#

可设置分享链接的过期时间、访问用户（包括匿名）、样式主题
可针对分享内容制定查看、编辑、上传权限
支持目录级别的用户/群组访问控制 GitHub。

5. Developer API 支持#

支持长期 API Token
内置 Swagger API 页面，方便探索接口

对比#

方面	原始 filebrowser	FileBrowser Quantum（Quantum）
维护与活跃度	缺乏响应或缓慢	快速活跃、自主迭代
功能可定制性	基础功能	丰富功能、高度自定义（UI、访问、分享、API）
搜索与界面体验	普通浏览界面	实时搜索，智能过滤，记忆滚动等现代化体验
架构与开发效率	旧架构、较慢	架构重写、本地构建快 10 倍
功能移除	保留 jobs、shell 支持	不支持 jobs、去除 shell／命令行支持
开发者愿景	社区协作、保守迭代	个人愿景驱动、扩展性强、目标高

预览#

搭建#

首先，创建一个目录data并添加一个配置文件data/config.yaml，您可以使用此示例 config.yaml作为参考。

1
version: '3.8'
2

3
services:
4
  filebrowser:
5
    image: gtstef/filebrowser
6
    container_name: filebrowser
7
    environment:
8
      FILEBROWSER_CONFIG: "data/config.yaml"
9
      FILEBROWSER_ADMIN_PASSWORD: "passwd"
10
      TZ: "Asia/Shanghai"
11
    volumes:
12
      - /hdd/media:/folder                  # ← 本地真实目录映射
13
      - ./data:/home/filebrowser/data       # ← 配置文件和数据库存放处
14
    ports:
15
      - "127.0.0.1:8185:80"
16
    restart: unless-stopped

你也可以自己参考配置进行修改，下面是我的

https://github.com/gtsteffaniak/filebrowser/wiki/Configuration-And-Examples

1
server:
2
  port: 80
3
  baseURL: "/"
4
  database: "database.db"
5
  cacheDir: "tmp"
6
  disablePreviews: false
7
  disablePreviewResize: false
8
  disableTypeDetectionByHeader: false
9
  logging:
10
    - levels: "info|warning|error"
11
      output: "stdout"
12
  sources:
13
    - path: "/folder"                  # Docker 映射后的路径，对应本地 /hdd/media
14
      name: "媒体库"
15
      config:
16
        defaultEnabled: true
17
        defaultUserScope: "/"
18
        disableIndexing: false
19

20
auth:
21
  adminUsername: "admin"
22
  adminPassword: "admin"
23
  tokenExpirationHours: 2
24
  methods:
25
    password:
26
      enabled: true
27
      minLength: 5
28
      signup: false
29

30
frontend:
31
  name: "FileBrowser Quantum"
32
  disableUsedPercentage: false
33
  disableDefaultLinks: false
34
  disableNavButtons: false
35
  externalLinks:
36
    - text: "帮助文档"
37
      title: "帮助文档"
38
      url: "https://github.com/gtsteffaniak/filebrowser/wiki"
39

40
userDefaults:
41
  darkMode: true
42
  locale: "zh"
43
  viewMode: "normal"
44
  singleClick: false
45
  showHidden: false
46
  themeColor: "var(--blue)"
47
  quickDownload: false
48
  dateFormat: false
49
  gallerySize: 3
50
  stickySidebar: true
51
  disableQuickToggles: false
52
  disableSearchOptions: false
53
  hideSidebarFileActions: false
54
  permissions:
55
    admin: false
56
    modify: false
57
    share: false
58
    api: false
59
    realtime: false
60
  preview:
61
    image: true
62
    video: true
63
    popup: true
64
    office: false
65
    highQuality: false
66
    autoplayMedia: false
67
    disableHideSidebar: false
68
  loginMethod: "password"
69
  disableUpdateNotifications: false
70
  deleteWithoutConfirming: false
71
  fileLoading:
72
    maxConcurrentUpload: 10
73
    uploadChunkSizeMb: 10
74

75
integrations:
76
  media:
77
    ffmpegPath: ""      # 如需支持视频转码可指定 /usr/bin（容器中 ffmpeg 安装路径）

最后

1
docker compose up -d

总结#

目前来看 Quantum 相比原版性能更加优秀，不仅界面更加直观友好，还加入了实时搜索，多文件源支持和 Office 文件预览等实用功能。期待正式版本。

Docker-Install-FileBrowser-Quantum.md

前言#