如果你一天要打開手機的下載資料夾五次,問題不在伺服器。問題在於那個資料夾住在瀏覽器分頁裡:手勢一滑就分頁被關、重新整理就忘了上次的位置,而網址列又吃掉半個螢幕。
Banyan 是一個以 Go 單一執行檔 形式發佈的自架檔案瀏覽器。一個檔案、不用 Docker、不用資料庫。同一個執行檔在區域網路提供網頁介面,同一頁也讓你下載 Android APK。不過有個細節比想像中更會吃掉你的時間:APK 只支援 arm64。
一、需要什麼
- 一台和手機在同一個網段的伺服器:樹莓派、小主機、NAS,任何 Linux 都行。
- 對應機型的套件:64 位元樹莓派用
banyan_linux_arm64_20261118.zip,x86 用banyan_linux_amd64_20261118.zip,舊款樹莓派用banyan_linux_armv7_20261118.zip。 - APK:
https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk,約 19 MB。
專案網站:https://banyan.ikootoo.com/
下載頁:https://banyan.ikootoo.com/#download
原始碼:https://github.com/nbmany-web/banyan(MIT)
二、APK 不是第二套同步引擎
安裝之前請先搞清楚這點,可以省下很多期待落空的時間。APK 不會把檔案下載到手機並維持同步狀態;它是同一個網頁介面包進外殼,預覽檔案仍然在伺服器端算圖。手機只接收已經產生的縮圖,所以 200 MB 的 PDF 或一支影片不需要整檔傳輸就能打開。
伺服器沒有回應時,APK 也不會回應。伺服器關掉,手機裡沒有任何本地副本可看。這不是缺陷,而是它能在 20 MB 以內、不必營運同步佇列的原因。
三、下載前先查 ABI
adb shell getprop ro.product.cpu.abi -
arm64-v8a:可以裝。 -
armeabi-v7a:不行。不要在 32 位元手機上安裝這個 APK,改用同一台伺服器的網頁介面,並把「加到主畫面」。
如果你不想碰 adb,先裝、看到 App not installed、再回頭開瀏覽器,也會得到同樣的答案。只是一行指令能省掉那趟來回。
四、先把伺服器跑起來
mkdir -p ~/banyan && cd ~/banyan curl -LO https://banyan.ikootoo.com/release/banyan_linux_arm64_20261118.zip unzip banyan_linux_arm64_20261118.zip # 得到 banyan/banyan 與 config.json chmod +x banyan/banyan ./banyan/banyan -headless 它會在啟動時印出監聽位址。把那個位址貼進同一 Wi-Fi 下的手機就行。不想手動啟動可以改用 systemd:
[Unit] Description=Banyan file browser After=network-online.target [Service] ExecStart=/home/pi/banyan/banyan -headless Restart=always [Install] WantedBy=multi-user.target 五、安裝 APK
- 把 APK 傳到手機:USB、
scp,或直接在手機瀏覽器下載。 - 打開檔案。Android 會要求你允許「這個來源」安裝應用程式。那是逐應用授權,不是全域開關,之後可以收回。
- 若出現
App not installed,原因通常只有兩個:ABI 不符(回第三節),或同一個套件已存在但簽章不同。先把舊的移除再試。
六、「電腦打得開、手機打不開」永遠是這兩個原因
- 伺服器只綁在
localhost。 那它就只有自己那台機器能用,其他裝置一律被拒。要綁到區域網路的介面上。 - 手機在訪客網路,或連到啟用了用戶端隔離的 SSID。 很多路由器預設就擋掉訪客 VLAN 內的裝置互通,任何 App 都繞不過。
伺服器上一行就能驗:
ss -lntp | grep 8688 只看到 127.0.0.1:8688,兇手就找到了。
七、不要把埠號開到公網
這個應用沒有登入畫面,伺服器也沒有。這是設計,不是疏漏:沒有帳號、沒有 ACL,權限交給作業系統,分享則是會過期的連結。所以不要去路由器上做埠映射。真的要從外面用,就上 VPN(WireGuard、Tailscale),或 TLS 反向代理加白名單。
files.example.com { reverse_proxy 127.0.0.1:8688 } 八、什麼情況下 APK 才值得裝
- 同一個資料夾你一天要開好幾次,而且希望它記住上次停在哪。
- 你需要一個不會被分頁埋掉的主畫面圖示。
- 平板要固定在廚房或電視旁,一次點擊就進去。
三項都不成立的話,網頁介面就是同一個介面,把「加到主畫面」就夠了。那不是妥協,是正確選擇。
小結
arm64 限定、19 MB、逐應用授權、手動填入伺服器位址、埠號絕對不對外。手機若是 32 位元,瀏覽器做得到同樣的事。


