DEV Community

爱国者
爱国者

Posted on AI-assisted

Installera en self-hostad filbläddrare som Android-APK: bara 64-bitars, och det spelar roll

Om du öppnar mappen Nedladdningar på telefonen fem gånger om dagen sitter problemet inte i servern. Problemet är att mappen bor i en webbläsarflik: en gest och fliken är borta, omladdning glömmer senaste positionen, och adressfältet äter halva skärmen.

Banyan är en self-hostad filbläddrare som släpps som en enda Go-binär. En fil, ingen Docker, ingen databas. Samma binär serverar webbgränssnittet i LAN och ger dig också en Android-APK på samma sida. Men det finns ett villkor som slukar mer tid än allt annat: APK:n är bara för arm64.

1. Vad du behöver

  • En server i samma nät som telefonen: Raspberry Pi, mini-PC, NAS, vilken Linux-maskin som helst.
  • Rätt paket: Pi 64-bit använder banyan_linux_arm64_20261118.zip, x86 använder banyan_linux_amd64_20261118.zip, äldre Pi-modeller banyan_linux_armv7_20261118.zip.
  • APK:n: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, cirka 19 MB.

Projektsida: https://banyan.ikootoo.com/
Nedladdning: https://banyan.ikootoo.com/#download
Kod: https://github.com/nbmany-web/banyan (MIT)

2. APK:n är inte en andra synkmotor

Förstå det här innan du installerar, det sparar många felaktiga förväntningar. APK:n laddar inte ner filer till telefonen och håller dem inte synkade; det är samma webbgränssnitt i ett skal, och förhandsvisningar renderas fortfarande på servern. Telefonen får färdiga miniatyrer, så en PDF på 200 MB eller en video öppnas utan att hela filen överförs.

Svarar servern inte, svarar APK:n inte heller. Är servern avstängd finns ingen lokal kopia att titta på. Det är inte en brist, det är just därför binären håller sig under 20 MB och slipper köra en synkö.

3. Kontrollera ABI före nedladdning

adb shell getprop ro.product.cpu.abi
Enter fullscreen mode Exit fullscreen mode
  • arm64-v8a: APK:n fungerar.
  • armeabi-v7a: nej. Installera inte den här APK:n på en 32-bitars enhet; använd webbgränssnittet från samma server och lägg det på hemskärmen.

Vill du inte röra adb ger omvägen samma svar: installera, se App not installed, gå tillbaka till webbläsaren. Ett kommando sparar precis den rundan.

4. Starta servern först

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

Processen skriver ut lyssnaradressen. Klistra in den på telefonen i samma Wi-Fi. Vill du inte starta manuellt, använd en 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. Installera APK:n

  1. Flytta filen till telefonen: kabel, scp eller ladda ner direkt i telefonens webbläsare.
  2. Öppna filen. Android frågar om tillstånd att installera från den källan. Det är en behörighet per app, inte en global brytare, och går att återkalla senare.
  3. Visar det App not installed är orsaken oftast en av två: ABI stämmer inte (punkt 3), eller så finns redan ett paket med samma namn men annan signatur. Avinstallera den gamla och försök igen.

6. "Det funkar på datorn men inte på telefonen" har alltid två orsaker

  • Servern lyssnar bara på localhost. Då fungerar den bara på den maskinen och andra enheter avvisas. Bind till LAN-gränssnittet.
  • Telefonen är i gästnätet, eller i ett SSID med klientisolering påslaget. Många routrar blockerar som standard trafik mellan enheter i gäst-VLAN:t, och ingen app kommer runt det.

En rad räcker på servern:

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

Syns bara 127.0.0.1:8688 har du hittat boven.

7. Öppna inte porten mot internet

Den här appen har ingen inloggningssida, och servern har inte heller. Det är design, inte slarv: inga konton, ingen ACL, behörigheter ligger hos operativsystemet, och delning sker med länkar som löper ut. Så gör ingen portvidarebefordran i routern. Behöver du åtkomst utifrån, använd VPN (WireGuard, Tailscale) eller en TLS-reverseproxy med allowlist.

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

8. När APK:n är värd att installera

  • Du öppnar samma mapp flera gånger per dag och vill att den minns var du slutade.
  • Du vill ha en hemskärmsikon som inte försvinner bland flikar.
  • En surfplatta sitter i köket eller vid tv:n och ska öppnas med ett tryck.

Stämmer inget av det är webbgränssnittet exakt samma gränssnitt. "Lägg till på hemskärmen" räcker. Det är ingen kompromiss, det är rätt val.

Sammanfattning

Bara arm64, 19 MB, tillstånd per källa vid installation, serveradressen skrivs in manuellt, porten aldrig öppen utåt. Är telefonen 32-bitars gör webbläsaren samma jobb.

Top comments (0)