走进 FileBrowser Quantum：你的自托管文件管家

想在自己的服务器上轻松管理文件，却不想被繁琐安装和复杂配置拖慢脚步？FileBrowser Quantum 或许正合你心意。它基于开源项目深度重构，抛去臃肿，保留精华，立志成为“最优秀的免费自托管文件浏览应用”。无论是本地磁盘、云端存储，还是各种协议都能一网打尽；无论是日常浏览，还是开发集成，都能一键搞定。

核心亮点，一目了然

  1. 多源统一管理
    你可以同时挂载本地存储、S3、WebDAV、FTP……想怎么混合用，都由你做主。

  2. 灵活登录，多重安全

    • OpenID Connect（OIDC）
    • 本地账号 + 二次验证（2FA）
    • 反向代理接入
      三层守护，为你的数据上了三道“保险锁”。

  3. 极简界面，直观好用

    • 左侧：常用操作面板
    • 中间：智能搜索框
    • 右侧：视图模式切换
      无需翻页，重点功能随手可得。

  4. 秒级索引，实时同步
    想搜文件？只要动一动手指就能看到结果；改动文件夹？界面瞬间刷新，不再担心旧数据“卡壳”。

  5. 细节打磨，操作顺滑
    预览 Office 文档与视频不再靠外挂；切换视图、排序瞬间生效，还会记住上次滚动的位置——下次打开，恍如昨日。

  6. 开发者之友：完整 API
    自动化脚本、二次开发，统统搞定。内置 Swagger 文档，拿到 Token 以后，随时对接第三方系统。

界面三段式导航：找东西更快

┌─────────┬─────────────┬─────────┐
│  左侧   │   中部      │  右侧   │
│ 操作面板│ 搜索栏      │ 视图切换│
└─────────┴─────────────┴─────────┘
  • 左边一览无余：新建、上传、分享……所有常用操作都在这里。
  • 中间搜你想搜：模糊、精确或高级过滤，三种模式随心切换。
  • 右侧多种呈现：列表、网格、缩略图，怎么看都舒服。

三步搞定部署（Linux 示例）

只要三条命令，秒变文件管理小能手：

# 1. 下载并赋予执行权限
wget https://github.com/gtsteffaniak/filebrowser/releases/download/v0.0.0/filebrowser_q
chmod +x filebrowser_q

# 2. 创建基本配置文件
cat > config.yaml <<EOF
bind: ":8080"
baseURL: "/"
log:
  level: info
  file: "./fb.log"
EOF

# 3. 启动服务
./filebrowser_q -c config.yaml

“

然后在浏览器里打开 http://<服务器IP>:8080，就能看到清爽的管理界面了。

一些常用命令，你可能会用到

命令 作用描述
filebrowser_q --help 列出所有参数和使用方式
filebrowser_q users add 快速添加一个新用户
filebrowser_q share list 查看当前所有分享链接
filebrowser_q version 输出正在运行的版本号

“

提示：这些命令不需要登录就能执行，方便在脚本里直接调用。

API 集成，随时随地自动化

打开 http://<服务器>/swagger，你会看到全套接口文档。例如：

  • 列出文件：GET /api/v1/fs/list?path=/
  • 上传文件：POST /api/v1/fs/upload

只要在请求头里加上 X-Auth-Token: <你的 Token>，即可无缝对接自己写的工具或脚本。

办公文档在线预览

办公族常见的 Word、Excel、PPT，一键预览不求人。若你在 Docker 环境里，还能快速集成 OpenOffice，实现“所见即所得”的在线编辑。

从旧版平滑过渡，这样做

  1. 停掉原版服务
  2. 备份旧配置和数据目录
  3. 安装 Quantum 可执行文件
  4. 将配置转为新格式（config.yaml）
  5. 重启并检查数据是否完整

简单几步，就能让你在新版本里继续愉快地工作。

与其他方案简单比一比

功能 Quantum 原版 FileBrowser Filestash Nextcloud Google Drive
多源挂载 ✔ ✖ ✔ ✔ ✖
实时索引与搜索 ✔ ✖ ✖ 可选 ✔
Office 在线预览 ✔ ✖ ✖ ✔ ✔
一键部署单文件包 ✔ ✔ ✖ ✖ ✖
长期有效的 API Token ✔ ✖ ✔ ✔ ✔

常见问答（FAQ）

总结一下

FileBrowser Quantum 把“轻量”、“易用”与“企业级”三个词揉到了一起。不管你是想快速搭建个人文件服务器，还是给团队提供安全高效的共享平台，它都能从容应对。动手试试，你会发现：管理文件，从此变得简单又有趣。