Dokumentace

Kompletní průvodce nasazením a správou vašeho fotografického portfolia Galleria.

Začínáme

Galleria je moderní webová stránka fotografického portfolia postavená na React 19, TypeScript, Express 5 a SQLite. Nabízí optimalizované doručování obrázků, administrační panel, sledování analytiky a responzivní design.

Rychlé odkazy

Nastavení Google OAuth SSO

Povolit Google OAuth Single Sign-On pro bezpečnou, bezheslovou autentizaci do vašeho administrátorského panelu Galleria.

Krok 1: Vytvořte projekt Google Cloud

  1. Přejděte do Google Cloud Console
  2. Vytvořte nový projekt nebo vyberte existující
  3. Přejděte na API a služby → Oprávnění
  4. Klikněte na Vytvořit oprávnění → OAuth klientské ID
  5. Pokud budete vyzváni, nejprve nakonfigurujte obrazovku souhlasu OAuth

Krok 2: Nakonfigurujte OAuth klienta

  1. Vyberte Webová aplikace jako typ aplikace
  2. Přidejte svou doménu do Oprávněných JavaScriptových původů:
    https://yourdomain.com
  3. Přidejte URL pro zpětné volání do Oprávněných přesměrovacích URI:
    https://yourdomain.com/api/auth/google/callback
  4. Klikněte na Vytvořit a uložte své oprávnění

Krok 3: Nakonfigurujte v nastavení Galleria

  1. Přihlaste se do svého administrátorského panelu Galleria
  2. Přejděte na Nastavení → Google OAuth
  3. Zadejte své Google Client ID
  4. Zadejte své Google Client Secret
  5. Klikněte na Uložit pro povolení Google OAuth SSO

Automatická konverze uživatelů: Existující uživatelé s odpovídajícími e-mailovými adresami budou automaticky převedeni na autentizaci Google OAuth. Mohou se přihlásit pomocí Google ihned po konfiguraci OAuth.

Tip na zabezpečení: Přidávejte pouze důvěryhodné e-mailové adresy jako administrátory. Přístup uživatelů můžete spravovat z administrátorského panelu po počátečním nastavení.

Nastavení OpenObserve Analytics

OpenObserve poskytuje výkonnou analýzu protokolů a sledování v reálném čase pro vaši webovou stránku Galleria s možnostmi geo-obohacení.

Krok 1: Nainstalujte OpenObserve pomocí Dockeru

Spusťte OpenObserve pomocí Docker Compose:

Krok 2: Vytvořte servisní účet

  1. Přístup k OpenObserve na http://localhost:5080
  2. Přihlaste se pomocí svých administrátorských přihlašovacích údajů
  3. Přejděte na Nastavení → Servisní účty
  4. Klikněte na Vytvořit servisní účet
  5. Dejte mu název (např. "galleria-analytics") a přiřaďte vhodná oprávnění
  6. Zkopírujte vygenerovaný API token pro pozdější použití

Krok 7: Nakonfigurujte Galleria

  1. Přihlaste se do svého administračního panelu Galleria
  2. Přejděte na Nastavení → Analytika
  3. Zadejte svou URL adresu OpenObserve (např. http://localhost:5080)
  4. Zadejte své ID organizace
  5. Zadejte název svého streamu (webová stránka)
  6. Zadejte své uživatelské jméno (z Kroku 2)
  7. Zadejte své heslo (token služby z Kroku 2)
  8. Klikněte na Uložit pro povolení analytiky OpenObserve

Úspěch! Vaše analytika nyní zahrnuje geoobohacená data s městem, regionem, zemí, ISP a souřadnicemi pro všechny návštěvníky.

Hardwarové video kódování

Galleria podporuje hardwarově akcelerované video kódování pro 5-10x rychlejší zpracování videa pomocí vaší GPU.

Podporovaný hardware

NVIDIA GPU (NVENC)

Podpora Dockeru a nativní podpora

Intel Quick Sync (QSV)

Pouze nativní podpora

AMD GPU (AMF)

Pouze nativní podpora

Apple VideoToolbox

Pouze nativní macOS

Povolit hardwarové kódování

  1. Přejděte na Administrátorský panel → Nastavení → Kvalita videa
  2. Přepněte "Hardwarové transkódování" na povoleno
  3. Zpracování videa nyní využije akceleraci GPU, pokud je k dispozici

Nasazení do produkce

Použití PM2

Pro nasazení do produkce bez Dockeru:

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

Automatizované nasazení: Push na hlavní větev a GitHub Actions automaticky nasadí vaše změny.

Pomozte zlepšit tuto dokumentaci

Našli jste chybu nebo chcete přispět k dokumentaci? Vítáme příspěvky!

Přispět na GitHubu