Unraid 深度定制：轻量全能文件管理器 Filebrowser Quantum

一、 前言：为什么要做这个集成？

各位 Unraid 玩家，大家平时管理文件是不是还在不停地切换标签页？要么用官方那个反应慢半拍的 Docker 终端，要么忍受原生 Main 页面的简陋。

为了解决这个问题，我深度维护并适配了 FileBrowser Quantum。它不仅仅是一个文件管理器，更是 Unraid 缺失的那个“灵魂组件”。最重要的是：它可以直接“缝”进 Unraid 的原生 UI 选项卡里，像系统自带功能一样丝滑！

原生感：就像系统自带的 Main 或 Docker 页面一样，点开即用。

一体化：管理阵列、监控硬盘、整理文件，全部在一个窗口内完成。

二、 核心卖点（敲黑板！）

• 根据官方文档 的技术特性，这个增强版在 Unraid 环境下有着得天独厚的优势：

  • 🚀 性能怪兽：Quantum 版优化了文件索引架构，即便是面对十几 TB 的影视库或成千上万的备份照片，搜索和加载都是“秒级”响应。

  • 🌐 全能兼容性：它针对现代网络环境进行了重构。无论你是内网直连，还是通过各类反向代理软件进行外网远程访问，它都能稳定地缩在 Unraid 的框架内，不会产生令人恼火的“自动跳出”或“登录失效”问题。

  • 📂 极速全域搜索：内置了比原生版更强大的搜索引擎，支持模糊匹配和深度过滤，找文件不再是大海捞针。

  • 🖼️ 影音预览天花板：支持绝大多数音视频编码的在线直接播放，文档预览也更加丝滑，是真正的“全能预览器”。

  • 文件管理“零切换”： 以前：发现电影名字乱码 -> 切标签页 -> 找 FileBrowser -> 改名 -> 切回 Unraid。 现在：点击“FQ”标签 -> 直接改名 -> 点击“Docker”标签继续工作。

  • 外网访问“真·一体”： 适配了完善的安全协议，你在外网通过 HTTPS 域名登录 Unraid 后，里面的文件管理模块依然稳如泰山，无需二次登录，更不会弹出报错窗口。

  • 移动端自适应： Quantum 版对手机端进行了深度优化，配合 Unraid 响应式界面，在手机浏览器上管理文件也像原生 App 一样好用。

三、 部署简述：一键直达

为了让大家都能用上这个神器，我已经将复杂的底层逻辑打包成了标准的 Unraid 插件。你不需要手动修改任何系统文件，只需简单一步：

1. 打开 Unraid 插件中心，点击“安装插件”选项夹。

2. 输入插件的 URL 地址或本地插件文件的路径：

   https://raw.githubusercontent.com/insomnia417/Unraid-FileBrowser_Quantum-Plugins/refs/heads/main/FileBrowser_Quantum.plg

3. 点击安装。安装完成后，你的 Unraid 顶部导航栏就会直接出现 “FB” 选项卡，点击输入
   默认账户: admin

   默认密码: admin

   即可食用。

4. 其他更多功能，可前往 设置中点击 "filebrowser_quantum" 查看。

5. 更多config.yaml的高阶配置请移步官方文档查看：

官方文档：

Documentation | FileBrowser Quantum Documentation

我的插件项目主页：

insomnia417/Unraid-FileBrowser_Quantum-Plugins: Unraid FileBrowser Quantum Plugins

四、 实际展示

• 首页顶栏

• filebrowser quantum 内部设置页

• 自定义侧边栏，快捷跳转文件地址

• 手机访问页面，完美适配

• 贴心三栏设置：更新，配置文件修改，实时日志

五、 结语

玩 NAS 的乐趣就在于折腾出最适合自己的工作流。这个项目我维护了很久，从一个完全不懂代码的小白，到解决了无数个坑的新手。现在把它分享出来，希望能让大家的 Unraid 更加好用！

如果有遇到问题，欢迎在评论区或者项目issus留言，我们一起交流。

项目开源/维护地址： insomnia417/Unraid-FileBrowser_Quantum-Plugins at main

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～