gtsteffaniak/filebrowser

FileBrowser Quantum 是原 FileBrowser 项目的大幅分叉版本，重做成一个可自托管的网页文件管理器：现代界面、多个存储源、单点登录和可配置的分享链接。如果你已经在自托管一些服务，想要一层跑在自有目录上的浏览器文件入口，它值得考虑。

解决什么问题

文件放在家里的服务器或 VPS 上，想从浏览器直接访问，而不是每次开 SSH，或者把所有东西同步到云盘。常见做法要么上一套很重的协作套件，要么只有一个简陋的目录列表，搜索弱、没有按用户划分权限。Quantum 改变的是中间这一步：把它指向一个或多个本地路径，配置用户或用户组，就得到一个可搜索、带缩略图、能生成分享链接、还能直接编辑文本文件的浏览器。最终你通过一份 config.yaml 管理一个私有的文件门户。

有什么不同

最核心的差异在源配置。它不要求单一根目录，而是可以登记多个源，配合包含/排除规则，再把访问控制限定到某个用户或用户组以及某个源路径——当同一台机器上不同的人只该看到不同目录时，这一点很实用。搜索基于索引，输入时实时返回，支持按文件和文件夹大小过滤；缩略图覆盖 Office 文档、视频、专辑封面和 3D 模型，列表里还会显示文件夹大小。

登录方式也比原版多：文档列出 OIDC、LDAP、JWT、密码加 2FA 以及代理头认证。分享链接可以设置过期时间、匿名或指定用户访问、样式主题，以及查看、编辑、上传的分别授权。此外还有开发者 API，支持长期有效的令牌，并在 /swagger 提供接口页面。

代价在项目自己的对比表里就能看到。Docker 镜像标注为含 ffmpeg 的 180 MB，最低内存 512 MB，明显重于原版的 31 MB 镜像和 128 MB 最低内存——缩略图生成和索引都要消耗资源。这个分叉刻意移除了 shell 命令功能，作者表示不会恢复，所以不要指望用它执行命令。S3 和 FTP 不受支持。对比表里还有一批功能——自定义任务、标签、回收站、指标、事件通知、压缩包浏览、文档/视频/图片转换——标注为建设中，尚不可用。

谁值得试

适合：在跑家庭实验室或小团队服务器的人，想要一个覆盖本地目录的浏览器界面，需要独立账号、按组可见、分享链接，以及通过已有身份提供方登录。当一台机器由多人共用、彼此不该看到对方文件时，多源加按路径授权最重要。

不适合：需要 S3 或 FTP 后端、需要手机应用（对比表标注没有）、需要文件评论，或者依赖原版 shell 命令功能的人。如果你主要是想浏览对象存储，这个项目只支持文件系统，直接排除。内存余量不到 512 MB 左右、或者对镜像体积敏感的人，应把原版 FileBrowser 纳入比较。如果你从 v1 迁移，项目指向 v2.0.0 的迁移讨论，要提前规划，而不是假设可以平滑升级。

使用条件与边界

它提供独立二进制和 Docker 镜像，支持 Linux、Windows 和 macOS。你需要提供文件系统路径并编写 config.yaml，可参考入门文档和单独的源配置指南。初始配置不算复杂，但日常维护涉及索引和缩略图处理，这也是最低内存高于原版的原因。

项目作者的对比表是作者自己做的，功能勾选应视为作者声明而非独立验证。内容感知搜索明确没有，S3/FTP 缺失，标注为建设中 的功能不应纳入规划。文档站点目前只有英文，项目自己的对比表也列明没有手机应用。

HotRepo 点评

HotRepo 在 2026-10-28 的 Go 月榜记录到第 18 名、当月新增 535 星；没有可比的日榜历史，因此无法凭现有证据判断热度能否持续。采用前值得确认两件事：v2 的迁移路径，以及你所需的登录方式是否在文档中明确列为支持。