DEV Community

爱国者
爱国者

Posted on Edited on AI-assisted

Monta un servidor de archivos para toda tu red local con un solo binario (sin Docker, sin base de datos)

Tengo una caja pequeña en un rincón con dos discos conectados. Durante años, la única forma de usarla desde el móvil era un recurso compartido SMB y una app que no previsualizaba nada. Ahora ejecuta un único binario en Go que sirve una interfaz web, y cualquier dispositivo de la red —móvil, tablet, televisor, portátil— puede navegar y previsualizar archivos sin instalar nada.

Esta es la versión práctica de ese montaje. Unos 15 minutos, un archivo, sin Docker, sin base de datos, sin PHP, sin cron.

Lo que necesitas

  • Una máquina en la misma red que tus archivos: una Raspberry Pi (4 o 5), un mini PC, un portátil viejo, o el propio NAS si puede ejecutar un binario de Linux.
  • Un puerto HTTP libre, por ejemplo 8688.
  • Opcional: un proxy inverso con TLS si quieres alcanzarlo desde fuera.

Hay builds para Windows, macOS, Linux (amd64/arm64/armv7), FreeBSD y un APK de Android.

1. Descarga el binario

Sin instalador y sin repositorio de paquetes:

mkdir -p ~/banyan && cd ~/banyan
# Linux arm64 (Pi 4/5, la mayoría de mini PC 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

En Windows es lo mismo: un .exe en una carpeta y doble clic.

2. Arráncalo en modo headless

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

Imprime una dirección de escucha. Abre esa dirección desde cualquier navegador de la red y ya tienes el explorador de archivos: árbol de carpetas a la izquierda, cuadrícula de miniaturas a la derecha.

Para que sobreviva al cierre de la sesión SSH, usa 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. Apunta a tus discos

Monta los discos con el sistema operativo (/etc/fstab o unidades de montaje de systemd) y luego expón la carpeta que quieras como raíz. Mantener montaje y aplicación separados significa que un disco caído no tumba la interfaz, y puedes mover la carpeta después sin reconfigurar la app.

Un detalle que importa: el pipeline de previsualización se ejecuta en la máquina que tiene los archivos. Cuando tocas un RAW de 60 MB en el móvil, el servidor genera la miniatura y envía unos cientos de KB. Por eso esto funciona incluso con un Wi-Fi flojo.

4. Mantenlo fuera de internet (salvo que quieras lo contrario)

Ata el proceso a la dirección de la red local y no abras el puerto en el router. Para acceso remoto, pon delante una VPN o un proxy inverso con TLS:

archivos.ejemplo.com {
    reverse_proxy 127.0.0.1:8688
}
Enter fullscreen mode Exit fullscreen mode

Dentro de la aplicación no hay cuentas de usuario ni ACL —es a propósito. Los permisos son cosa del sistema operativo, y compartir es un enlace con caducidad. Es una superficie de ataque más pequeña que un formulario de login que nadie rota.

5. Comparte una carpeta sin crear cuentas

Los enlaces de comparte llevan un token y una fecha de caducidad. Le mandas la URL al cliente, la abre en el navegador y deja de funcionar cuando pasa la fecha. Sin registros y sin cuentas de invitado que limpiar después.

6. Qué obtienes además de miniaturas

  • Previsualización de más de 100 formatos: HEIC, RAW, PDF, documentos de Office, comprimidos, subtítulos, fuentes.
  • Reproducción de vídeo y audio con peticiones por rangos, así la barra de progreso funciona.
  • Edición dentro de la previsualización —corrige una errata, recorta una foto— que se escribe de vuelta en la misma ruta. Sin ciclo descargar-editar-subir.
  • Marca de agua y firma en PDF.
  • Cifrado AES-256-GCM por directorio.
  • Subida por arrastrar y soltar que conserva la estructura de carpetas.

Notas de quien lo lleva usando un tiempo

  • Usa una máquina que no se duerma. El portátil viejo que suspende al cerrar la

Top comments (0)