Jeśli otwierasz folder Pobrane na telefonie pięć razy dziennie, problem nie jest w serwerze. Problem w tym, że ten folder mieszka w karcie przeglądarki: jeden gest i karta znika, odświeżenie gubi ostatnią pozycję, a pasek adresu zjada pół ekranu.

Banyan to self-hostowany file browser wydawany jako jeden binarny plik Go. Jeden plik, bez Dockera, bez bazy danych. Ten sam plik serwuje web UI w LAN i pozwala też pobrać APK na Androida z tej samej strony. Jest jednak jeden warunek, który zjada więcej czasu niż wszystko inne: APK jest tylko dla arm64.

1. Czego potrzebujesz

  • Serwer w tej samej sieci co telefon: Raspberry Pi, mini PC, NAS, dowolna maszyna z Linuksem.
  • Pakiet dla właściwej architektury: Pi 64-bit używa banyan_linux_arm64_20261118.zip, x86 — banyan_linux_amd64_20261118.zip, starsze Pi — banyan_linux_armv7_20261118.zip.
  • APK: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, około 19 MB.

Strona projektu: https://banyan.ikootoo.com/
Pobieranie: https://banyan.ikootoo.com/#download
Kod: https://github.com/nbmany-web/banyan (MIT)

2. APK to nie drugi silnik synchronizacji

Zrozum to przed instalacją — oszczędza sporo rozczarowań. APK nie ściąga plików na telefon i nie utrzymuje ich w synchronizacji; to dokładnie to samo web UI w obudowie, a podgląd plików nadal renderuje się na serwerze. Telefon dostaje gotowe miniatury, więc PDF o rozmiarze 200 MB albo film otwiera się bez przesyłania całości.

Gdy serwer nie odpowiada, APK też nie odpowiada. Serwer wyłączony — nie ma żadnej lokalnej kopii do obejrzenia. To nie wada, a właśnie powód, dla którego plik zostaje poniżej 20 MB i nie musi utrzymywać kolejki synchronizacji.

3. Sprawdź ABI przed pobraniem

adb shell getprop ro.product.cpu.abi 
  • arm64-v8a: APK zadziała.
  • armeabi-v7a: nie. Nie instaluj tego APK na urządzeniu 32-bit; użyj web UI z tego samego serwera i dodaj do ekranu głównego.

Jeśli nie chcesz dotykać adb, objazd daje tę samą odpowiedź: zainstaluj, zobacz App not installed, wróć do przeglądarki. Jedna linia oszczędza dokładnie tę rundę.

4. Najpierw uruchom serwer

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 

Proces wypisuje adres nasłuchu. Wklej go w telefonie w tej samej Wi-Fi. Jeśli nie chcesz uruchamiać ręcznie, użyj unitu systemd:

[Unit] Description=Banyan file browser After=network-online.target [Service] ExecStart=/home/pi/banyan/banyan -headless Restart=always [Install] WantedBy=multi-user.target 

5. Instalacja APK

  1. Przenieś plik na telefon: kabel, scp albo pobierz wprost w przeglądarce telefonu.
  2. Otwórz plik. Android poprosi o zgodę na instalację z tego źródła. To uprawnienie per aplikacja, nie globalny przełącznik, i można je później cofnąć.
  3. Jeśli pojawi się App not installed, powody są zwykle dwa: niezgodne ABI (punkt 3) albo istniejący pakiet z innym podpisem. Usuń starszą wersję i spróbuj ponownie.

6. „Na PC działa, na telefonie nie" — zawsze dwa powody

  • Serwer nasłuchuje tylko na localhost. Wtedy działa wyłącznie na tej maszynie, reszta urządzeń jest odrzucana. Zwiąż go z interfejsem LAN.
  • Telefon jest w sieci gości albo w SSID z włączoną izolacją klientów. Wiele routerów domyślnie blokuje komunikację między urządzeniami w gościnnym VLAN, a żadna aplikacja tego nie obejdzie.

Jedna linia na serwerze wystarczy:

ss -lntp | grep 8688 

Jeśli widać tylko 127.0.0.1:8688, sprawca znaleziony.

7. Nie wystawiaj portu do internetu

Ta aplikacja nie ma ekranu logowania i serwer też nie. To projekt, nie przeoczenie: bez kont, bez ACL, uprawnienia zostają systemowi operacyjnemu, a udostępnianie to linki z wygaśnięciem. Dlatego nie rób przekierowania portów na routerze. Jeśli potrzebujesz dostępu z zewnątrz, użyj VPN (WireGuard, Tailscale) albo reverse proxy z TLS i listą dozwolonych.

files.example.com { reverse_proxy 127.0.0.1:8688 } 

8. Kiedy APK ma sens

  • Ten sam folder otwierasz kilka razy dziennie i chcesz, żeby pamiętał miejsce, w którym skończyłeś.
  • Potrzebujesz ikony na ekranie głównym, która nie ginie wśród kart.
  • Tablet wisi w kuchni albo przy telewizorze i musi wchodzić jednym dotknięciem.

Jeśli żaden punkt nie pasuje, web UI to dokładnie to samo UI. „Dodaj do ekranu głównego" wystarczy. To nie kompromis, to właściwy wybór.

Podsumowanie

Tylko arm64, 19 MB, zgoda per źródło przy instalacji, adres serwera wpisywany ręcznie, port nigdy nie wystawiony na zewnątrz. Jeśli telefon jest 32-bit, przeglądarka zrobi to samo.