DEV Community

爱国者
爱国者

Posted on AI-assisted

Een self-hosted file browser installeren als Android-APK: alleen 64-bit, en dat maakt uit

Als je vijf keer per dag de map Downloads op je telefoon opent, zit het probleem niet in de server. Het probleem is dat die map in een browsertab woont: één veeg en de tab is weg, verversen vergeet de laatste positie, en de adresbalk vreet een halve scherm.

Banyan is een self-hosted file browser die als één Go-binary wordt uitgegeven. Eén bestand, geen Docker, geen database. Diezelfde binary serveert de web-UI in je LAN en geeft je op dezelfde pagina ook een Android-APK. Er is alleen één voorwaarde die meer tijd kost dan al het andere: de APK is alleen arm64.

1. Wat je nodig hebt

  • Een server in hetzelfde netwerk als je telefoon: Raspberry Pi, mini-PC, NAS, elke Linux-machine.
  • Het juiste pakket: Pi 64-bit gebruikt banyan_linux_arm64_20261118.zip, x86 gebruikt banyan_linux_amd64_20261118.zip, oudere Pi's banyan_linux_armv7_20261118.zip.
  • De APK: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, ongeveer 19 MB.

Projectsite: https://banyan.ikootoo.com/
Download: https://banyan.ikootoo.com/#download
Code: https://github.com/nbmany-web/banyan (MIT)

2. De APK is geen tweede sync-engine

Begrijp dit vóór je installeert, want het scheelt veel teleurstelling. De APK downloadt geen bestanden naar je telefoon en houdt ze niet gesynchroniseerd; het is dezelfde web-UI in een shell, en previews worden nog steeds op de server gerenderd. De telefoon krijgt kant-en-klare thumbnails, dus een PDF van 200 MB of een video opent zonder volledige overdracht.

Reageert de server niet, dan reageert de APK ook niet. Server uit betekent geen lokale kopie om te bekijken. Dat is geen gebrek, dat is precies waarom de binary onder de 20 MB blijft en geen synchronisatiewachtrij hoeft te draaien.

3. Controleer de ABI vóór het downloaden

adb shell getprop ro.product.cpu.abi
Enter fullscreen mode Exit fullscreen mode
  • arm64-v8a: de APK werkt.
  • armeabi-v7a: niet. Installeer deze APK niet op een 32-bit toestel; gebruik de web-UI van dezelfde server en zet die op je beginscherm.

Wil je adb niet aanraken, dan geeft de omweg hetzelfde antwoord: installeren, App not installed zien, terug naar de browser. Eén commando bespaart precies die ronde.

4. Start eerst de server

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
Enter fullscreen mode Exit fullscreen mode

Het proces print het luisteradres. Plak dat adres op je telefoon in dezelfde Wi-Fi. Niet handmatig willen starten? Gebruik een 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
Enter fullscreen mode Exit fullscreen mode

5. De APK installeren

  1. Zet het bestand op je telefoon: kabel, scp, of direct downloaden in de browser op je telefoon.
  2. Open het bestand. Android vraagt toestemming om vanaf die bron te installeren. Dat is een machtiging per app, geen globale schakelaar, en later weer in te trekken.
  3. Zie je App not installed, dan zijn er meestal twee oorzaken: ABI komt niet overeen (punt 3), of er staat al een pakket met een andere signature. Verwijder de oude versie en probeer opnieuw.

6. "Op de pc werkt het, op de telefoon niet" heeft altijd twee oorzaken

  • De server luistert alleen op localhost. Dan werkt het alleen op die machine zelf en worden andere apparaten geweigerd. Bind aan de LAN-interface.
  • De telefoon zit in een gastnetwerk, of in een SSID met client isolation aan. Veel routers blokkeren standaard verkeer tussen apparaten in het gast-VLAN, en geen enkele app komt daar langs.

Eén regel op de server volstaat:

ss -lntp | grep 8688
Enter fullscreen mode Exit fullscreen mode

Zie je alleen 127.0.0.1:8688, dan heb je de dader.

7. Zet de poort niet open naar internet

Deze app heeft geen inlogscherm, de server ook niet. Dat is ontwerp, geen vergetelheid: geen accounts, geen ACL's, rechten blijven bij het OS, en delen gebeurt met links die verlopen. Dus geen port forwarding op je router. Wil je van buitenaf werken, gebruik VPN (WireGuard, Tailscale), of een TLS-reverse-proxy met allowlist.

files.example.com {
    reverse_proxy 127.0.0.1:8688
}
Enter fullscreen mode Exit fullscreen mode

8. Wanneer de APK de moeite waard is

  • Je opent dezelfde map meerdere keren per dag en wilt dat hij de laatste plek onthoudt.
  • Je wilt een icoon op je beginscherm dat niet tussen tabs verdwijnt.
  • Een tablet hangt in de keuken of naast de tv en moet met één tik open.

Past geen van drie, dan is de web-UI exact dezelfde UI. "Toevoegen aan beginscherm" is genoeg. Dat is geen concessie, dat is de juiste keuze.

Samenvatting

Alleen arm64, 19 MB, toestemming per bron bij installatie, serveradres handmatig invullen, poort nooit naar buiten. Is je telefoon 32-bit, dan doet de browser hetzelfde werk.

Top comments (0)