FileBrowser Quantum: Evolución de FileBrowser con más funciones
Este apunte documenta la instalación y uso de FileBrowser Quantum, un gestor de archivos web autohospedado, basado en el proyecto original FileBrowser pero con múltiples mejoras y soporte para autenticación avanzada.
Características principales
- Interfaz web renovada y optimizada.
- Soporte para múltiples orígenes de archivos.
- Autenticación mediante OIDC, usuario/contraseña con 2FA, o proxy.
- Indexación eficiente con búsqueda en tiempo real.
- Vista previa de más tipos de archivos (incluyendo Office y vídeo).
- API con tokens de larga duración y documentación integrada (/swagger).
- Configuración simplificada mediante
config.yaml.
Requisitos previos
- Docker y Docker Compose instalados.
- Un directorio en el host con los archivos que se quieran exponer.
- Un archivo
config.yamladaptado a las necesidades (ver wiki oficial del proyecto para opciones avanzadas).
Despliegue
El archivo docker-compose.yml completo para FileBrowser Quantum está disponible en el repositorio personal:
En este compose, la ruta /mnt del host corresponde a /srv dentro del contenedor, que es el punto desde el que se sirven los archivos. Cambia esta ruta según la ubicación real de los datos que quieras exponer.
Si se va a exponer públicamente, es altamente recomendable proteger el acceso mediante Authentik o cualquier otra solución de autenticación que permita restringir usuarios y evitar accesos no autorizados.
Notas y decisiones importantes
- Al indexar todo el contenido por defecto, en sistemas con grandes volúmenes de datos puede aumentar el consumo de recursos. Revisar la wiki del proyecto sobre indexación para optimizar el rendimiento.
- No soporta S3, WebDAV o FTP, está enfocado a entornos locales o almacenamiento directamente montado.
- La autenticación avanzada permite integrarlo con sistemas como Authentik o Keycloak para SSO.
Resumen breve
- Es la evolución no oficial de FileBrowser con más funciones.
- Fácil de desplegar con Docker.
- Configuración centralizada en
config.yaml. - Perfecto para servir archivos en red local o protegidos con autenticación.