DEV Community

爱国者
爱国者

Posted on AI-assisted

Memasang file browser self-hosted sebagai APK Android: hanya 64-bit, dan itu penting

Kalau kamu membuka folder Download di HP lima kali sehari, masalahnya bukan di server. Masalahnya folder itu tinggal di dalam tab browser: satu gestur tab tertutup, refresh lupa posisi terakhir, dan address bar memakan setengah layar.

Banyan adalah file browser self-hosted yang dikirim sebagai satu binary Go. Satu file, tanpa Docker, tanpa database. Binary yang sama menyajikan UI web di LAN dan juga memberi kamu APK Android di halaman yang sama. Tapi ada satu syarat yang lebih banyak menghabiskan waktu daripada yang lain: APK-nya hanya arm64.

1. Yang kamu butuhkan

  • Satu server di jaringan yang sama dengan HP: Raspberry Pi, mini PC, NAS, Linux apa pun.
  • Paket sesuai perangkat: Pi 64-bit pakai banyan_linux_arm64_20261118.zip, x86 pakai banyan_linux_amd64_20261118.zip, Pi lama pakai banyan_linux_armv7_20261118.zip.
  • APK: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, sekitar 19 MB.

Situs: https://banyan.ikootoo.com/
Unduhan: https://banyan.ikootoo.com/#download
Kode: https://github.com/nbmany-web/banyan (MIT)

2. APK bukan mesin sinkronisasi kedua

Pahami ini sebelum memasang, karena menghemat banyak harapan yang tidak terwujud. APK tidak mengunduh file ke HP lalu menjaganya tetap sinkron; APK adalah UI web yang sama dibungkus shell, dan pratinjau file tetap di-render di server. HP hanya menerima thumbnail yang sudah jadi, jadi PDF 200 MB atau video terbuka tanpa transfer penuh.

Kalau server tidak merespons, APK juga tidak merespons. Server mati, tidak ada salinan lokal di HP. Itu bukan cacat, itu alasan binary-nya tetap di bawah 20 MB tanpa harus mengurus antrean sinkronisasi.

3. Cek ABI sebelum mengunduh

adb shell getprop ro.product.cpu.abi
Enter fullscreen mode Exit fullscreen mode
  • arm64-v8a: APK bisa dipakai.
  • armeabi-v7a: tidak. Jangan pasang APK ini di perangkat 32-bit; pakai UI web dari server yang sama dan taruh di layar utama.

Kalau tidak mau menyentuh adb, jalur memutar tetap memberi jawaban sama: pasang, lihat App not installed, kembali ke browser. Satu perintah menghemat perjalanan itu.

4. Jalankan server dulu

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

Proses mencetak alamat listen-nya. Tempel alamat itu di HP pada Wi-Fi yang sama. Kalau tidak mau menjalankan manual, pakai unit systemd:

[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. Memasang APK

  1. Pindahkan file ke HP: kabel, scp, atau unduh langsung dari browser HP.
  2. Buka file. Android akan meminta izin memasang dari sumber itu. Itu izin per-aplikasi, bukan saklar global, dan bisa dicabut lagi.
  3. Kalau muncul App not installed, penyebabnya biasanya dua: ABI tidak cocok (bagian 3), atau sudah ada paket dengan tanda tangan berbeda. Hapus versi lama lalu coba lagi.

6. "Di PC terbuka, di HP tidak" selalu dua penyebab ini

  • Server hanya bind ke localhost. Maka hanya mesin itu yang bisa, perangkat lain ditolak. Bind ke antarmuka LAN.
  • HP ada di jaringan tamu, atau SSID dengan client isolation aktif. Banyak router memblokir komunikasi antar-perangkat di VLAN tamu secara default, dan tidak ada aplikasi yang bisa melewatinya.

Satu baris untuk memastikan di server:

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

Kalau hanya terlihat 127.0.0.1:8688, pelakunya ketemu.

7. Jangan buka port ke internet

Aplikasi ini tidak punya halaman login, dan servernya juga tidak. Itu desain, bukan kelalaian: tanpa akun, tanpa ACL, izin diserahkan ke OS, dan berbagi berupa tautan yang kedaluwarsa. Jadi jangan lakukan port forwarding di router. Kalau perlu akses dari luar, pakai VPN (WireGuard, Tailscale), atau reverse proxy TLS plus daftar izin.

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

8. Kapan APK layak dipasang

  • Folder yang sama kamu buka berkali-kali sehari, dan ingin posisi terakhir diingat.
  • Butuh ikon layar utama yang tidak terkubur di antara tab.
  • Tablet dipasang di dapur atau dekat TV, dan harus masuk dengan satu ketukan.

Kalau ketiganya tidak berlaku, UI web adalah UI yang sama. "Tambahkan ke layar utama" sudah cukup. Itu bukan kompromi, itu pilihan yang benar.

Ringkasan

Khusus arm64, 19 MB, izin per-sumber saat memasang, alamat server diisi manual, port tidak pernah terbuka ke luar. Kalau HP-mu 32-bit, browser bisa melakukan hal yang sama.

Top comments (0)