DEV Community

爱国者
爱国者

Posted on AI-assisted

Cài file browser tự host dưới dạng APK Android: chỉ 64-bit, và đó là điều quan trọng

Nếu bạn mở thư mục Download trên điện thoại năm lần một ngày thì vấn đề không nằm ở server. Vấn đề là thư mục đó sống trong một tab trình duyệt: một cử chỉ là tab đóng, refresh là quên vị trí cũ, còn thanh địa chỉ ăn mất nửa màn hình.

Banyan là một file browser tự host, phát hành dưới dạng một binary Go duy nhất. Một file, không Docker, không database. Cùng binary đó phục vụ giao diện web trong LAN và cũng cho bạn tải APK Android ngay trên cùng trang. Nhưng có một điều kiện ngốn thời gian hơn mọi thứ khác: APK chỉ hỗ trợ arm64.

1. Bạn cần gì

  • Một server cùng mạng với điện thoại: Raspberry Pi, mini PC, NAS, bất kỳ máy Linux nào.
  • Gói đúng kiến trúc: Pi 64-bit dùng banyan_linux_arm64_20261118.zip, x86 dùng banyan_linux_amd64_20261118.zip, Pi đời cũ dùng banyan_linux_armv7_20261118.zip.
  • APK: https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk, khoảng 19 MB.

Trang dự án: https://banyan.ikootoo.com/
Tải về: https://banyan.ikootoo.com/#download
Mã nguồn: https://github.com/nbmany-web/banyan (MIT)

2. APK không phải engine đồng bộ thứ hai

Hiểu điều này trước khi cài sẽ tiết kiệm rất nhiều kỳ vọng hụt. APK không tải file về máy rồi giữ đồng bộ; APK là đúng giao diện web đó được bọc trong một shell, và phần xem trước vẫn được render ở server. Điện thoại chỉ nhận thumbnail đã tạo sẵn, nên một PDF 200 MB hay một video vẫn mở được mà không phải truyền cả file.

Server không phản hồi thì APK cũng không phản hồi. Server tắt thì không có bản sao cục bộ nào trên máy. Đó không phải lỗi, mà chính là lý do binary vẫn dưới 20 MB và không phải vận hành hàng đợi đồng bộ.

3. Kiểm tra ABI trước khi tải

adb shell getprop ro.product.cpu.abi
Enter fullscreen mode Exit fullscreen mode
  • arm64-v8a: cài được.
  • armeabi-v7a: không. Đừng cài APK này trên máy 32-bit; dùng giao diện web của cùng server đó và thêm vào màn hình chính.

Nếu không muốn động vào adb, đường vòng vẫn cho cùng câu trả lời: cài, thấy App not installed, rồi quay lại trình duyệt. Một dòng lệnh tiết kiệm đúng vòng đó.

4. Chạy server trước

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

Tiến trình sẽ in địa chỉ lắng nghe. Dán địa chỉ đó vào điện thoại trong cùng Wi-Fi. Không muốn chạy tay thì dùng 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. Cài APK

  1. Chuyển file sang điện thoại: cáp, scp, hoặc tải trực tiếp bằng trình duyệt trên máy.
  2. Mở file. Android sẽ hỏi có cho phép cài từ nguồn đó không. Đó là quyền theo từng ứng dụng, không phải công tắc toàn cục, và có thể thu hồi sau.
  3. Nếu hiện App not installed, thường chỉ hai nguyên nhân: ABI không khớp (mục 3), hoặc đã có gói cùng tên nhưng khác chữ ký. Gỡ bản cũ rồi thử lại.

6. "Trên PC mở được, trên điện thoại không" luôn chỉ hai nguyên nhân

  • Server chỉ bind vào localhost. Khi đó chỉ chính máy đó dùng được, thiết bị khác bị từ chối. Hãy bind vào giao diện LAN.
  • Điện thoại ở mạng khách, hoặc SSID bật client isolation. Nhiều router mặc định chặn thiết bị trong VLAN khách nói chuyện với nhau, và không ứng dụng nào vượt qua được.

Một dòng để kiểm chứng trên server:

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

Chỉ thấy 127.0.0.1:8688 là tìm ra thủ phạm.

7. Đừng mở port ra internet

Ứng dụng này không có trang đăng nhập, server cũng không. Đó là thiết kế, không phải sơ suất: không tài khoản, không ACL, quyền do OS quản, còn chia sẻ là link có hạn. Vì vậy đừng port forwarding trên router. Nếu cần dùng từ ngoài, hãy dùng VPN (WireGuard, Tailscale), hoặc reverse proxy TLS kèm danh sách cho phép.

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

8. Khi nào APK mới đáng cài

  • Cùng một thư mục bạn mở nhiều lần trong ngày và muốn nó nhớ chỗ dừng.
  • Bạn cần một icon màn hình chính không bị chôn giữa các tab.
  • Máy tính bảng gắn ở bếp hoặc cạnh TV, phải vào bằng một lần chạm.

Không thoả cả ba thì giao diện web chính là giao diện đó. "Thêm vào màn hình chính" là đủ. Đó không phải thoả hiệp, mà là lựa chọn đúng.

Tóm lại

Chỉ arm64, 19 MB, cấp quyền theo từng nguồn khi cài, tự nhập địa chỉ server, port tuyệt đối không mở ra ngoài. Nếu máy bạn 32-bit, trình duyệt làm được việc tương tự.

Top comments (0)