Dokumentácia

Kompletný sprievodca nasadením a správou vášho fotografického portfólia Galleria.

Začíname

Galleria je moderná webová stránka fotografického portfólia postavená na React 19, TypeScript, Express 5 a SQLite. Obsahuje optimalizované doručovanie obrázkov, administrátorský panel, sledovanie analytiky a responzívny dizajn.

Rýchle odkazy

Nastavenie Google OAuth SSO

Povoľte Google OAuth Single Sign-On pre bezpečnú, bezheslovú autentifikáciu do vášho administrátorského panela Galleria.

Krok 1: Vytvorte projekt Google Cloud

  1. Prejdite do Google Cloud Console
  2. Vytvorte nový projekt alebo vyberte existujúci
  3. Prejdite na API a služby → Oprávnenia
  4. Kliknite na Vytvoriť oprávnenia → OAuth klient ID
  5. Ak budete vyzvaní, najprv nakonfigurujte obrazovku súhlasu OAuth

Krok 2: Nakonfigurujte OAuth klienta

  1. Vyberte Webová aplikácia ako typ aplikácie
  2. Pridajte svoju doménu do Oprávnených JavaScript pôvodov:
    https://yourdomain.com
  3. Pridajte URL spätného volania do Oprávnených presmerovacích URI:
    https://yourdomain.com/api/auth/google/callback
  4. Kliknite na Vytvoriť a uložte svoje oprávnenia

Krok 3: Nakonfigurujte v nastaveniach Galleria

  1. Prihláste sa do svojho administrátorského panela Galleria
  2. Prejdite na Nastavenia → Google OAuth
  3. Zadajte svoj Google Client ID
  4. Zadajte svoj Google Client Secret
  5. Kliknite na Uložiť, aby ste povolili Google OAuth SSO

Automatická konverzia používateľov: Existujúci používatelia s rovnakými e-mailovými adresami budú automaticky prevedení na autentifikáciu Google OAuth. Môžu sa prihlásiť pomocou Google ihneď po nakonfigurovaní OAuth.

Tip na zabezpečenie: Pridávajte iba dôveryhodné e-mailové adresy ako administrátorov. Prístup používateľov môžete spravovať z administrátorského panela po počiatočnom nastavení.

Nastavenie OpenObserve Analytics

OpenObserve poskytuje výkonnú analýzu protokolov a monitorovanie v reálnom čase pre vašu webovú stránku Galleria s možnosťami geo-obohatenia.

Krok 1: Nainštalujte OpenObserve pomocou Dockeru

Spustite OpenObserve pomocou Docker Compose:

Krok 2: Vytvorte servisný účet

  1. Prístup k OpenObserve na http://localhost:5080
  2. Prihláste sa pomocou svojich administrátorských poverení
  3. Prejdite na Nastavenia → Servisné účty
  4. Kliknite na Vytvoriť servisný účet
  5. Dajte mu názov (napr. "galleria-analytics") a priraďte vhodné oprávnenia
  6. Skopírujte vygenerovaný API token na neskoršie použitie

Krok 7: Konfigurácia Galleria

  1. Prihláste sa do svojho administračného panela Galleria
  2. Prejdite na Nastavenia → Analytika
  3. Zadajte svoju URL adresu OpenObserve (napr. http://localhost:5080)
  4. Zadajte svoje ID organizácie
  5. Zadajte názov svojho streamu (webová stránka)
  6. Zadajte svoje používateľské meno (z Kroku 2)
  7. Zadajte svoje heslo (token servisného účtu z Kroku 2)
  8. Kliknite na Uložiť, aby ste povolili analytiku OpenObserve

Úspech! Vaša analytika teraz bude obsahovať geoobohatené údaje s mestom, regiónom, krajinou, ISP a súradnicami pre všetkých návštevníkov.

Hardvérové video kódovanie

Galleria podporuje hardvérom akcelerované video kódovanie pre 5-10x rýchlejšie spracovanie videa pomocou vašej GPU.

Podporovaný hardvér

NVIDIA GPU (NVENC)

Podpora Docker a natívna podpora

Intel Quick Sync (QSV)

Iba natívna podpora

AMD GPU (AMF)

Iba natívna podpora

Apple VideoToolbox

Iba natívne pre macOS

Povoliť hardvérové kódovanie

  1. Prejdite na Admin Panel → Nastavenia → Kvalita videa
  2. Prepnite "Hardvérové transkódovanie" na povolené
  3. Spracovanie videa teraz použije akceleráciu GPU, keď je k dispozícii

Nasadenie do produkcie

Použitie PM2

Pre nasadenie do produkcie bez Dockera:

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

Automatizované nasadenie: Push na hlavnú vetvu a GitHub Actions automaticky nasadí vaše zmeny.

Pomôžte zlepšiť túto dokumentáciu

Našli ste chybu alebo chcete prispieť do dokumentácie? Vitajte s príspevkami!

Prispieť na GitHub