133 lines
5.5 KiB
Markdown
133 lines
5.5 KiB
Markdown
---
|
|
title: FileBrowser Quantum
|
|
created: 2026-06-07
|
|
updated: 2026-06-07
|
|
type: app
|
|
tags: [catalogue, file-management, go, vue, filebrowser-fork, code-editor, monaco]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=File+Management, https://github.com/gtsteffaniak/filebrowser]
|
|
---
|
|
|
|
# FileBrowser Quantum ⚛️
|
|
|
|
> Fork communautaire de [[app-file-browser]] qui modernise l'UI et ajoute un **éditeur de code Monaco** (le même que VS Code), un système de tags, des previews étendues et un thème Material Design. Pour qui aime File Browser mais veut plus.
|
|
|
|
| Métadonnée | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | https://gtsteffaniak.github.io/filebrowser/ |
|
|
| **GitHub** | https://github.com/gtsteffaniak/filebrowser |
|
|
| **License** | MIT |
|
|
| **Langage** | Go + Vue 3 |
|
|
| **Étoiles** | 364 ⭐ |
|
|
| **Dernière MAJ** | 2026-06 |
|
|
| **Catégorie** | [[cat-file-management]] |
|
|
|
|
## Description
|
|
|
|
FileBrowser Quantum est né en 2024 d'une frustration : le projet original [[app-file-browser]] stagne parfois plusieurs mois entre deux releases, et certaines features attendues (éditeur de code puissant, tags, recherche améliorée) tardent à arriver. **gtsteffaniak** a alors lancé un fork ambitieux qui reprend la base Go de File Browser mais refond complètement le frontend.
|
|
|
|
Les apports principaux de Quantum par rapport à l'original :
|
|
- **Éditeur Monaco** intégré (le moteur de VS Code) avec coloration syntaxique pour 50+ langages, IntelliSense, multi-curseurs
|
|
- **Système de tags** : tagger fichiers/dossiers, recherche par tag
|
|
- **Material Design** : interface refaite avec Material UI, plus moderne
|
|
- **Previews étendues** : images, vidéos, audio, PDF, ePub, code (avec coloration)
|
|
- **Vue en grille ET liste** avec thumbnails
|
|
- **Recherche fuzzy** côté client
|
|
- **Améliorations perf** sur les très gros répertoires
|
|
- **Multi-utilisateurs** avec scopes par utilisateur
|
|
- **API REST** documentée
|
|
|
|
C'est l'option idéale pour qui veut un file manager **"VS Code + Finder"** en self-hosted. L'installation est identique à [[app-file-browser]] (binaire Go + Vue), la migration depuis File Browser original est possible (compatibilité de la base SQLite en grande partie préservée, mais vérifier la doc de migration).
|
|
|
|
⚠️ **Attention** : c'est un fork, donc le rythme de release est dicté par un seul mainteneur principal. Le projet original reste plus stable pour la production critique. Quantum est parfait pour homelab et dev.
|
|
|
|
## Installation
|
|
|
|
### Option 1 : Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
services:
|
|
filebrowser-quantum:
|
|
image: gtstef/filebrowser-quantum:latest
|
|
container_name: filebrowser-quantum
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8080:80"
|
|
volumes:
|
|
- /srv/data:/srv
|
|
- ./config:/config
|
|
- ./database:/database
|
|
environment:
|
|
- PUID=1000
|
|
- PGID=1000
|
|
- FB_AUTH_ADMIN=admin
|
|
- FB_AUTH_PASSWORD=***REMPLACER***
|
|
```
|
|
|
|
UI sur `http://localhost:8080`. Identifiants par défaut : `admin` / `admin` (**à changer**).
|
|
|
|
### Option 2 : Binaire
|
|
|
|
```bash
|
|
wget https://github.com/gtsteffaniak/filebrowser/releases/latest/download/linux-amd64.tar.gz
|
|
tar xf linux-amd64.tar.gz
|
|
./filebrowser --config /etc/filebrowser.yaml
|
|
```
|
|
|
|
## Configuration
|
|
|
|
- **Premier accès** : wizard intégré, créer le compte admin.
|
|
- **Configuration YAML** : fichier `config.yaml` à monter (scope, auth, branding).
|
|
- **Thèmes** : Material Light/Dark, customisation couleurs possible.
|
|
- **Scopes utilisateurs** : par utilisateur, sous-arbre du filesystem.
|
|
- **API** : `GET /api/resources`, `POST /api/resources` (CRUD fichiers), documentation auto-générée sur `/swagger`.
|
|
- **Reverse proxy** : derrière [[app-caddy]] ou [[app-traefik]], configurer le `baseUrl` dans la config.
|
|
|
|
## Alternatives
|
|
|
|
### Open Source
|
|
- [[app-file-browser]] — L'original, plus stable
|
|
- [[app-filestash]] — UI moderne, multi-protocoles
|
|
- [[app-openlist]] — Multi-backends
|
|
- [[app-filegator]] — PHP multi-user
|
|
- [[app-cloud-commander]] — Node.js double-panel
|
|
- [[app-code-server]] — VS Code complet dans le navigateur (pas file manager)
|
|
- [[app-filerun]] — PHP UX riche
|
|
|
|
### Propriétaires
|
|
- Google Drive
|
|
- Dropbox
|
|
- OneDrive
|
|
- Box
|
|
- Kodexplorer (PHP, chinois)
|
|
|
|
## Sécurité
|
|
|
|
- **Changer le mot de passe admin par défaut** dès l'installation.
|
|
- HTTPS obligatoire ([[app-caddy]] / [[app-traefik]]).
|
|
- **L'éditeur Monaco = exécution possible de code** : un attaquant ayant accès peut théoriquement exécuter du code via le terminal web. Restreindre l'accès aux utilisateurs de confiance.
|
|
- **Limiter le scope** : ne pas exposer `/` ou `/etc` même si l'UI le permet.
|
|
- **Logs** : activer l'audit log pour tracer les ouvertures de fichiers sensibles.
|
|
- **Pas de SSO natif** : brancher en amont [[app-authelia]] ou [[app-authentik]].
|
|
- **Mises à jour** : Quantum release souvent (1-2/mois), suivre le repo.
|
|
- **Backups** : `./config` et `./database` (SQLite).
|
|
|
|
## Ressources
|
|
|
|
- [Documentation officielle](https://gtsteffaniak.github.io/filebrowser/)
|
|
- [GitHub](https://github.com/gtsteffaniak/filebrowser)
|
|
- [Docker Hub](https://hub.docker.com/r/gtstef/filebrowser-quantum)
|
|
- [selfh.st/apps/?tag=File+Management](https://selfh.st/apps/?tag=File+Management)
|
|
|
|
## Pages Liées
|
|
|
|
- [[cat-file-management]] — Catégorie parente
|
|
- [[app-file-browser]] — Le projet parent (original)
|
|
- [[app-code-server]] — VS Code complet
|
|
- [[app-filestash]] — Concurrent moderne
|
|
- [[app-caddy]] / [[app-traefik]] — Reverse proxy
|
|
- [[app-authelia]] — SSO
|
|
- [[recettes-docker-compose]] — Templates Docker
|
|
- [[securisation-home-lab]] — Bonnes pratiques
|