No todas las necesidades de un servidor pasan por montar una nube completa al estilo de Nextcloud. A veces, lo que se busca es algo más directo: un panel web para subir, borrar, previsualizar, renombrar o editar archivos dentro de una carpeta concreta, con usuarios separados y sin complicarse la vida con permisos imposibles. Ahí es donde entra Filebrowser, una herramienta ligera que, gracias a su empaquetado en contenedor, se ha convertido en una opción habitual entre quienes administran NAS domésticos, pequeños servidores y entornos “self-hosted”.
Uno de los caminos más sencillos para desplegarlo es el contenedor mantenido por hurlenko en Docker Hub, basado en el proyecto Filebrowser y pensado para arrancar rápido, con volúmenes bien definidos y configuración por variables de entorno. El resultado es un servicio que se puede levantar en minutos y dejar detrás de un proxy (Nginx, por ejemplo) para integrarlo en una instalación más amplia.
Qué ofrece exactamente y por qué ha ganado popularidad
Filebrowser se define como una interfaz web para gestionar ficheros dentro de un directorio especificado. Permite operaciones habituales (subir, eliminar, previsualizar, renombrar y editar) y añade un punto importante para quien comparte el sistema: soporte de múltiples usuarios, con la posibilidad de que cada usuario tenga su propio directorio. Puede utilizarse como aplicación independiente o incluso como middleware, según el proyecto.
La clave de su éxito está en el equilibrio: no pretende ser un “Drive” completo ni un gestor documental avanzado; se centra en resolver bien un problema concreto: gestionar archivos por web sin necesidad de exponer SMB/FTP al exterior ni depender de una VPN para tareas simples.
Arranque rápido: un contenedor y un puerto
La receta mínima que propone el repositorio es tan simple como:
- Ejecutar el contenedor.
- Publicar el puerto del servicio.
- Entrar desde el navegador.
En el caso del contenedor de hurlenko, el puerto interno por defecto es 8080. A partir de ahí, cada despliegue decide si lo expone directamente o lo coloca detrás de un proxy con HTTPS.
Ahora bien, en cuanto se sale del “lo pruebo cinco minutos” y se pasa a “lo dejo en producción”, lo que marca la diferencia es cómo se manejan permisos, volúmenes y rutas.
La configuración que suele evitar dolores de cabeza
El propio repositorio recomienda ejecutar el contenedor con el usuario actual del sistema (en lugar de root dentro del contenedor) y mapear dos volúmenes clave:
- /data: el directorio cuyos archivos se van a gestionar desde el panel.
- /config: la ubicación del fichero de base de datos/configuración.
Esto tiene dos ventajas inmediatas: los archivos creados o subidos mantienen una coherencia de permisos en el host, y la configuración persiste entre reinicios o recreaciones del contenedor.
Además, el proyecto expone variables de entorno para ajustar opciones. El patrón es claro: se usan prefijos FB_ seguidos del nombre de la opción en mayúsculas. Un ejemplo muy frecuente es FB_BASEURL, útil cuando se publica Filebrowser bajo una subruta (por ejemplo, /filebrowser) en lugar de hacerlo en la raíz del dominio.
Detrás de Nginx: el caso típico en servidores “multi-servicio”
En instalaciones donde conviven varios paneles (monitorización, domótica, backups, etc.), lo habitual es poner Filebrowser tras un reverse proxy. El repositorio incluye un ejemplo de configuración de Nginx que cubre lo esencial: proxy_pass al puerto del contenedor, cabeceras, tamaño máximo de subida y soporte de WebSockets.
Este enfoque permite servir el panel bajo una ruta concreta (por ejemplo, tudominio.com/filebrowser) y centralizar el HTTPS en un único punto. También simplifica controles adicionales: autenticación extra, listas blancas por IP o reglas de acceso para entornos corporativos.
Montar varias carpetas a la vez: la solución “ordenada”
Una de las dudas habituales es si se pueden gestionar varias rutas del host. La recomendación del repositorio es montarlas como subdirectorios dentro de /data, por ejemplo:
/data/music/data/movies/data/photos
De este modo, Filebrowser ve un único “árbol” dentro de su directorio raíz, pero en realidad se está alimentando de varias rutas del host. Es una forma limpia de dar acceso organizado sin tener que crear instancias separadas.
Lo que conviene tener claro antes de exponerlo a Internet
Filebrowser es cómodo, pero sigue siendo una puerta a archivos. Y ahí no hay atajos: si se va a publicar hacia el exterior, conviene aplicarle mentalidad de servicio crítico.
Algunas prácticas sensatas en un medio generalista, sin entrar en paranoia:
- Publicarlo siempre con HTTPS (vía proxy o equivalente).
- No mezclarlo con carpetas que contengan información sensible si no es imprescindible.
- Usar permisos mínimos: si una carpeta solo debe verse, montarla en modo lectura cuando sea posible.
- Revisar quién accede y desde dónde (y, si procede, restringir por IP o autenticación adicional).
En resumen: es una herramienta muy útil cuando se busca un “gestor de archivos web” rápido, pero su facilidad de despliegue no debería confundirse con “da igual cómo lo exponga”.
Preguntas frecuentes
¿Para qué sirve Filebrowser en Docker en un NAS o servidor doméstico?
Sirve para gestionar archivos desde el navegador (subir, borrar, renombrar, previsualizar o editar) dentro de una carpeta del servidor, sin depender de SMB/FTP y con soporte de usuarios.
¿Qué puertos y volúmenes usa el contenedor hurlenko/filebrowser?
El servicio usa por defecto el puerto 8080 dentro del contenedor. Los volúmenes habituales son /data para los archivos y /config para la configuración y la base de datos.
¿Cómo se publica Filebrowser detrás de Nginx con una subruta tipo /filebrowser?
Se suele configurar Nginx como reverse proxy hacia el puerto del contenedor y definir una base URL (por ejemplo, con FB_BASEURL) para que la aplicación funcione correctamente bajo esa subruta.
¿Se pueden montar varias carpetas del servidor en una sola instancia de Filebrowser?
Sí: una práctica común es montar varias rutas del host como subdirectorios dentro de /data (por ejemplo, /data/photos, /data/music), para verlas organizadas en un solo panel.
