, , ,

FileBrowser Quantum mit Docker installieren: Dateimanager mit HTTPS

•

min Lesezeit

•

Letzte Änderung

Ein Verzeichnis voller Fotos, PDFs oder Projektdateien liegt auf deinem Linux-Server, aber du möchtest nicht für jeden Zugriff per SSH oder SMB arbeiten? FileBrowser Quantum macht aus ausgewählten Ordnern eine Weboberfläche für Dateien – mit Upload, Download und Benutzerverwaltung. Für einen Homeserver ist das praktisch, verlangt aber eine saubere Sicherheitskonfiguration: Du solltest schließlich nicht versehentlich dein ganzes Dateisystem für das Internet freigeben. Diese Anleitung zeigt eine nachvollziehbare Neuinstallation der stabilen 2.0-Reihe mit Docker Compose, eigenem Datenverzeichnis, Anmeldeschutz und optionalem HTTPS-Reverse-Proxy.

Versionshinweis: Die offizielle Anleitung trennt FileBrowser Quantum v2.0.x (stable) von einer separat angebotenen v2.1-Beta. Verwende für eine neue stabile Installation den Image-Tag stable. Wer bereits v1.x nutzt, benötigt eine dokumentierte Datenbankmigration und darf dieses Setup nicht einfach als Upgrade über die vorhandene Installation legen.

Was kann FileBrowser Quantum?

FileBrowser Quantum Benutzeroberfläche, Screenshot aus dem TrueNAS App-Katalog
FileBrowser Quantum – Original-Screenshot aus dem TrueNAS App-Katalog (Darstellung kann je nach Version abweichen).

Das Projekt bietet eine moderne browserbasierte Dateioberfläche und kann ausgewählte Verzeichnisse als Sources einbinden. Je nach Image-Variante sind Funktionen für Medien- und Dokumentvorschau vorhanden. Das hier verwendete Standard-Image enthält diese zusätzlichen Komponenten, während stable-slim bewusst kompakter ist. Die wichtigste Entscheidung triffst du bereits bei der Einrichtung: Welche Host-Ordner darf der Dienst überhaupt sehen?

1. Voraussetzungen prüfen

Du brauchst Docker Engine, Docker Compose und ein Verzeichnis auf dem Host, auf das der Container zugreifen darf. Für den späteren Zugriff über das Internet benötigst du zusätzlich einen funktionierenden HTTPS-Reverse-Proxy. Diese Installation nutzt als Beispiel ein eigenes leeres Verzeichnis und erteilt ausdrücklich keinen Zugriff auf /, /etc oder den Docker-Socket.

docker --version
docker compose version
docker info --format '{{.DockerRootDir}}'

Beispielausgabe (verkürzt, keine echte Servermessung):

Docker version 28.x.x, build [Beispiel]
Docker Compose version v2.x.x
/var/lib/docker

Die Docker-Root-Ausgabe ist eine Momentaufnahme deines Systems und kann bei Rootless Docker oder anderen Installationen abweichen. Eine funktionierende Compose-Version ist wichtiger als eine bestimmte Ausgabe.

2. Verzeichnisse erstellen

Erstelle ein dediziertes Arbeitsverzeichnis. data enthält später die Konfiguration und SQLite-Datenbank der Anwendung, files ist der Ordner, den du über den Browser verwalten möchtest.

mkdir -p ~/docker/filebrowser-quantum/data ~/docker/filebrowser-quantum/files
cd ~/docker/filebrowser-quantum
pwd
ls -ld data files

Beispielausgabe (verkürzt, keine echte Servermessung):

/home/[BENUTZER]/docker/filebrowser-quantum
drwxr-xr-x 2 [BENUTZER] [GRUPPE] ... data
drwxr-xr-x 2 [BENUTZER] [GRUPPE] ... files

Der Container verwendet im offiziellen Image standardmäßig UID und GID 1000:1000. Unter einem normalen Linux-Host kann dieser Benutzer auf frisch angelegte Verzeichnisse möglicherweise noch nicht schreiben. Kontrolliere deine tatsächlichen Dateirechte und passe nur diese beiden neuen Verzeichnisse an, sofern nötig:

sudo chown -R 1000:1000 ./data ./files
ls -ld data files

Beispielausgabe (verkürzt, keine echte Servermessung):

drwxr-xr-x 2 1000 1000 ... data
drwxr-xr-x 2 1000 1000 ... files

Verwende dieses chown nicht auf deinem gesamten Home-Verzeichnis oder vorhandenen NAS-Freigaben. Falls du produktive Daten mounten möchtest, kläre zuerst Eigentümer, Gruppen, ACLs und gewünschte Zugriffsrechte. Im Zweifelsfall binde sensible Bestandsdaten zunächst schreibgeschützt ein.

3. Konfiguration anlegen

Bei FileBrowser Quantum v2 liegt die Docker-Konfiguration üblicherweise unter /home/filebrowser/data/config.yaml. Dank des Verzeichnismounts kannst du sie auf dem Host als ./data/config.yaml bearbeiten. Lege die Datei vor dem Start an und nutze eine einzige explizite Quelle /folder.

cat > ./data/config.yaml <<'YAML'
server:
  sources:
    - path: /folder
      config:
        defaultEnabled: true
auth:
  methods:
    password:
      enabled: true
YAML

Der Befehl erstellt die Konfigurationsdatei und zeigt bei Erfolg normalerweise keine Ausgabe. Mit defaultEnabled: true ist die angelegte Quelle bei der initialen Benutzerkonfiguration verfügbar. Für Mehrbenutzerbetrieb musst du Rechte und Quellen später in der Benutzerverwaltung gezielt einschränken; eine Dateiquelle ist keine automatische Mandantentrennung.

Der Pfad /folder ist ein Pfad innerhalb des Containers und muss zum Volume-Mapping im nächsten Schritt passen. Wenn du stattdessen einen beliebigen Hostpfad hier einträgst, obwohl er nicht gemountet ist, zeigt die Weboberfläche möglicherweise keinen Inhalt.

4. Compose-Datei schreiben

Lege im Arbeitsverzeichnis eine Datei compose.yaml mit folgender Konfiguration an:

services:
  filebrowser:
    image: ghcr.io/gtsteffaniak/filebrowser:stable
    container_name: filebrowser-quantum
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - ./files:/folder
      - ./data:/home/filebrowser/data
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

Der Host-Port 8080 ist bewusst ausschließlich an 127.0.0.1 gebunden. Dadurch ist die Anwendung nicht automatisch im gesamten LAN oder Internet erreichbar; für andere Geräte verwendest du im nächsten Schritt einen kontrollierten Proxy oder einen SSH-Tunnel. Der Quellordner files wird in diesem Grundbeispiel beschreibbar eingebunden. Der Container erhält keine anderen Host-Verzeichnisse und keinen Docker-Socket.

Das Tag stable folgt neuen stabilen Releases. Für besonders kritische Installationen empfiehlt sich nach erfolgreichem Test ein konkretes Versionstag oder ein Image-Digest; vor größeren Versionswechseln solltest du die Migrationshinweise lesen.

5. Konfiguration prüfen

Starte nicht sofort blind, sondern lasse Docker Compose zuerst die vollständige Konfiguration prüfen. Damit erkennst du viele Schreibfehler bereits vor dem Start.

docker compose config --quiet
docker compose config --services

Beispielausgabe (verkürzt, keine echte Servermessung):

filebrowser

Der erste Befehl gibt bei Erfolg nichts aus und endet mit Exitcode 0. Bei einer Fehlermeldung überprüfst du die YAML-Einrückung und die Dateinamen. Achte außerdem darauf, dass data/config.yaml eine Datei ist und kein versehentlich angelegtes Verzeichnis.

6. Container starten

Starte nun FileBrowser Quantum und kontrolliere den Zustand:

docker compose up -d
docker compose ps

Beispielausgabe (verkürzt, keine echte Servermessung):

[+] Running 1/1
 ✔ Container filebrowser-quantum Started

NAME                 IMAGE                                    STATUS
filebrowser-quantum  ghcr.io/gtsteffaniak/filebrowser:stable Up

Das erste Herunterladen des Images kann je nach Verbindung eine Weile dauern. Der Containername und die Ausgabe sind hier nur beispielhaft dargestellt. Wenn der Dienst sofort wieder stoppt, prüfe docker compose logs --tail=80 filebrowser.

7. Erstes Admin-Passwort

Bei einer frischen v2.0-Installation erzeugt FileBrowser Quantum ein zufälliges einmaliges Admin-Passwort, sofern kein alternatives Passwort konfiguriert wurde. Es steht zunächst im Container-Log. Behandle diese Zeile wie ein Geheimnis und kopiere sie nicht in öffentliche Fehlerberichte.

docker compose logs --no-color filebrowser 2>&1 | grep -m1 -i 'initial admin password'

Beispielausgabe (verkürzt, keine echte Servermessung):

filebrowser  | Initial admin password: [HIER STEHT DEIN EINMALIGES PASSWORT]

Die zweite Zeile ist ausdrücklich ein Platzhalter. Melde dich mit dem vom Dienst ausgegebenen Passwort an und lege direkt ein eigenes starkes Passwort fest. Konfiguriere kein dauerhaftes FILEBROWSER_ADMIN_PASSWORD in einer öffentlich lesbaren Compose-Datei: Die Projektdokumentation weist darauf hin, dass ein dort gesetztes Passwort bei Neustarts erneut angewendet werden kann.

8. Oberfläche öffnen

FileBrowser Quantum: weiterer Screenshot aus dem TrueNAS App-Katalog
FileBrowser Quantum – Original-Screenshot aus dem TrueNAS App-Katalog (Darstellung kann je nach Version abweichen).

Auf dem Server selbst öffnest du http://127.0.0.1:8080 im Browser. Sitzt du an einem anderen Rechner, verwende einen passenden gesicherten Zugriffspfad. Ein SSH-Tunnel ist für einen schnellen Test geeignet: Er verbindet deinen lokalen Browser mit dem nur auf dem Server erreichbaren Port.

ssh -L 8080:127.0.0.1:8080 BENUTZER@SERVER

Ersetze BENUTZER und SERVER durch deine echten SSH-Daten. Solange die SSH-Verbindung läuft, öffnest du auf deinem eigenen Computer http://127.0.0.1:8080. Falls dort bereits eine andere Anwendung Port 8080 verwendet, nimm beispielsweise 8081:127.0.0.1:8080 und öffne anschließend Port 8081 auf deinem Rechner.

9. Eigene HTTPS-Domain

Für den regelmäßigen Zugriff richtest du im bestehenden Reverse Proxy eine Subdomain wie dateien.example.com ein. Wenn Proxy und Docker-Dienst auf demselben Host laufen, kann der Proxy an http://127.0.0.1:8080 weiterleiten. Bei einem Proxy in einem anderen Container musst du stattdessen dessen tatsächlich erreichbare interne Netzwerkadresse verwenden. Aktiviere HTTPS mit gültigem Zertifikat und beachte, dass eine zusätzliche Authentifizierung am Proxy die Benutzerrechte innerhalb von FileBrowser nicht ersetzt.

Erhöhe die erlaubte Uploadgröße im Proxy nur dann, wenn konkrete Uploads daran scheitern und der gewünschte Dateiumfang das rechtfertigt. Gib die Weboberfläche nicht ohne Zugriffskontrolle öffentlich frei, insbesondere wenn darüber Dateien gelöscht oder hochgeladen werden dürfen.

10. Datei- und Benutzerrechte

FileBrowser Quantum: dritter Screenshot aus dem TrueNAS App-Katalog
FileBrowser Quantum – Original-Screenshot aus dem TrueNAS App-Katalog (Darstellung kann je nach Version abweichen).

Melde dich an, lade eine unkritische Testdatei hoch und prüfe, ob sie sich wieder herunterladen lässt. Erstelle anschließend gegebenenfalls weitere Benutzer mit den jeweils nötigen Rechten. Für gemeinsam genutzte Ordner ist die Trennung zwischen Lesen, Hochladen, Ändern und Löschen besonders wichtig. Gewähre Administratorrechte nur dort, wo die Benutzerverwaltung tatsächlich benötigt wird.

Das Mounten eines Host-Ordners gewährt der Anwendung Zugriff auf genau diesen Teil des Dateisystems entsprechend den Betriebssystemrechten. Das ist kein Backup und keine zusätzliche Verschlüsselung. Verwende für besonders wichtige Dokumente ein separates Backup und eine nachvollziehbare Rechtevergabe.

11. Backup und Wiederherstellung

Die beiden gemounteten Verzeichnisse gehören in deine Backup-Strategie: ./files enthält die verwalteten Dateien, ./data unter anderem Konfiguration und SQLite-Datenbank. Ein laufender Datenbankprozess kann bei einer unkoordinierten Dateikopie einen inkonsistenten Stand erzeugen. Für eine einfache konsistente Wartungssicherung kannst du den Dienst stoppen, beide Verzeichnisse gemeinsam sichern und ihn danach wieder starten. In professionellen Umgebungen sind geeignete Snapshot- und Datenbank-Backupverfahren vorzuziehen.

docker compose stop filebrowser
# Jetzt beide Verzeichnisse data/ und files/ konsistent sichern.
docker compose start filebrowser
docker compose ps

Beispielausgabe (verkürzt, keine echte Servermessung):

Container filebrowser-quantum Stopped
Container filebrowser-quantum Started
NAME                 STATUS
filebrowser-quantum  Up

Die Kommentarzeile ist eine Arbeitsanweisung und keine ausführbare Backup-Operation. Ein echtes Backup muss außerhalb des Containers erstellt und regelmäßig durch eine Test-Wiederherstellung kontrolliert werden. Der Dienst ist während dieser Methode kurz nicht erreichbar.

12. Updates durchführen

Prüfe vor einem Update die offiziellen Release Notes, insbesondere bei Änderungen am Datenbankformat. FileBrowser Quantum v2.0 nutzt SQLite und weist ausdrücklich auf eine besondere Migration von v1-Datenbanken hin. Überschreibe daher keine ältere Installation mit einer neuen Compose-Datei ohne die passende Migrationsanleitung.

docker compose pull filebrowser
docker compose up -d filebrowser
docker compose ps

Beispielausgabe (verkürzt, keine echte Servermessung):

[+] Pulling 1/1
 ✔ filebrowser Pulled
[+] Running 1/1
 ✔ Container filebrowser-quantum Running

Nach dem Update kontrollierst du Login, Dateiliste, Upload und Download. Bewahre den vorherigen Image-Stand und ein konsistentes Backup auf, um bei unerwarteten Änderungen auf einen bekannten Zustand zurückgehen zu können.

Fehler beheben

Die Oberfläche ist leer: Vergleiche den Source-Pfad in data/config.yaml mit dem Volume-Mapping in Compose. Bei ./files:/folder muss der konfigurierte Source-Pfad /folder lauten.

Uploads scheitern: Prüfe die Rechte der gemounteten Hostordner, die UID/GID des Containerprozesses und den freien Speicher. Setze niemals wahllos chmod -R 777 auf deine Daten.

Kein Zugriff von einem anderen Computer: Die Bindung 127.0.0.1:8080:80 ist absichtlich lokal. Verwende den gesicherten Reverse Proxy oder einen SSH-Tunnel, statt ohne Prüfung Ports im Router freizugeben.

Admin-Passwort fehlt: Prüfe die Startlogs des tatsächlich neuen Containers. Wenn du bereits eine vorhandene Datenbank weiterverwendest, ist es keine frische Installation; benutze dann die offizielle dokumentierte Wiederherstellungsprozedur, statt Datenbankdateien zu löschen.

Container startet nicht: Lasse docker compose config --quiet laufen und kontrolliere docker compose logs --tail=100 filebrowser auf falsche Pfade, Schreibrechte oder ungültige Konfiguration. Entferne nicht einfach alle Sicherheitsoptionen.

Fazit

FileBrowser Quantum bietet einen praktischen und optisch modernen Zugriff auf Serverdateien. Mit einer klar begrenzten Quelle, persistentem Daten- und Konfigurationsordner, sicherem Admin-Passwort und kontrolliertem HTTPS-Zugang eignet sich der Dienst für viele Homeserver-Anwendungen. Der wichtigste Sicherheitsgrundsatz bleibt: Stelle nur die Verzeichnisse bereit, die über den Browser wirklich verwaltet werden sollen.

Offizielle Quellen: FileBrowser Quantum: Docker v2.0, Konfiguration, Umgebungsvariablen. Weiterlesen: Docker-Logs begrenzen.


Schreiben Sie einen Kommentar

Ihre E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert