自架檔案管理器比較:FileBrowser、Filestash 與 SFTPGo
比較 FileBrowser、Filestash、SFTPGo 與 Cloud Commander 的功能差異。深入分析權限控管、儲存後端與驗證機制,並提供安全部署建議,避免檔案系統曝露風險。
自架檔案管理器的用途與限制
自架檔案管理器是呈現 VPS(虛擬私有伺服器)既有目錄樹的網頁介面。登入後,您會看到 /srv/files 在磁碟上的實際內容,並可上傳、重新命名、下載檔案,或將連結提供給他人。檔案不會被複製到第二個系統,因此您在瀏覽器中放入的檔案,ls 一秒後就能顯示。
搜尋結果常會把它與其他用途的軟體混為一談。同步工具會在每台裝置上保留每個檔案的副本,這正是自架 Dropbox 替代方案的用途。物件儲存以 bucket 和 API 為核心,而不是以磁碟上的目錄為核心,因此執行 MinIO 提供 S3 相容物件儲存是在回答不同的問題。伺服器管理面板管理的是整台機器,而不是檔案;Cockpit 與 Webmin 比較就是這類工具。
當同事需要從伺服器取得一個 300 MB 的封存檔,或您想用手機修正設定檔中的錯字時,就適合使用檔案管理器。用途單純,所需工具也應保持簡單。
閱讀時請記住一項事實。這是具備檔案系統讀寫權限、並在某個連接埠上監聽的網頁應用程式。以下每個選擇,實際上都是在決定該程序能存取磁碟的範圍。
FileBrowser 已歸檔,安裝前請詳閱此說明
FileBrowser 是 filebrowser/filebrowser 專案,也是多數指南仍推薦的解決方案。其 README 開頭現已標註:
File Browser 已於 2026-09-01 歸檔。最後一個預定版本已經發布。未來將不再有任何版本更新、錯誤修復或安全性修復。
Apache 2.0 授權的程式碼仍可運作,但安全性修復已停止。對於此類軟體而言,這比其他軟體更為關鍵,因為該軟體的目的即是透過 HTTP 提供檔案系統的寫入存取權。
維護者已列出維持其運作的方式,無論您選擇何種工具,以下建議皆值得遵循:請勿將其直接暴露於網際網路,應將其置於執行 TLS (transport layer security) 終止並執行自身驗證機制的反向代理之後;保持指令執行功能(command runner)停用;並以非特權模式在容器中執行,僅掛載您打算提供存取的目錄。
該 README 中有一行內容比其餘部分更重要。其 Session 是獨立的 JWT (JSON web tokens),而非伺服器端的識別碼,因此無法撤銷。一旦 Session token 外洩,在過期前皆有效,且變更密碼亦無法使其失效。若您仍要使用 FileBrowser,前端的驗證層才是實際執行安全防護的關鍵。
FileBrowser Quantum:仍在持續開發的分支
目前的開發工作已移至分支 FileBrowser Quantum(gtsteffaniak/filebrowser)。它在 Docker Hub 上以 gtstef/filebrowser 映像發布,在 GitHub 的 registry 上則以 ghcr.io/gtsteffaniak/filebrowser 發布。它將設定改為使用單一 config.yaml,不再採用舊版混合命令列旗標與資料庫設定的方式。文件提供的快速試用方式如下:
docker run -d \
-v $(pwd):/srv \
-p 80:80 \
ghcr.io/gtsteffaniak/filebrowser:stable這會在 http://localhost 提供目前目錄的內容。自 2.0.0 版起,首次登入不再使用 admin / admin。除非在設定中將 adminPassword 設為 admin 以外的值,否則容器會產生隨機的 admin 密碼並記錄一次。請使用 docker logs 讀取該密碼,且首次登入時必須重設密碼。容器尚未完成這項重設前,請勿讓它從自己的電腦以外的地方連線。
若要長期執行,請使用 Compose,掛載資料目錄而不是單一資料庫檔案,並將連接埠繫結至 localhost:
services:
filebrowser:
image: gtstef/filebrowser:stable
user: "1000:1000"
volumes:
- /srv/files:/folder
- ./data:/home/filebrowser/data
ports:
- 127.0.0.1:8080:80
restart: unless-stopped設定檔位於 /home/filebrowser/data/config.yaml,資料庫位於 /home/filebrowser/data/database.sqlite。2.0.0 版變更了資料庫格式,並會執行一次性移轉。因此文件要求掛載目錄:掛載單一檔案時,移轉沒有位置寫入新檔案。config.yaml 中的路徑是容器內的路徑,因此設定中的來源會讀取 /folder,而不是 /srv/files。若弄反這兩者,檔案清單會是空的,但不會顯示錯誤,因為該目錄確實不存在。
專案發布 latest 和 stable,大小約 60 MB,內含 FFmpeg 與文件預覽功能;另發布僅含核心功能的 stable-slim,大小約 15 MB。這些數字是 2026 年 10 月安裝頁面上的資料。請固定使用你選定的 tag。latest 會在未通知的情況下變更,而檔案管理器在執行中的容器內變更設定格式,會造成難以排查的問題。
以這項用途而言,它是小型工具中功能最完整的一款。它可依 include 和 exclude 規則提供多個來源,因此單一執行個體就能以不同範圍公開 /srv/media 和 /srv/docs。分享連結可設定到期時間,也能設為匿名或限制特定使用者存取。驗證功能支援 OIDC(OpenID Connect)、LDAP(lightweight directory access protocol)、搭配 two factor 的密碼驗證,以及 proxy header 模式。使用 proxy 模式後,它就能置於 自架的 Authentik 伺服器所提供的 single sign on(SSO)之後,不必另外維護一份使用者清單。
Filestash:以單一介面存取現有儲存空間
Filestash 的定位不同。它是連接後端的前端介面,支援的後端很多,包括 FTP、SFTP(SSH 檔案傳輸協定)、S3、SMB、WebDAV、IPFS,以及約 20 種其他後端。當檔案不在執行介面的主機上時,Filestash 很適合這種情境。
mkdir -p /srv/filestash && cd /srv/filestash
curl -O https://downloads.filestash.app/latest/docker-compose.yml
docker compose up -d映像檔為 machines/filestash:latest。開啟 http://your_domain:8334,第一個畫面會要求設定管理員密碼。請立即設定,因為在完成設定前,任何找到該連接埠的人都能開啟管理主控台。
在建置系統前,先了解其身分模型。根據預設,Filestash 不會以一般方式維護使用者資料庫。認證資料會透過 cookie 儲存在瀏覽器中,並經過加密、驗證且設定為 HTTP only;除非使用分享功能,否則伺服器端不會保存任何資料。使用分享功能時,Filestash 會保存認證資料的持久加密版本。在這種預設設定中,「使用者」其實是儲存空間帳戶:身分存在後端,也就是 SFTP 帳戶或 S3 金鑰中,而不是 Filestash 中。這不是唯一的選項。開源儲存庫內附的 plg_authenticate_local 外掛可讓 Filestash 本身擔任身分提供者,並提供管理使用者的畫面。
這種設計簡潔,但需要付費。定價頁面將免費自架方案列為 AGPL v3(GNU Affero General Public License),最多支援 3 位使用者;SSO(SAML、OIDC 與 LDAP)及角色型存取控制則列在付費自架方案中,價格自每月 $50 起;以上資訊截至 2026 年 10 月。如果你的規劃是「免費讓 Filestash 位於公司 SSO 前方」,請先查看該頁面,再依此設計系統。
SFTPGo:兼具網頁介面的協定伺服器
SFTPGo 是此類軟體中功能最強大者,但常因錯誤的理由被推薦。它能透過 SFTP、HTTP/S、FTP/S 與 WebDAV 提供服務,後端支援本地檔案系統、加密本地檔案系統、S3 相容物件儲存、Google Cloud Storage、Azure Blob Storage 或其他 SFTP 伺服器。
官方提供二進位檔、Debian 與 Ubuntu 套件以及容器映像檔。目前的 APT 儲存庫來源與簽章金鑰可於 SFTPGo 文件的安裝頁面取得。使用容器部署是最快啟動的方式,請將 tag 替換為您需要的版本:
docker run --name some-sftpgo -p 8080:8080 -p 2022:2022 -d "drakkan/sftpgo:tag"SFTP 監聽 2022 埠,網頁介面則監聽 8080 埠。請務必將 /srv/sftpgo 掛載為 volume,否則當容器重建時,帳號與檔案將會消失,因為使用者家目錄預設位於 /srv/sftpgo/data/<username>。
此軟體包含兩個網頁介面,其差異常被多數教學忽略。WebAdmin 位於 /web/admin,用於管理用途:您可在此建立使用者、群組、虛擬資料夾與事件規則,並設定配額、頻寬限制及存取時間限制。WebClient 位於 /web/client,則是終端使用者的檢視介面,使用者可在此瀏覽檔案、變更個人憑證、設定雙重驗證及建立分享連結。
這些分享功能是本比較中最出色的。使用者可建立 HTTP/S 連結來分享檔案與資料夾,並能限制下載與上傳次數、設定分享密碼、限制來源 IP 位址,以及設定自動過期日期。
那麼為何要謹慎使用?因為其核心在於帳號模型與協定伺服器,而非單純的瀏覽體驗。當您需要為他人建立具備配額的真實帳號、需接收來自外部系統的 SFTP 或 FTPS 上傳,或是需要將同一個儲存桶掛載至多個使用者的家目錄時,請選擇 SFTPGo。虛擬資料夾功能可達成後者:將由本地磁碟、S3、GCS、Azure Blob、SFTP 或 HTTP 支援的資料夾掛載至多個帳號,並針對每個使用者在共享資料夾上設定獨立配額。若您僅是想透過 /srv/files 提供一個可瀏覽的頁面,這套系統顯得過於龐大。
還有兩點值得注意。社群版採用 AGPL-3.0 授權並附加額外條款,另有商業授權的企業版。開源版本內建 OIDC 登入功能,可將身分提供者(Identity Provider)的使用者對應至 SFTPGo 的管理員與使用者,適用於兩個網頁介面。您也可以透過 httpd 設定檔中的 enable_web_client 全域停用客戶端介面,或在特定使用者的拒絕協定清單中加入 HTTP,藉此針對個別使用者啟用或停用檔案管理功能。
Cloud Commander:雙窗格與主控台,適合個人使用
Cloud Commander 是採用 MIT 授權的 Node.js 雙窗格管理工具,內建編輯器與主控台。它可選用終端機,但預設停用且不會安裝:必須先安裝獨立的 gritty 套件(npm i gritty -g),並設定 --terminal 與 --terminal-path 選項後,終端機才會運作。使用 npm i cloudcmd -g 以全域方式安裝 Cloud Commander,或執行已發布的容器:
docker run -it --rm -v ~:/root -v /:/mnt/fs -w=/root -p 8000:8000 coderaiser/cloudcmd執行前請先閱讀該指令。-v /:/mnt/fs 會將主機的整個檔案系統掛載到容器中,而範例中的 ~/.cloudcmd.json 會啟用 "root": "/"、"auth": false 與 "console": true。這樣的組合表示,任何能連到 8000 埠的人,都能存取伺服器上的完整磁碟,並使用命令主控台。對筆記型電腦而言,這是合理的預設值;對 VPS 而言則不安全。
請縮小存取範圍。容器會讀取 /root/.cloudcmd.json。已發布的指令會透過掛載家目錄提供該檔案,因此保留設定檔掛載,移除其他掛載:
docker run -d --name cloudcmd \
-v ~/.cloudcmd.json:/root/.cloudcmd.json \
-v /srv/files:/srv/files \
-w=/srv/files \
-p 127.0.0.1:8000:8000 \
coderaiser/cloudcmd在該設定檔中,將 "root" 設為 /srv/files,將 "auth" 設為 true,並搭配 "username" 與 "password"(該檔案會將密碼儲存為雜湊值,而非明文),除非確實需要瀏覽器 shell 存取,否則將 "console" 設為 false。保留 "terminal" 的預設值 false,並基於相同理由略過 gritty 的安裝。命令列也提供對應選項,包括 --root、--auth、--username、--password 與 --prefix。
請正確認識它的用途。它只有一組認證資訊,沒有個別使用者範圍限制、配額或分享連結。這是個人使用的工具,因此請如上所述將它繫結至 localhost,並透過通道存取:
ssh -L 8000:127.0.0.1:8000 you@your-vps接著在自己的電腦上開啟 http://127.0.0.1:8000。檔案管理器不會直接公開,面向網際網路的只有您先前在 VPS 上 完成強化設定的 SSH daemon。
為什麼 Nextcloud 不適合這項特定工作
Nextcloud 是優秀的軟體,但它並非為此而生。它是一個協作平台:包含 PHP 應用程式、資料庫、背景工作、桌面同步客戶端以及應用程式商店。為了取得 /srv/files 的網頁檢視介面而執行它,對於這項小任務來說,涉及的組件過於繁雜,且存在明顯的屬性不符。Nextcloud 將檔案元數據儲存在資料庫資料表中,而非在每次請求時讀取目錄,因此透過 rsync 或 cron job 寫入的檔案,在掃描程序完成前,於介面中可能呈現隱形狀態,並伴隨 sudo -u www-data php occ files:scan --all。檔案管理器會在載入頁面時列出目錄內容,因此不會產生此類落差。
請將 Nextcloud 用於它擅長的領域:行事曆、聯絡人、同步,以及與預期使用桌面客戶端的使用者進行分享。在具備 Docker、TLS 與備份功能的 VPS 上部署 Nextcloud 一文涵蓋了該設定。若您已在執行 Nextcloud 且僅需檢視現有目錄,請啟用 External Storage 應用程式並就此打住。若部署第二個對同一磁碟擁有寫入權限的網頁應用程式,將會增加另一個需要修補安全漏洞的目標。
如何在不暴露整台伺服器的情況下執行服務
切勿將其指向 /。該處理程序可讀寫其使用者帳號能存取的所有內容,因此一旦工作階段權杖(session token)遭竊,攻擊者便能取得同等權限的檔案系統存取權。請僅提供單一目錄 /srv/files,並專門為此目的建立該目錄。
請以非 root 使用者身分執行,並僅掛載服務所需的目錄。在 Compose 中,這意味著使用 user: "1000:1000" 加上每個目錄一個綁定掛載(bind mount),並對其無需寫入的任何內容設定 :ro:
volumes:
- /srv/files:/folder
- /srv/media:/media:ro此變更通常會導致瀏覽功能正常,但上傳功能因 permission denied 而失敗,這是因為容器內的使用者 ID 在容器外並不擁有該目錄。請比較兩者:docker exec filebrowser id 會顯示容器內的使用者,ls -ln /srv/files 則顯示主機上的數值擁有者。請使用 sudo chown -R 1000:1000 /srv/files 修復此問題。這與 Docker 映像檔中的 PUID 與 PGID 所要解決的擁有權問題相同。
將發布的連接埠綁定至 localhost,即 127.0.0.1:8080:80 而非 8080:80。Docker 會在 ufw 之前寫入自己的 netfilter 規則,因此即使 ufw deny 8080 處於啟用狀態,直接發布的連接埠仍可從網際網路存取。請在前端放置反向代理以處理 TLS。若使用明文 HTTP,工作階段 Cookie 會在網路上以明文傳輸,而該 Cookie 等同於檔案系統的存取權。若您對 Compose 尚不熟悉,VPS 上的 Docker Compose 涵蓋了這些程式碼片段所假設的檔案配置。
當應用程式本身的驗證機制薄弱時,請增加一層驗證。對於單人使用的執行個體,在代理層設定 HTTP basic auth 即已足夠。若涉及多人使用,請使用 OIDC 或針對身分提供者(identity provider)進行 forward auth,以確保撤銷單一帳號時能同時撤銷所有存取權。
關閉額外功能。任何提供 shell、指令執行器或瀏覽器內終端機的檔案管理器,都等於向持有有效工作階段的任何人提供遠端程式碼執行(RCE)能力。FileBrowser 本身的建議是保持指令執行器停用,而 Cloud Commander 的範例設定檔則啟用了主控台。請根據需求主動決策,而非採用預設值。
最先發生什麼問題,以及你會看到的錯誤
listen tcp :80: bind: permission denied。 Linux 將 1024 以下的連接埠視為特權連接埠。繫結這類連接埠需要 root、CAP_NET_BIND_SERVICE capability,或降低的 net.ipv4.ip_unprivileged_port_start。FileBrowser Quantum 的文件設定使用連接埠 80。在標準的 rootful Docker engine 中,容器通常仍會取得該 capability,因此可以正常運作。若由非特權使用者直接在主機上執行二進位檔,便會失敗;在 rootless Docker 或較嚴格的 capability 設定檔下,也可能失敗。請在 config.yaml 中將連接埠設為高於 1024 的值,並讓 proxy 使用 443。
瀏覽正常,但上傳失敗。 列出目錄需要 r-x,寫入目錄則需要 w。網頁介面只會顯示一般錯誤,因此應先檢查檔案系統,而不是先查看應用程式日誌。
413 Request Entity Too Large。 這個錯誤通常來自檔案管理器前方的元件,而不是檔案管理器本身。請先檢查 nginx。預設的 client_max_body_size 為 1 MB,因此較大的上傳會在 proxy 端被拒絕,應用程式根本收不到請求。請在 server 區塊中設定 client_max_body_size 4096m;,或設定 0 以停用檢查。若網域是透過 Cloudflare proxy,請求超過該 zone 的最大上傳大小時,Cloudflare 也會回傳相同的 413。根據其文件,截至 2026 年 10 月,Free 和 Pro 方案的上限為 100 MB。在這種情況下,提高 nginx 限制沒有幫助,因此大型上傳需要使用不經過 Cloudflare proxy 的路徑。
上傳的檔案具有錯誤的群組。 新檔案會由執行程序的使用者擁有,不論所在目錄的設定為何,因此會導致第二個服務無法讀取同一個目錄樹。請為兩個服務指定共用群組,並使用 sudo chmod g+s /srv/files 在目錄上設定 setgid bit,讓新檔案繼承目錄的群組。
直接使用連接埠時一切正常,但經過 proxy 後失敗。 應用程式若部署在子路徑下,必須取得前綴設定,才能正確建立連結。Cloud Commander 提供 --prefix。若應用程式沒有這類選項,請為它配置專用子網域,並將根路徑 proxy 到該應用程式。
應該執行哪一種自架檔案管理器?
- 只有一台 VPS、一或兩個目錄,需要可設定到期時間的分享連結,之後可能再導入 SSO:FileBrowser Quantum。
- 檔案位於其他位置,例如 S3 bucket、SFTP 主機或透過 SMB 連線的 NAS,而你希望用單一 Web 介面查看這些檔案:Filestash,但須遵守免費方案的限制。
- 其他人需要帳號、配額,以及透過 SFTP 或 FTPS 上傳檔案:SFTPGo。此時應將 Web client 視為實用的附加功能,而不是選用它的主要原因。
- 需要具備編輯器與主控台的個人工具,透過 SSH tunnel 存取,且永不公開發布:Cloud Commander。
- 已在執行 Nextcloud,且有現成目錄需要公開:使用 External Storage app,完全不安裝新軟體。
無論選擇哪一套,部署方式都比軟體本身更重要。使用單一目錄、非 root 使用者、繫結至 localhost 的連接埠,並在前方設定驗證。以這種方式設定的檔案管理器只是便利工具。若將相同軟體指向 /,並使用共用密碼,它就會變成具備友善介面的遠端 shell。
FAQ
FileBrowser 在 2026 年執行仍然安全嗎?
上游 filebrowser/filebrowser README 表示,File Browser 已於 2026-09-01 封存,不再提供後續版本、錯誤修正或安全性修正。程式目前仍可執行,但具備檔案系統寫入權限且未修補的軟體,其風險會隨時間增加。若要繼續使用,請遵循專案本身的建議:不要直接暴露於網際網路,使用負責 TLS 與獨立驗證的反向代理,維持停用 command runner,並在非特權容器中只掛載提供服務的目錄。另請注意,其工作階段使用自包含的 JWT,而不是伺服器端識別碼,因此無法撤銷;變更密碼也不會使已簽發的 token 失效。若要重新安裝,請改用 FileBrowser Quantum fork,也就是以 gtstef/filebrowser 映像檔發布的版本;該專案仍在持續開發。
自架檔案管理器可以使用現有的 SSO 嗎?
FileBrowser Quantum 支援 OIDC、LDAP 及 proxy header 模式,因此可置於現有的身分識別提供者後方,不必維護第二份使用者清單。SFTPGo 的 OpenID Connect 整合包含在開放原始碼版本中,可將身分識別提供者的使用者對應到 SFTPGo 的管理員與使用者,適用於 WebAdmin 與 WebClient 介面。Filestash 則需特別注意:截至 2026 年 10 月,其定價頁面將 SSO(SAML、OIDC 與 LDAP)列在每月 $50 起的付費自架層級;免費層級標示為 AGPL v3,最多支援 3 位使用者。若應用程式完全不支援 SSO,替代方案是在反向代理啟用 forward authentication。這能保護登入頁面,但不會改變應用程式內部的權限設定。
哪些工具提供可到期的分享連結?
SFTPGo 提供最完整的實作。使用者可從 WebClient 建立 HTTP/S 連結,限制下載與上傳次數、設定密碼、依來源 IP 位址限制存取,以及設定自動到期日期。FileBrowser Quantum 支援具有到期時間的分享連結,可選擇匿名存取或限制特定使用者存取,並可針對每個分享設定檢視、編輯與上傳權限。Filestash 也提供分享功能;這是唯一一種伺服器會持續保留加密儲存憑證副本的情況,因為瀏覽器工作階段結束後,連結仍必須能夠運作。Cloud Commander 完全不提供分享連結。
如果只有我一位使用者,讓檔案管理器指向 / 安全嗎?
不安全,風險並不在於是否信任自己。該程序會持有其使用者帳號可存取之所有內容的讀寫權限。因此,任何進入該工作階段的途徑、遭竊的 cookie、上傳處理常式中的未修補錯誤或重複使用的密碼,都可能導致存取 /etc、SSH keys 以及各服務的資料目錄。請改為將掛載範圍限制在單一目錄:使用 /srv/files,而不是 /。Cloud Commander 受到的影響最嚴重,因為其發布的 Docker command 會將主機根目錄掛載至 /mnt/fs,而範例設定會以 "auth": false 設定 "root": "/"。在讓該容器監聽 localhost 以外的任何位置前,請先修改這兩項設定。