Dokumentation

Komplet guide til implementering og administration af din Galleria fotografportfolio.

Kom godt i gang

Galleria er et moderne fotografportfolio-site bygget med React 19, TypeScript, Express 5 og SQLite. Det har optimeret billedlevering, adminpanel, analyseovervĂĄgning og responsivt design.

Hurtige links

Google OAuth SSO Opsætning

Aktivér Google OAuth Single Sign-On for sikker, passwordløs autentificering til dit Galleria admin panel.

Trin 1: Opret Google Cloud Projekt

  1. GĂĄ til Google Cloud Console
  2. Opret et nyt projekt eller vælg et eksisterende
  3. Naviger til API'er & Tjenester → Legitimation
  4. Klik på Opret Legitimation → OAuth klient-ID
  5. Hvis du bliver bedt om det, skal du først konfigurere OAuth samtykkeskærmen

Trin 2: Konfigurer OAuth Klient

  1. Vælg Webapplikation som applikationstype
  2. Tilføj dit domæne til Autoriserede JavaScript oprindelser:
    https://yourdomain.com
  3. Tilføj callback-URL'en til Autoriserede omdirigerings-URI'er:
    https://yourdomain.com/api/auth/google/callback
  4. Klik pĂĄ Opret og gem dine legitimationsoplysninger

Trin 3: Konfigurer i Galleria Indstillinger

  1. Log ind pĂĄ dit Galleria admin panel
  2. Naviger til Indstillinger → Google OAuth
  3. Indtast dit Google Client ID
  4. Indtast dit Google Client Secret
  5. Klik pĂĄ Gem for at aktivere Google OAuth SSO

Automatisk brugerkonvertering: Eksisterende brugere med matchende e-mailadresser vil automatisk blive konverteret til Google OAuth-godkendelse. De kan logge ind med Google straks efter, at OAuth er konfigureret.

Sikkerhedstips: Tilføj kun betroede e-mailadresser som admin-brugere. Du kan administrere brugeradgang fra adminpanelet efter den indledende opsætning.

OpenObserve Analytics Opsætning

OpenObserve leverer kraftfuld loganalyse og realtidsmonitorering til dit Galleria-websted med geo-berigelsesfunktioner.

Trin 1: Installer OpenObserve med Docker

Kør OpenObserve ved hjælp af Docker Compose:

Trin 2: Opret tjenestekonto

  1. FĂĄ adgang til OpenObserve pĂĄ http://localhost:5080
  2. Log ind med dine admin-oplysninger
  3. Naviger til Indstillinger → Tjenestekonti
  4. Klik pĂĄ Opret tjenestekonto
  5. Giv den et navn (f.eks. "galleria-analytics") og tildel passende tilladelser
  6. Kopier den genererede API-token til senere brug

Trin 7: Konfigurer Galleria

  1. Log ind pĂĄ din Galleria adminpanel
  2. Naviger til Indstillinger → Analyse
  3. Indtast din OpenObserve URL (f.eks. http://localhost:5080)
  4. Indtast dit Organisations-ID
  5. Indtast dit Stream Navn (websted)
  6. Indtast dit Brugernavn (fra Trin 2)
  7. Indtast din Adgangskode (servicetokens fra Trin 2)
  8. Klik pĂĄ Gem for at aktivere OpenObserve-analyse

Succes! Din analyse vil nu inkludere geo-berigede data med by, region, land, ISP og koordinater for alle besøgende.

Hardware Video Kodning

Galleria understøtter hardware-accelereret videokodning for 5-10x hurtigere videobehandling ved hjælp af din GPU.

Understøttet Hardware

NVIDIA GPU'er (NVENC)

Docker og indbygget support

Intel Quick Sync (QSV)

Kun indbygget support

AMD GPU'er (AMF)

Kun native support

Apple VideoToolbox

Kun macOS native

Aktiver Hardware Kodning

  1. Gå til Admin Panel → Indstillinger → Video Kvalitet
  2. Skift "Hardware Transcoding" til aktiveret
  3. Videobehandling vil nu bruge GPU acceleration når det er tilgængeligt

Produktion Udrulning

Brug af PM2

Til produktion udrulning uden Docker:

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

Automatiseret Udrulning: Push til master branch og GitHub Actions udruller automatisk dine ændringer.

Hjælp med at forbedre denne dokumentation

Har du fundet en fejl eller ønsker at bidrage til dokumentationen? Vi byder bidrag velkommen!

Bidrag pĂĄ GitHub