Dokumentation

Vollständiger Leitfaden zum Bereitstellen und Verwalten Ihres Galleria-Fotografie-Portfolios.

Erste Schritte

Galleria ist eine moderne Fotografie-Portfolio-Website, die mit React 19, TypeScript, Express 5 und SQLite erstellt wurde. Sie bietet optimierte Bildübertragung, ein Admin-Panel, Analytik-Tracking und responsives Design.

Schnellzugriffe

Google OAuth SSO-Setup

Aktivieren Sie Google OAuth Single Sign-On für sichere, passwortlose Authentifizierung zu Ihrem Galleria-Admin-Panel.

Schritt 1: Google Cloud-Projekt erstellen

  1. Gehen Sie zur Google Cloud-Konsole
  2. Erstellen Sie ein neues Projekt oder wählen Sie ein bestehendes aus
  3. Navigieren Sie zu APIs & Dienste → Anmeldedaten
  4. Klicken Sie auf Anmeldedaten erstellen → OAuth-Client-ID
  5. Wenn Sie dazu aufgefordert werden, konfigurieren Sie zuerst den OAuth-Zustimmungsbildschirm

Schritt 2: OAuth-Client konfigurieren

  1. Wählen Sie Webanwendung als Anwendungstyp
  2. Fügen Sie Ihre Domain zu den autorisierten JavaScript-Ursprüngen hinzu:
    https://yourdomain.com
  3. Fügen Sie die Callback-URL zu den autorisierten Umleitungs-URIs hinzu:
    https://yourdomain.com/api/auth/google/callback
  4. Klicken Sie auf Erstellen und speichern Sie Ihre Anmeldedaten

Schritt 3: In Galleria-Einstellungen konfigurieren

  1. Melden Sie sich bei Ihrem Galleria-Admin-Panel an
  2. Navigieren Sie zu Einstellungen → Google OAuth
  3. Geben Sie Ihre Google-Client-ID ein
  4. Geben Sie Ihr Google-Client-Geheimnis ein
  5. Klicken Sie auf Speichern, um Google OAuth SSO zu aktivieren

Automatische Benutzerkonvertierung: Bestehende Benutzer mit übereinstimmenden E-Mail-Adressen werden automatisch auf die Google OAuth-Authentifizierung umgestellt. Sie können sich sofort nach der Konfiguration von OAuth mit Google anmelden.

Sicherheitstipp: Fügen Sie nur vertrauenswürdige E-Mail-Adressen als Administratorbenutzer hinzu. Sie können den Benutzerzugriff nach der Erstkonfiguration über das Administrationspanel verwalten.

OpenObserve Analytics Setup

OpenObserve bietet leistungsstarke Protokollanalysen und Echtzeitüberwachung für Ihre Galleria-Website mit Geo-Anreicherungsfunktionen.

Schritt 1: Installieren Sie OpenObserve mit Docker

Führen Sie OpenObserve mit Docker Compose aus:

Schritt 2: Dienstkonto erstellen

  1. Greifen Sie auf OpenObserve unter http://localhost:5080 zu
  2. Melden Sie sich mit Ihren Administratoranmeldeinformationen an
  3. Navigieren Sie zu Einstellungen → Dienstkonten
  4. Klicken Sie auf Dienstkonto erstellen
  5. Geben Sie ihm einen Namen (z. B. "galleria-analytics") und weisen Sie die entsprechenden Berechtigungen zu
  6. Kopieren Sie das generierte API-Token für die spätere Verwendung

Schritt 7: Galleria konfigurieren

  1. Melden Sie sich bei Ihrem Galleria-Admin-Panel an
  2. Navigieren Sie zu Einstellungen → Analytik
  3. Geben Sie Ihre OpenObserve-URL ein (z. B. http://localhost:5080)
  4. Geben Sie Ihre Organisations-ID ein
  5. Geben Sie Ihren Stream-Namen (Website) ein
  6. Geben Sie Ihren Benutzernamen (aus Schritt 2) ein
  7. Geben Sie Ihr Passwort ein (das Dienstkonto-Token aus Schritt 2)
  8. Klicken Sie auf Speichern, um die OpenObserve-Analytik zu aktivieren

Erfolg! Ihre Analytik umfasst jetzt geo-angereicherte Daten mit Stadt, Region, Land, ISP und Koordinaten für alle Besucher.

Hardware-Video-Encoding

Galleria unterstützt hardwarebeschleunigtes Video-Encoding für 5-10x schnellere Videoverarbeitung mit Ihrer GPU.

Unterstützte Hardware

NVIDIA GPUs (NVENC)

Docker- und native Unterstützung

Intel Quick Sync (QSV)

Nur native Unterstützung

AMD GPUs (AMF)

Nur native Unterstützung

Apple VideoToolbox

Nur macOS-nativ

Hardware-Encoding aktivieren

  1. Gehe zu Admin-Panel → Einstellungen → Videoqualität
  2. Schalte "Hardware-Transcodierung" auf aktiviert
  3. Die Videoverarbeitung wird jetzt GPU-Beschleunigung verwenden, wenn verfügbar

Produktionsbereitstellung

Verwendung von PM2

Für die Produktionsbereitstellung ohne Docker:

npm run build
npm install -g pm2
pm2 start ecosystem.config.cjs
pm2 save
pm2 startup

Automatisierte Bereitstellung: Pushen Sie in den Master-Branch und GitHub Actions stellt Ihre Änderungen automatisch bereit.

Helfen Sie, diese Dokumentation zu verbessern

Einen Fehler gefunden oder möchten Sie zur Dokumentation beitragen? Wir freuen uns über Beiträge!

Auf GitHub beitragen