Wenn ihr den Ordner mit den heruntergeladenen Dateien fünfmal am Tag vom Handy aus öffnet, liegt das Problem nicht am Server. Es liegt daran, dass dieser Ordner in einem Browser-Tab lebt, und ein Browser-Tab ist ein Ort, an dem man sich verliert.
Banyan ist ein selbst gehosteter Dateibrowser, der als ein einziges Go-Binary ausgeliefert wird: eine Datei, kein Docker, keine Datenbank. Dasselbe Binary liefert die Weboberfläche im LAN aus, und von derselben Seite lässt sich auch eine Android-APK herunterladen. Ein Hinweis, der mehr Zeit kostet als alle anderen zusammen: die APK gibt es nur für arm64.
1. Was ihr braucht
- Einen Server im selben Netz wie das Handy: Raspberry Pi, Mini-PC, NAS, irgendeine Linux-Kiste.
- Das passende Paket:
banyan_linux_arm64_20261118.zipauf einem 64-Bit-Pi,banyan_linux_amd64_20261118.zipauf x86,banyan_linux_armv7_20261118.zipauf älteren Pis. - Die APK:
https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, rund 19 MB.
Projektseite: https://banyan.ikootoo.com/
Download: https://banyan.ikootoo.com/#download
Quellcode: https://github.com/nbmany-web/banyan (MIT)
2. Die APK ist keine zweite Sync-Engine
Das ist der Teil, den man vor der Installation verstehen sollte. Die APK lädt keine Dateien aufs Handy und hält sie nicht synchron: sie ist dieselbe Weboberfläche in einer Hülle, und die Vorschauen werden weiterhin auf dem Server gerendert. Das Handy bekommt fertige Miniaturbilder, deshalb öffnet sich ein 200-MB-PDF oder Video ohne vollständigen Transfer.
Wenn der Server nicht antwortet, antwortet die APK nicht. Wenn der Server aus ist, gibt es keine lokale Kopie. Das ist kein Mangel, sondern der Grund, warum das Binary 20 MB wiegt statt eine Sync-Warteschlange zu betreiben.
3. Prüft die ABI, bevor ihr herunterladet
adb shell getprop ro.product.cpu.abi -
arm64-v8a-> APK verwenden. -
armeabi-v7a-> nein. Installiert die APK nicht auf einem 32-Bit-Gerät, sondern nutzt denselben Server im Browser und legt die Seite auf den Homescreen.
Ohne adb geht es auch über den Umweg: installieren, App not installed lesen, zurück zum Browser. Ein Befehl spart euch diese Runde.
4. Server starten
unzip banyan_linux_arm64_20261118.zip ./banyan/banyan -headless Der Prozess gibt die Adresse aus, auf der er hört. Öffnet sie vom Handy im selben WLAN. Damit ihr ihn nicht von Hand startet, eine systemd-Unit:
[Unit] Description=Banyan file browser After=network-online.target [Service] ExecStart=/home/pi/banyan/banyan -headless Restart=always [Install] WantedBy=multi-user.target 5. APK installieren
- Datei aufs Handy bringen (Kabel,
scpoder direkt über den Handy-Browser). - Datei öffnen: Android fragt nach der Erlaubnis, aus dieser Quelle zu installieren. Das ist eine Erlaubnis pro App, keine globale Freigabe, und sie lässt sich danach zurücknehmen.
- Erscheint
App not installed, gibt es zwei Ursachen: falsche ABI (Punkt 3) oder ein bereits installiertes Paket mit anderer Signatur. Alte Version deinstallieren, neu versuchen.
6. Am PC geht es, am Handy nicht: immer dieselben zwei Ursachen
- Der Server lauscht nur auf
localhost. Dann geht es von der Maschine selbst und von sonst nichts. Bindet ihn an die LAN-Schnittstelle. - Das Handy ist im Gästenetz oder in einem SSID mit Client-Isolation. Viele Router blockieren Geräte-zu-Geräte-Verkehr im Gast-VLAN standardmäßig, und keine App kann das umgehen.
Schnelltest auf dem Server:
ss -lntp | grep 8688 Steht dort nur 127.0.0.1:8688, ist die Ursache gefunden.
7. Öffnet den Port nicht ins Internet
Die APK ist für zu Hause gedacht. Wenn ihr von außen hinein wollt, setzt einen Tunnel oder einen Reverse Proxy mit TLS davor, und veröffentlicht den Port nicht im Klartext. Das Admin-Panel ist nicht dafür gedacht, exponiert zu werden.
files.example.com { reverse_proxy 127.0.0.1:8688 } 8. Wann sich die APK wirklich lohnt
- Ihr öffnet denselben Ordner mehrmals täglich und wollt, dass er dort bleibt, wo ihr ihn verlassen habt.
- Ihr wollt ein Icon auf dem Homescreen, das nicht zwischen Tabs verschwindet.
- Ein Tablet dient als Küchen- oder Wohnzimmerbildschirm, und ihr wollt mit einem Tipp hinein.
Trifft nichts davon zu, ist die Weboberfläche dieselbe Oberfläche: ein Shortcut auf dem Homescreen reicht. Das ist kein Kompromiss, sondern die richtige Wahl.
Kurz zusammengefasst
Nur arm64, 19 MB, Installation mit Freigabe pro Quelle, Serveradresse von Hand eintragen, Port niemals ins Internet. Ist das Gerät 32 Bit, leistet der Browser dasselbe.
- Seite: https://banyan.ikootoo.com/
- Download: https://banyan.ikootoo.com/#download
- Code: https://github.com/nbmany-web/banyan (MIT)