https://mp.weixin.qq.com/s/dUyEirSSPN1EZwHM4CkFYQ

https://github.com/gtsteffaniak/filebrowser

作为天天跟代码和服务器打交道的程序员,谁没被文件管理折磨过?本地文件东一个西一个,服务器上的资料靠 FTP 来回倒腾,团队共享文件总担心权限出岔子…… 说到文件管理工具,估计不少人用过经典的 FileBrowser,但这项目好几年没大更新了,功能慢慢跟不上咱们的需求。

今天开源君给大家分享一个超级实用的开源项目 - FileBrowser Quantum,既继承了 FileBrowser 的优点,又添加了很多实用功能。

项目简介
FileBrowser Quantum是一个让你用网页就能管理服务器文件的轻量级工具。听这名字就让人感觉高大上,对吧?其实,“Quantum”并不是指真正的量子计算,而是形容它功能强大、速度快、易用性高,就像量子一样神奇。

它是基于原FileBrowser项目的一个大幅改进版,保留了原项目的优点,同时加入了大量新特性和优化,不管是 Windows、Linux 还是 Mac 系统都能跑。最重要的是,它完全免费且开源,你可以随意使用、修改和分发,真是太给力了!

和同类产品的部分对比
和同类产品的部分对比
目前在Github上收获了2.6K star,非常的不错!

相比原版FileBrowser的升级

支持多源文件管理,能同时挂载本地硬盘、NAS、服务器目录等不同来源的文件,无需切换路径即可统一管理。
登录方式更丰富,除了原有的密码登录,还新增了 OIDC 认证、密码 + 二次验证以及代理登录等方式,安全性大幅提升。
界面全面翻新,采用了更符合现代审美的设计,布局更合理,操作起来更顺手,给用户带来全新的视觉体验。

配置过程简化,通过 config.yaml 配置文件即可完成设置,相比原版更便捷,减少了繁琐的操作步骤。
索引效率极大提升,实现了超高效的索引和实时更新,搜索时输入关键词就能实时显示结果,还支持按文件和文件夹大小及多种过滤器筛选,UI 也能实时监控和更新。

列表浏览体验优化,支持更多文件类型预览,如 Office 文档和视频等;切换视图模式和排序顺序无需重新加载数据,能显示文件夹大小,导航时还会记住上次的滚动位置。

增加了开发者 API 支持,可创建长期有效的 API 令牌,且为启用 API 的用户提供了实用的 Swagger 页面,方便进行二次开发和功能扩展。

快速安装使用
1、用 Docker 的话一行命令搞定,把 /path/to/your/folder 换成你的文件目录,访问localhost:80就能用,默认账号密码都是 admin:

docker run -d -v /path/to/your/folder:/srv -p 80:80 gtstef/filebrowser:beta
浏览器打开 http://<ip>:8080,进去第一件事记得改密码。

这个方法仅适合一次性体验,数据不会保留。

2、如果想要在正式生产中使用(数据持久化),可以使用下面的方式:

创建配置目录和文件



mkdir -p data
touch data/config.yaml

可以参考这个最简配置模板:

server:
  sources:
    - path: /folder  # 对应下面 docker-compose 里挂载的目录
      config:
        defaultEnabled: true
auth:
  adminUsername: admin

然后编写 docker-compose.yaml

services:
  filebrowser:
    image: gtstef/filebrowser
    ports:
      - '80:80'
    volumes:
      - '/path/to/folder:/folder'  # 挂载你想管理的文件夹
      - './data:/home/filebrowser/data' # 保存配置和数据库
    environment:
      FILEBROWSER_CONFIG: "data/config.yaml"
      FILEBROWSER_ADMIN_PASSWORD: admin
    restart: unless-stopped

启动服务


docker-compose up -d

打开浏览器访问 http://localhost,默认账号密码是 admin/admin。数据库、配置、缓存全落在本地 ./data,删容器也不丢。

3、如果不用 Docker 的话,就去 GitHub releases 页下载对应系统的执行文件,Windows 直接双击运行,Linux/Mac 用命令行启动就行。

小结
FileBrowser Quantum可以说是老牌项目 FileBrowser 的“续命强化版”,在它的基础上继续打磨优化,让这个工具重新焕发生机,让文件管理变得不再“高大上”,而是“轻松+愉快”。

更多细节功能,感兴趣的可以到项目地址查看:

https://github.com/gtsteffaniak/filebrowser

文档更新时间: 2025-07-13 08:02   作者:admin