Quase todo navegador de arquivos self-hosted assume que você vai usar uma página web no celular. Funciona, mas uma aba de navegador é uma casa ruim para algo que você abre dez vezes por dia: recarrega, perde a última pasta e a barra de endereço come a tela.
O projeto que eu mantenho — Banyan, um navegador de arquivos de um único binário — publica um APK de Android junto com as builds de desktop. Isto é o que o APK é, como instalar e a única coisa que vai te bloquear (a ABI).
O que o APK realmente é
É uma casca empacotada para a mesma interface que o servidor serve, não um app separado com motor de sincronização próprio. Os arquivos ficam na sua máquina; o celular é só um cliente. Duas consequências que vale saber de antemão:
- Sem conta, sem nuvem, sem fila de upload. Se o servidor não responde, o app não mostra nada — não é cache.
- É pequeno. A build arm64 atual tem cerca de 19 MB, contra 21-22 MB do binário de servidor por plataforma.
1. Confira a ABI antes de tudo
A build disponível é somente arm64 — o nome diz: banyan_android_arm64_20261118.apk.
- arm64-v8a (praticamente qualquer celular de 2017 pra cá, todos os Snapdragon/Exynos/Dimensity modernos): suportado.
- armeabi-v7a (aparelhos antigos de 32 bits, tablets baratos, algumas TV boxes): não suportado. Use a interface web no navegador; não falta mais nada.
Dá para checar com qualquer app de info tipo CPU-Z, ou lendo ro.product.cpu.abi via adb:
adb shell getprop ro.product.cpu.abi
# arm64-v8a -> pode instalar
# armeabi-v7a, armeabi -> use o navegador
2. Baixe o arquivo
curl -LO https://banyan.ikootoo.com/release/banyan_android_arm64_20261118.apk
Ou abra https://banyan.ikootoo.com/#download no celular e toque na linha do Android. Todas as builds ficam sob /release/ com a data no nome, então você pode fixar uma versão em vez de pegar sempre a última.
3. Instale
O Android vai recusar o arquivo vindo de uma aba ou de um app de mensagem até você autorizar aquele app específico a instalar pacotes desconhecidos:
- Toque no
.apkbaixado. - Quando pedir, ative Instalar apps desconhecidos apenas para o app de origem (Chrome / Arquivos / o que você usou para baixar). No Android 8+ é uma permissão por app, não um interruptor global.
- Instale e depois revogue a permissão se quiser — não é necessária para atualizações se você instalar por um gerenciador de arquivos.
Se aparecer "App não instalado" sem motivo, quase sempre é o descompasso de ABI do passo 1, ou uma cópia anterior assinada com outra chave (desinstale a antiga primeiro).
4. Aponte para o seu servidor
Suba o servidor primeiro:
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
Ele imprime um endereço de escuta. Use esse endereço no celular, no mesmo Wi-Fi — o app não vê a sua LAN pelos dados móveis, e não deveria.
Duas coisas causam "funciona no notebook mas não no celular":
-
O servidor se amarrou só em
localhost. Amarre na interface da rede local, senão só a própria máquina alcança. - O celular está numa rede de convidados ou num SSID com "isolamento de clientes". Muitos roteadores bloqueiam tráfego entre dispositivos por padrão em VLANs de convidados.
5. Por que manter fora da internet
O app não tem tela de login, e o servidor também não: é de propósito. Dentro não existem contas de usuário nem ACL; permissões são do sistema operacional, e compartilhar é um link com data de expiração. Então não abra a porta no roteador. Se precisar fora de casa, use VPN (WireGuard, Tailscale) ou um proxy reverso com TLS e lista de permitidos.
arquivos.exemplo.com {
reverse_proxy 127.0.0.1:8688
}
6. Quando vale a pena o APK em vez de uma aba
- Você abre a mesma pasta várias vezes por dia e quer que ela fique onde você deixou.
- Quer um ícone na tela inicial que não viva no alternador de abas.
- Tem um tablet apoiado como tela de cozinha ou de TV e quer entrar com um toque.
Se não for o seu caso, a interface web é a mesma: adicione a página à tela inicial como atalho e pule o APK. É uma escolha legítima, não uma versão pior.
Resumo
Só arm64, 19 MB, instalar com permissão por app para origens desconhecidas, apontar para o endereço que o servidor imprime, manter a porta fora da internet. Se o seu aparelho é 32 bits, use o navegador.
Site: https://banyan.ikootoo.com/
Builds: https://banyan.ikootoo.com/#download
Código: https://github.com/nbmany-web/banyan (MIT)
Top comments (0)