Dokumentasjon

Fullstendig guide til distribusjon og administrasjon av din Galleria fotografportefølje.

Kom i gang

Galleria er et moderne fotografportefølje nettsted bygget med React 19, TypeScript, Express 5, og SQLite. Det har optimalisert bildelevering, adminpanel, analyseoppfølging, og responsiv design.

Hurtiglenker

Google OAuth SSO-oppsett

Aktiver Google OAuth Single Sign-On for sikker, passordløs autentisering til Galleria-administrasjonspanelet.

Trinn 1: Opprett Google Cloud-prosjekt

  1. Gå til Google Cloud Console
  2. Opprett et nytt prosjekt eller velg et eksisterende
  3. Naviger til APIer & Tjenester → Legitimasjon
  4. Klikk på Opprett legitimasjon → OAuth-klient-ID
  5. Hvis du blir bedt om det, konfigurer OAuth-samtykkeskjermen først

Trinn 2: Konfigurer OAuth-klient

  1. Velg Nettapplikasjon som applikasjonstype
  2. Legg til domenet ditt i Autoriserte JavaScript-opprinnelser:
    https://yourdomain.com
  3. Legg til tilbakeringings-URL i Autoriserte omdirigerings-URIer:
    https://yourdomain.com/api/auth/google/callback
  4. Klikk på Opprett og lagre legitimasjonen din

Trinn 3: Konfigurer i Galleria-innstillinger

  1. Logg inn på Galleria-administrasjonspanelet ditt
  2. Naviger til Innstillinger → Google OAuth
  3. Skriv inn din Google Client ID
  4. Skriv inn din Google Client Secret
  5. Klikk Lagre for å aktivere Google OAuth SSO

Automatisk brukerkonvertering: Eksisterende brukere med matchende e-postadresser vil automatisk bli konvertert til Google OAuth-autentisering. De kan logge inn med Google umiddelbart etter at OAuth er konfigurert.

Sikkerhetstips: Legg kun til pålitelige e-postadresser som admin-brukere. Du kan administrere brukeradgang fra administrasjonspanelet etter den innledende oppsett.

OpenObserve Analytics Oppsett

OpenObserve gir kraftig logganalyse og sanntidsovervåking for ditt Galleria-nettsted med geo-berikelsesmuligheter.

Trinn 1: Installer OpenObserve med Docker

Kjør OpenObserve ved hjelp av Docker Compose:

Trinn 2: Opprett tjenestekonto

  1. Få tilgang til OpenObserve på http://localhost:5080
  2. Logg inn med dine admin-legitimasjon
  3. Naviger til Innstillinger → Tjenestekontoer
  4. Klikk Opprett tjenestekonto
  5. Gi den et navn (f.eks. "galleria-analytics") og tildel passende tillatelser
  6. Kopier den genererte API-token for senere bruk

Trinn 7: Konfigurer Galleria

  1. Logg inn på Galleria adminpanelet
  2. Naviger til Innstillinger → Analyse
  3. Skriv inn din OpenObserve-URL (f.eks., http://localhost:5080)
  4. Skriv inn din Organisasjons-ID
  5. Skriv inn ditt Strømnavn (nettsted)
  6. Skriv inn ditt Brukernavn (fra Trinn 2)
  7. Skriv inn ditt Passord (tjenestekonto-token fra Trinn 2)
  8. Klikk Lagre for å aktivere OpenObserve-analyse

Suksess! Din analyse vil nå inkludere geo-beriket data med by, region, land, ISP og koordinater for alle besøkende.

Maskinvare Videokoding

Galleria støtter maskinvareakselerert videokoding for 5-10x raskere videobehandling ved hjelp av GPU-en din.

Støttet maskinvare

NVIDIA GPU-er (NVENC)

Docker og innebygd støtte

Intel Quick Sync (QSV)

Kun innebygd støtte

AMD GPU-er (AMF)

Kun innebygd støtte

Apple VideoToolbox

Kun macOS innebygd

Aktiver maskinvarekoding

  1. Gå til Admin-panel → Innstillinger → Videokvalitet
  2. Slå "Maskinvaretranskoding" til aktivert
  3. Videobehandling vil nå bruke GPU-akselerasjon når det er tilgjengelig

Produksjonsdistribusjon

Bruke PM2

For produksjonsdistribusjon uten Docker:

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

Automatisert distribusjon: Push til master-grenen og GitHub Actions distribuerer automatisk endringene dine.

Hjelp med å forbedre denne dokumentasjonen

Fant du en feil eller ønsker å bidra til dokumentasjonen? Vi ønsker bidrag velkommen!

Bidra på GitHub