如果你一天要打开手机上那个下载文件夹五次,问题不在服务器,而在那个文件夹住在浏览器标签页里:手势一划标签就没了,刷新就忘了上次看到哪,地址栏还吃掉半屏。
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 弄到手机上:数据线、
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 位的话,浏览器能做同样的事。


