自架 Web 檔案管理器這條線這幾年慢慢成形——File Browser 用單顆 Go binary 撐住輕量派、Nextcloud 用 PHP 全家桶接一整套協作工具、Filestash 走 SFTP/S3 閘道路線把儲存跟前端拆開。這場戰局在 2026 年 9 月 1 日被一次改寫：File Browser 的原作者 Henrique Dias 把 repository 直接 archived，將近十年的老專案畫下句點，也讓兩萬多顆星、無數 VPS 上跑著的部署被迫做出選擇。
決策不算意外。Dias 在封存前的公告直接把三件事攤開：程式碼是他 15 歲時寫的、架構已經無法漸進修補、單靠週末幾小時的心力再往下走沒意義。「這不是修補幾條 issue 能解決的，File Browser 要救就得從頭重寫。」這句話對還在跑舊版的組織來說，重點不只是要不要換工具，而是自架 Web 檔案管理器這種看似簡單的服務其實暗藏多少設計坑。
檔案管理器這件事為什麼比想像難
File Browser 的架構乍看單純：Go binary 綁 web server、SQLite 存使用者、一個瀏覽器 UI 打 filesystem。真正跑起來才會發現坑在權限模型。Web 端 user 必須映射回 host uid，才能決定他能不能看到 /srv/data 底下的檔案；但要讓 web server 有能力讀寫多個使用者範圍的檔案，行程就得跑在 root 或高權限 uid，權限檢查全都退化成應用層自己拉的規則。
這條線 File Browser 從第一天就沒設計對。所有存取都經過同一個行程、應用層檢查一旦被繞過就等於整臺 host 的檔案系統暴露；rules engine 在早期版本用 shell command hook 撐、路徑過濾用字串前綴比對，攻擊者透過 symlink 或 ../ 繞路就能跳出所謂 scope。CVE-2023-27593 揭露的是最出名的一次——沒有登入權限的使用者透過分享連結拉到系統敏感檔。
Dias 說「這不是修補幾條 issue 就能解決」的意思正在這裡。權限、稽核、驗證、API 這四塊要真的做穩，得從資料模型跟中介層一起翻。硬要在原本的 codebase 上補只會越補越薄，這也是為什麼他選擇把 repo archived、把責任讓給 fork 或替代品。
FileBrowser Quantum 拿到接棒的資格
Quantum 是開發者 gtsteffaniak 從 2023 年就開始的一支 fork，跟其他隨手 clone 的複本差在——它不是為了加一兩個功能，是把設定檔跟權限模型都重畫過。截至 2026 年 9 月主線走到 v1.3.x 穩定版、v2.0 進入 beta，GitHub 星數已經超過 8 千。
最有份量的改變在驗證。原版 File Browser 內建的密碼登入沒有 2FA、也沒有 SSO；Quantum 直接把 OIDC、LDAP、proxy header、JWT 全接上，OIDC 跟 LDAP 都支援 group-based access control。實務效果是它可以坐在 Authentik、Kanidm、Authelia 這類自架 IdP 後面，不用維護第二套帳號表——這件事在自架體系裡看起來平常，但對 File Browser 生態是打破十年壁壘的大事。
搜尋這件事也被翻新。原版找檔案要每次遍歷目錄，資料量一大就爆炸；Quantum 用 SQLite 存索引、背景維護 file metadata，含 3 萬檔案的目錄搜尋能壓在 500 ms 內完成。這對代管客戶檔案、log 目錄、靜態網站來源這類典型 VPS 工作負載差別很大。
Quantum 也把兩個過去被詬病的行為改掉：完全移除 shell command hook——這個功能雖然強，但過去在錯誤設定下等於給 web 端使用者一條 RCE 通道；設定檔改成單一 YAML，取代原版拆成命令列參數跟 database 兩處的混亂做法。
配置的實務門檻不高。單顆 binary 加一個 config.yaml，主要欄位是 server.port、server.database、sources（多來源掛載）跟 auth（認證方式）。一臺 512 MB RAM 的 VPS 跑 5 萬檔案索引沒問題，Docker 映像檔含 FFmpeg 縮圖預覽是 180 MB，換 bare binary 大約 25 MB。授權從原版的 Apache 2.0 延續下來，這對想商用整合的組織是加分。
Filestash 走的是完全另一條路線
Filestash 常被拿來跟 Quantum 一起討論，但兩者定位差別大。Quantum 是「自己管檔案的 web UI」，Filestash 是「連到既有儲存的閘道」——本身不存資料，透過 SFTP、S3、WebDAV、FTP、Backblaze B2、MinIO、Git、Dropbox、Google Drive 等 30 幾種後端存取遠端檔案。
這條分野會影響部署決策。組織已經有一組跑 SFTP 的檔案伺服器、或是把資料放在 S3-compatible 物件儲存上，Filestash 的 stateless 特性是強項——中間任何一顆容器掛了、資料完全不受影響；重新開一顆就繼續跑。反過來，組織要在單臺 VPS 上把本地磁碟當成主要儲存暴露給 web，Filestash 反而多繞一層 SFTP 沒必要。
Filestash 2026 年最大的爭議在商業模式。SAML、OIDC、LDAP、自訂品牌這些企業功能在 8 月起被劃到付費自架版（每月 50 美元起）。這件事在 self-hosted 社群裡引起反彈——付費本身不是問題，但把 OIDC 這種基礎驗證機制當付費點會讓「自架」的定義變得曖昧。免費版走 AGPL v3、上限 3 個使用者，適合家用或個人測試。
想在正式環境用 Filestash 又不付費，唯一乾淨的做法是把它放在自架 SSO gateway 後面（例如 oauth2-proxy、Authelia forward auth），讓 Filestash 自己不做認證。這個組合在技術上可行，但需要多寫一層 Nginx/Caddy 反向代理設定；對比 Quantum 直接內建 OIDC，維護成本明顯高一截。
從 File Browser 搬過去的兩條路
上線一段時間、資料量不大（幾千個檔案內）的部署，直接停止舊 container、把 /srv/filebrowser 底下的資料指到 Quantum 就能重新啟動。使用者帳號跟 rules 需要手動重建，因為兩者 database schema 不同。Quantum 官方文件有一個 import-legacy 子指令能吃原版的 database.db，但複雜規則建議手工檢視轉換結果。
有超過幾萬檔案跟複雜分享規則的部署，遷移路徑不能急。可行做法是先在測試 VPS 上把 Quantum 跑起來、把 OIDC 接上 IdP、把 rules 手動翻譯成新的 access 區塊，然後用 rsync 把資料複製過去做壓力測試；確定行為一致再切 DNS。
要避免的錯誤是繼續留在原版 File Browser 上假裝沒事。archived repo 意味著未來 Go runtime 更新、依賴 CVE、TLS 需求變化都不會有人回應。已經知道有已公開的權限繞過問題還繼續跑，等同於給攻擊者一個 free upgrade 的時間視窗。
選型的具體建議
需要 web UI 直接管理 VPS 上本地磁碟的檔案，選 FileBrowser Quantum；資料已經在 SFTP/S3 上、想要一個 web front 做預覽跟分享，選 Filestash 並自架 SSO gateway；使用者數量已經超過幾百人、需要多人協作跟版本控制，跳到 Nextcloud 或 OpenCloud 才是對的方向。
不建議選的是「先湊合用」的分支。File Browser 的封存已經 confirm 這條老架構走到底了，任何複製舊碼的隨手 fork 都會遇到同樣的權限模型限制，除非那支 fork 敢像 Quantum 一樣把設定跟認證整片翻掉。
把自架檔案管理放在自己控制的機器上
檔案管理服務因為要處理實體檔案 I/O，對磁碟延遲、網路穩定度、備份還原速度特別敏感。NCSE Network 提供臺灣本地的高效能 VPS（Intel Gold CPU、NVMe SSD、是方電訊機房），適合部署 FileBrowser Quantum、Filestash 這類需要低延遲存取本地儲存跟穩定電力的自架服務。想把公司或團隊的檔案管理從 SaaS 搬回可控環境、或評估自架 Web 檔案管理器的資源規劃，可以直接聯絡 NCSE Network 討論方案。
