Documentatie

Volledige gids voor het implementeren en beheren van je Galleria fotografie portfolio.

Aan de slag

Galleria is een moderne fotografie portfolio website gebouwd met React 19, TypeScript, Express 5 en SQLite. Het biedt geoptimaliseerde afbeeldingslevering, een beheerderspaneel, analytics tracking en responsief ontwerp.

Snelle Links

Google OAuth SSO Setup

Schakel Google OAuth Single Sign-On in voor veilige, wachtwoordloze authenticatie voor uw Galleria-beheerpaneel.

Stap 1: Maak een Google Cloud Project aan

  1. Ga naar de Google Cloud Console
  2. Maak een nieuw project aan of selecteer een bestaand project
  3. Navigeer naar API's & Services → Referenties
  4. Klik op Maak referenties → OAuth-client-ID
  5. Als u wordt gevraagd, configureer dan eerst het OAuth-toestemmingsscherm

Stap 2: Configureer OAuth-client

  1. Selecteer Webtoepassing als het type toepassing
  2. Voeg uw domein toe aan Geautoriseerde JavaScript-oorsprongen:
    https://yourdomain.com
  3. Voeg de callback-URL toe aan Geautoriseerde omleidings-URI's:
    https://yourdomain.com/api/auth/google/callback
  4. Klik op Maken en sla uw referenties op

Stap 3: Configureer in Galleria-instellingen

  1. Log in op uw Galleria-beheerpaneel
  2. Navigeer naar Instellingen → Google OAuth
  3. Voer uw Google Client ID in
  4. Voer uw Google Client Secret in
  5. Klik op Opslaan om Google OAuth SSO in te schakelen

Automatische gebruikersconversie: Bestaande gebruikers met overeenkomende e-mailadressen worden automatisch omgezet naar Google OAuth-authenticatie. Ze kunnen zich onmiddellijk aanmelden met Google nadat OAuth is geconfigureerd.

Veiligheidstip: Voeg alleen vertrouwde e-mailadressen toe als beheerders. U kunt de gebruikerstoegang beheren vanuit het beheerderspaneel na de initiële setup.

OpenObserve Analytics Setup

OpenObserve biedt krachtige loganalyse en realtime monitoring voor uw Galleria-website met geo-verrijkingsmogelijkheden.

Stap 1: Installeer OpenObserve met Docker

Voer OpenObserve uit met Docker Compose:

Stap 2: Maak een serviceaccount aan

  1. Toegang tot OpenObserve op http://localhost:5080
  2. Log in met uw beheerdersgegevens
  3. Navigeer naar Instellingen → Serviceaccounts
  4. Klik op Serviceaccount aanmaken
  5. Geef het een naam (bijv. "galleria-analytics") en wijs de juiste machtigingen toe
  6. Kopieer de gegenereerde API-token voor later gebruik

Stap 7: Configureer Galleria

  1. Log in op uw Galleria-beheerpaneel
  2. Navigeer naar Instellingen → Analyse
  3. Voer uw OpenObserve-URL in (bijv. http://localhost:5080)
  4. Voer uw Organisatie-ID in
  5. Voer uw Streamnaam (website) in
  6. Voer uw Gebruikersnaam in (van Stap 2)
  7. Voer uw Wachtwoord in (de service-accounttoken van Stap 2)
  8. Klik op Opslaan om OpenObserve-analyse in te schakelen

Succes! Uw analyse bevat nu geo-verrijkte gegevens met stad, regio, land, ISP en coördinaten voor alle bezoekers.

Hardware Video Codering

Galleria ondersteunt hardware-versnelde video codering voor 5-10x snellere videoverwerking met behulp van uw GPU.

Ondersteunde Hardware

NVIDIA GPU's (NVENC)

Docker en native ondersteuning

Intel Quick Sync (QSV)

Alleen native ondersteuning

AMD GPU's (AMF)

Alleen native ondersteuning

Apple VideoToolbox

Alleen macOS native

Hardware-encoding inschakelen

  1. Ga naar Admin Paneel → Instellingen → Videokwaliteit
  2. Schakel "Hardware Transcoding" in
  3. Videobewerking zal nu GPU-versnelling gebruiken wanneer beschikbaar

Productie-implementatie

Gebruik PM2

Voor productie-implementatie zonder Docker:

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

Geautomatiseerde implementatie: Push naar de masterbranch en GitHub Actions implementeert automatisch je wijzigingen.

Help deze documentatie te verbeteren

Een fout gevonden of wil je bijdragen aan de documentatie? We verwelkomen bijdragen!

Bijdragen op GitHub