DEV Community

爱国者
爱国者

Posted on Edited on AI-assisted

Um servidor de arquivos para a rede toda com um único binário (sem Docker, sem banco de dados)

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
Enter fullscreen mode Exit fullscreen mode

No Windows é a mesma ideia: um .exe numa pasta e dois cliques.

2. Rode em modo headless

./banyan/banyan -headless
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode
sudo systemctl enable --now banyan
Enter fullscreen mode Exit fullscreen mode

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
}
Enter fullscreen mode Exit fullscreen mode

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)