Tenho uma caixa pequena num canto da sala com dois discos ligados. Durante anos, a única forma de usá-la pelo celular era um compartilhamento SMB e um app que não mostrava prévia de nada. Agora roda um único binário em Go que serve uma interface web, e qualquer aparelho da rede — celular, tablet, TV, notebook — navega e pré-visualiza arquivos sem instalar nada.
Esta é a versão prática dessa montagem. Uns 15 minutos, um arquivo, sem Docker, sem banco de dados, sem PHP, sem cron.
O que você precisa
- Uma máquina na mesma rede dos seus arquivos: um Raspberry Pi (4 ou 5), um mini PC, um notebook velho, ou o próprio NAS se ele conseguir rodar um binário Linux.
- Uma porta HTTP livre, por exemplo
8688. - Opcional: um proxy reverso com TLS se quiser acessar de fora.
Existem builds para Windows, macOS, Linux (amd64/arm64/armv7), FreeBSD e um APK para Android.
1. Baixe o binário
Sem instalador e sem repositório de pacotes:
mkdir -p ~/banyan && cd ~/banyan
# Linux arm64 (Pi 4/5, a maioria dos mini PCs ARM)
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
No Windows é a mesma ideia: um .exe numa pasta e dois cliques.
2. Rode em modo headless
./banyan/banyan -headless
Ele imprime um endereço de escuta. Abra esse endereço em qualquer navegador da rede e você tem o explorador de arquivos: árvore de pastas à esquerda, grade de miniaturas à direita.
Para sobreviver ao fim da sessão SSH, use systemd:
# /etc/systemd/system/banyan.service
[Unit]
Description=Banyan file browser
After=network.target
[Service]
ExecStart=/home/pi/banyan/banyan -headless
WorkingDirectory=/home/pi/banyan
Restart=always
User=pi
[Install]
WantedBy=multi-user.target
sudo systemctl enable --now banyan
3. Aponte para seus discos
Monte os discos pelo sistema operacional (/etc/fstab ou unidades de mount do systemd) e depois exponha a pasta que você quer como raiz. Manter montagem e aplicação separadas significa que um disco caído não derruba a interface, e você pode mover a pasta depois sem reconfigurar o app.
Um detalhe que importa: o pipeline de prévia roda na máquina que tem os arquivos. Quando você toca num RAW de 60 MB no celular, o servidor gera a miniatura e envia algumas centenas de KB. É por isso que funciona até em Wi-Fi fraco.
4. Mantenha fora da internet (a menos que você queira)
Amarre o processo ao endereço da rede local e não abra a porta no roteador. Para acesso remoto, coloque na frente uma VPN ou um proxy reverso com TLS:
arquivos.exemplo.com {
reverse_proxy 127.0.0.1:8688
}
Dentro do app não existem contas de usuário nem ACL — de propósito. Permissões são trabalho do sistema operacional, e compartilhar é um link com data de expiração. É uma superfície de ataque menor do que um formulário de login que ninguém troca.
5. Compartilhe uma pasta sem criar contas
Links de compartilhamento carregam um token e uma data de expiração. Você manda a URL para o cliente, ele abre no navegador, e para de funcionar quando a data passa. Sem cadastro e sem conta de convidado para limpar depois.
6. O que você ganha além das miniaturas
- Prévia de mais de 100 formatos: HEIC, RAW, PDF, documentos do Office, arquivos compactados, legendas, fontes.
- Reprodução de vídeo e áudio com requisições por faixa, então a barra de progresso funciona.
- Edição dentro da prévia — corrigir um erro de digitação, cortar uma foto — que grava de volta no mesmo caminho. Sem ciclo baixar-editar-subir.
- Marca d'água e assinatura em PDF.
- Criptografia AES-256-GCM por diretório.
- Upload por arrastar e soltar que preserva a estrutura de pastas.
Notas de quem já usa isso há um tempo
- Use uma máquina que não durma. O notebook velho que suspende ao fechar a tampa é a causa mais comum de um servidor de arquivos "parar
Top comments (0)