Filebrowser - Datei-Manager¶

Filebrowser ist eine moderne, webbasierte Dateiverwaltungs-Anwendung, die den einfachen Zugriff auf Dateien in Docker-Volumes ermöglicht. Sie bietet eine intuitive Oberfläche für Dateioperationen ohne SSH-Zugang zum Server.

Architektur¶

Container-Konfiguration¶

filebrowser:
  image: filebrowser/filebrowser:s6
  ports:
    - "${FILEBROWSER_PORT:-8080}:80"
  volumes:
    - filebrowser_config:/config
    - filebrowser_data:/data
    - postgres_data:/data/postgres:ro
    - ./shared:/data/shared
  environment:
    - PUID=1000
    - PGID=1000
  restart: unless-stopped

Daten-Volumes¶

filebrowser_config: Konfigurationsdateien und Datenbank
filebrowser_data: Benutzerdefinierte Dateien
postgres_data: Read-only Zugriff auf Datenbank-Backups
./shared: Gemeinsam genutzte Dateien

Zugriff¶

Webinterface¶

URL: http://localhost:8080 (lokal) oder https://files.ihre-domain.de (Produktion)
Standard-Benutzer: admin
Passwort: Bei Erstinstallation setzen

Ersteinrichtung¶

Filebrowser öffnen über die URL
Admin-Passwort setzen (wird beim ersten Start abgefragt)
Benutzer und Berechtigungen konfigurieren

Dateiverwaltung¶

Grundlegende Operationen¶

Dateien hochladen¶

# Einzelne Dateien
1. "Upload" Button klicken
2. Dateien auswählen oder drag & drop
3. Upload-Status überwachen

# Mehrere Dateien
1. Mehrere Dateien gleichzeitig auswählen
2. Batch-Upload mit Fortschrittsanzeige

Dateien herunterladen¶

# Einzelne Dateien
1. Datei markieren
2. "Download" klicken

# Mehrere Dateien
1. Mehrere Dateien markieren (Checkbox)
2. "Download" → ZIP-Archiv erstellen

Dateien bearbeiten¶

Textdateien:

Datei anklicken → automatischer Editor
Änderungen vornehmen
Speichern (Strg+S)

Unterstützte Formate:

Text: .txt, .md, .json, .yaml, .xml, .csv
Code: .js, .py, .html, .css, .sql
Konfiguration: .conf, .ini, .env

Verzeichnis-Verwaltung¶

Ordner erstellen¶

"New Folder" Button
Ordner-Name eingeben
Berechtigungen setzen (optional)

Breadcrumb-Navigation: Schnelle Pfad-Navigation
Suchfunktion: Dateien und Ordner finden
Filter: Nach Typ, Größe, Datum filtern

Erweiterte Funktionen¶

Datei-Vorschau¶

Unterstützte Vorschau-Formate:

Bilder: .jpg, .png, .gif, .svg, .webp
Dokumente: .pdf, .txt, .md
Audio/Video: Grundlegende Wiedergabe
Archive: .zip, .tar.gz Inhaltsvorschau

Teilen-Funktion¶

# Öffentliche Links erstellen
1. Datei/Ordner rechtsklick → "Share"
2. Link-Optionen:
   - Expires: Ablaufdatum setzen
   - Password: Passwortschutz
   - Downloads: Download-Limit

3. Link generieren und teilen

Suche und Filter¶

# Suchoptionen
- Dateiname (Wildcard: *)
- Volltextsuche in Textdateien
- Filter nach: Typ, Größe, Änderungsdatum
- Rekursive Suche in Unterordnern

Benutzer-Verwaltung¶

Benutzerrollen¶

Admin: Vollzugriff auf alle Funktionen
User: Eigene Dateien verwalten
Guest: Nur Leserechte

Berechtigungen¶

Verzeichnis-spezifische Rechte:

Read: Dateien anzeigen und herunterladen
Write: Dateien hochladen und bearbeiten
Delete: Dateien und Ordner löschen
Share: Freigabe-Links erstellen

Benutzer hinzufügen¶

Settings → Users öffnen
"New User" klicken
Details konfigurieren:
Username und Passwort
Home-Verzeichnis
Berechtigungen zuweisen

Sicherheit¶

Best Practices¶

Starke Passwörter: Komplexe Passwörter für alle Benutzer
Zwei-Faktor-Authentifizierung: Bei Bedarf aktivieren
HTTPS: Immer SSL/TLS verwenden
Regelmäßige Backups: Konfiguration und Daten sichern

Zugriffs-Kontrolle¶

IP-Whitelisting: Nur vertrauenswürdige IPs zulassen
Session-Management: Automatische Abmeldung bei Inaktivität
Audit-Logs: Alle Aktionen werden protokolliert

Integration mit Docker¶

Volume-Mounts¶

Filebrowser kann verschiedene Docker-Volumes mounten:

volumes:
  - postgres_data:/data/postgres:ro # DB-Backups
  - ./backups:/data/backups # Backup-Dateien
  - ./logs:/data/logs:ro # Log-Dateien
  - ./shared:/data/shared # Gemeinsame Dateien

Backup-Integration¶

# Automatische Backups über Filebrowser
- Datenbank-Dumps in /data/postgres
- Anwendungs-Backups in /data/backups
- Log-Dateien in /data/logs

Wartung und Updates¶

Konfiguration sichern¶

# Filebrowser-Konfiguration sichern
docker run --rm -v filebrowser_config:/config -v $(pwd):/backup alpine tar czf /backup/filebrowser_config.tar.gz -C /config .

Update durchführen¶

# Filebrowser aktualisieren
docker compose pull filebrowser
docker compose up -d filebrowser

Fehlerbehebung¶

Häufige Probleme¶

Zugriff verweigert:

Berechtigungen prüfen: ls -la /data
Volume-Mounts korrekt konfiguriert?
Benutzerrechte in Filebrowser prüfen

Dateien nicht sichtbar:

Pfad-Berechtigungen: Container als korrekter User ausführen
Volume-Mounts: docker compose ps filebrowser

Upload-Fehler:

Speicherplatz prüfen: df -h
Dateigrößen-Limits in nginx prüfen
Netzwerk-Konnektivität testen

Debugging¶

# Container-Status
docker compose ps filebrowser

# Logs analysieren
docker compose logs --tail=50 filebrowser

# Volume-Inhalte prüfen
docker exec filebrowser ls -la /data

Erweiterte Konfiguration¶

Kommandozeilen-Optionen¶

Filebrowser kann über Umgebungsvariablen konfiguriert werden:

environment:
  - FB_BASEURL=/filebrowser # Subpath für Reverse Proxy
  - FB_PORT=80 # Interner Port
  - FB_LOG=stdout # Logging

Custom CSS/JS¶

Custom Styles: /config/custom.css
Custom Scripts: /config/custom.js

Dokumentation

Filebrowser: https://filebrowser.org/
Docker Integration: https://docs.docker.com/