Dokumentacija

Potpuni vodič za implementaciju i upravljanje vašim Galleria portfeljem fotografija.

Uvod

Galleria je moderna web stranica portfelja fotografija izgrađena s React 19, TypeScript, Express 5 i SQLite. Sadrži optimiziranu isporuku slika, administratorsku ploču, praćenje analitike i responzivni dizajn.

Brze veze

Postavljanje Google OAuth SSO-a

Omogućite Google OAuth jedinstveno prijavljivanje za sigurnu, bez lozinke autentifikaciju na vaš Galleria administratorski panel.

Korak 1: Kreirajte Google Cloud projekt

  1. Idite na Google Cloud konzolu
  2. Kreirajte novi projekt ili odaberite postojeći
  3. Idite na API-je i usluge → Kredencijali
  4. Kliknite na Kreiraj kredencijale → OAuth klijentski ID
  5. Ako se zatraži, prvo konfigurirajte OAuth ekran za pristanak

Korak 2: Konfigurirajte OAuth klijenta

  1. Odaberite Web aplikaciju kao vrstu aplikacije
  2. Dodajte svoju domenu u Ovlaštene JavaScript izvore:
    https://yourdomain.com
  3. Dodajte URL za povratak u Ovlaštene preusmjerene URI-e:
    https://yourdomain.com/api/auth/google/callback
  4. Kliknite na Kreiraj i spremite svoje kredencijale

Korak 3: Konfigurirajte u Galleria postavkama

  1. Prijavite se na svoj Galleria administratorski panel
  2. Idite na Postavke → Google OAuth
  3. Unesite svoj Google Client ID
  4. Unesite svoj Google Client Secret
  5. Kliknite Spremi za omogućavanje Google OAuth SSO

Automatska konverzija korisnika: Postojeći korisnici s odgovarajućim adresama e-pošte bit će automatski pretvoreni u Google OAuth autentifikaciju. Mogu se prijaviti s Googleom odmah nakon što je OAuth konfiguriran.

Savjet za sigurnost: Dodajte samo pouzdane adrese e-pošte kao administratore. Možete upravljati pristupom korisnika iz administratorske ploče nakon početne postavke.

Postavljanje OpenObserve Analytics

OpenObserve pruža moćnu analizu dnevnika i praćenje u stvarnom vremenu za vašu Galleria web stranicu s mogućnostima geo-obogaćivanja.

Korak 1: Instalirajte OpenObserve s Dockerom

Pokrenite OpenObserve koristeći Docker Compose:

Korak 2: Kreirajte servisni račun

  1. Pristupite OpenObserve na http://localhost:5080
  2. Prijavite se sa svojim administratorskim vjerodajnicama
  3. Idite na Postavke → Servisni računi
  4. Kliknite Kreiraj servisni račun
  5. Dajte mu ime (npr., "galleria-analytics") i dodijelite odgovarajuće dozvole
  6. Kopirajte generirani API token za kasniju upotrebu

Korak 7: Konfigurirajte Galleriju

  1. Prijavite se u svoj Galleria administratorski panel
  2. Idite na Postavke → Analitika
  3. Unesite svoj OpenObserve URL (npr., http://localhost:5080)
  4. Unesite svoj ID organizacije
  5. Unesite svoje ime struje (web stranica)
  6. Unesite svoje korisničko ime (iz Koraka 2)
  7. Unesite svoju lozinku (token uslužnog računa iz Koraka 2)
  8. Kliknite Spremi za omogućavanje OpenObserve analitike

Uspjeh! Vaša analitika sada će uključivati geo-obogaćene podatke s gradom, regijom, državom, ISP-om i koordinatama za sve posjetitelje.

Hardversko video kodiranje

Galleria podržava hardverski ubrzano video kodiranje za 5-10x brže procesiranje videa koristeći vašu GPU.

Podržani hardver

NVIDIA GPU-ovi (NVENC)

Docker i izvorna podrška

Intel Quick Sync (QSV)

Samo izvorna podrška

AMD GPU-ovi (AMF)

Samo izvorna podrška

Apple VideoToolbox

Samo izvorno na macOS-u

Omogući hardversko kodiranje

  1. Idite na Administratorsku ploču → Postavke → Kvaliteta videa
  2. Prebacite "Hardversko transkodiranje" na omogućeno
  3. Obrada videa će sada koristiti GPU akceleraciju kada je dostupna

Proizvodno implementiranje

Korištenje PM2

Za proizvodno implementiranje bez Dockera:

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

Automatizirano implementiranje: Pritisnite na glavnu granu i GitHub Actions automatski implementira vaše promjene.

Pomozite poboljšati ovu dokumentaciju

Pronašli ste grešku ili želite doprinijeti dokumentaciji? Dobrodošli su doprinosi!

Doprinosite na GitHubu