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
En Windows es lo mismo: un .exe en una carpeta y doble clic.
2. Arráncalo en modo headless
./banyan/banyan -headless
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
sudo systemctl enable --now banyan
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
}
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)