DEV Community

爱国者
爱国者

Posted on AI-assisted

Instalace self-hostovaného prohlížeče souborů jako Android APK: jen 64-bit a to je důležité

Jestli otevíráš složku Stažené v telefonu pětkrát denně, problém není v serveru. Problém je, že ta složka bydlí v panelu prohlížeče: jeden pohyb a panel zmizí, obnovení zapomene poslední pozici a adresní řádek sežere půl obrazovky.

Banyan je self-hostovaný prohlížeč souborů, který vychází jako jedna Go binárka. Jeden soubor, žádný Docker, žádná databáze. Stejná binárka obsluhuje webové rozhraní v LAN a na stejné stránce ti dá i Android APK. Jenže je tu jedna podmínka, která sežere víc času než všechno ostatní: APK je jen pro arm64.

1. Co potřebuješ

  • Server ve stejné síti jako telefon: Raspberry Pi, mini PC, NAS, jakýkoli Linux.
  • Balíček pro správnou architekturu: Pi 64-bit používá banyan_linux_arm64_20261118.zip, x86 banyan_linux_amd64_20261118.zip, starší Pi banyan_linux_armv7_20261118.zip.
  • APK: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, přibližně 19 MB.

Web projektu: https://banyan.ikootoo.com/
Stahování: https://banyan.ikootoo.com/#download
Kód: https://github.com/nbmany-web/banyan (MIT)

2. APK není druhý synchronizační engine

Pochop to před instalací, ušetří to spoustu marných očekávání. APK nestahuje soubory do telefonu a neudržuje je synchronizované; je to stejné webové rozhraní v obalu a náhledy se pořád renderují na serveru. Telefon dostává hotové náhledy, takže 200MB PDF nebo video se otevře bez přenosu celého souboru.

Když server neodpovídá, APK taky neodpovídá. Server vypnutý znamená žádnou lokální kopii. Není to vada, je to právě důvod, proč binárka zůstává pod 20 MB a nemusí provozovat frontu synchronizace.

3. Zkontroluj ABI před stažením

adb shell getprop ro.product.cpu.abi
Enter fullscreen mode Exit fullscreen mode
  • arm64-v8a: APK funguje.
  • armeabi-v7a: ne. Tohle APK na 32bitovém zařízení neinstaluj; použij webové rozhraní ze stejného serveru a přidej ho na plochu.

Když nechceš sahat na adb, objížďka dá stejnou odpověď: nainstaluj, uvidíš App not installed, vrať se do prohlížeče. Jeden příkaz ušetří přesně tuhle cestu.

4. Nejdřív spusť 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

Proces vypíše naslouchací adresu. Vlož ji do telefonu ve stejné Wi-Fi. Nebo použij 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. Instalace APK

  1. Přenes soubor do telefonu: kabel, scp, nebo stáhni přímo v prohlížeči telefonu.
  2. Otevři soubor. Android se zeptá, jestli povolíš instalaci z tohoto zdroje. Je to oprávnění pro jednu aplikaci, ne globální přepínač, a jde později vzít zpět.
  3. Pokud se objeví App not installed, důvody bývají dva: nesouhlasí ABI (bod 3), nebo už existuje balíček stejného jména s jiným podpisem. Odinstaluj starou verzi a zkus to znovu.

6. „Na PC to jde, na telefonu ne" má vždy dva důvody

  • Server poslouchá jen na localhost. Pak funguje jen na tom stroji a ostatní zařízení jsou odmítnuta. Naváž ho na LAN rozhraní.
  • Telefon je v hostitelské síti, nebo v SSID s izolací klientů. Spousta routerů standardně blokuje provoz mezi zařízeními v hostitelském VLAN a žádná aplikace to neobejde.

Jedna řádka na serveru stačí:

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

Když vidíš jen 127.0.0.1:8688, máš pachatele.

7. Neotevírej port do internetu

Tahle aplikace nemá přihlašovací stránku a server taky ne. Je to design, ne opomenutí: žádné účty, žádný ACL, oprávnění zůstávají operačnímu systému a sdílení jsou odkazy, které vyprší. Takže žádné přesměrování portů na routeru. Potřebuješ-li přístup zvenčí, použij VPN (WireGuard, Tailscale) nebo TLS reverzní proxy se seznamem povolených.

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

8. Kdy se APK vyplatí

  • Stejnou složku otevíráš několikrát denně a chceš, aby si pamatovala, kde jsi skončil.
  • Chceš ikonu na ploše, která se neztratí mezi panely.
  • Tablet visí v kuchyni nebo u televize a musí se otevřít jedním klepnutím.

Když neplatí nic z toho, webové rozhraní je přesně totéž rozhraní. „Přidat na plochu" stačí. Není to kompromis, je to správná volba.

Shrnutí

Jen arm64, 19 MB, oprávnění pro zdroj při instalaci, adresa serveru ručně, port nikdy otevřený ven. Když je telefon 32bitový, prohlížeč udělá stejnou práci.

Top comments (0)