Dokumentáció

Teljes útmutató a Galleria fényképportfólió telepítéséhez és kezeléséhez.

Kezdjük

A Galleria egy modern fényképportfólió weboldal, amelyet a React 19, TypeScript, Express 5 és SQLite segítségével építettek. Optimalizált képkiszolgálást, admin panelt, analitikai nyomkövetést és reszponzív dizájnt kínál.

Gyors linkek

Google OAuth SSO beállítása

Engedélyezd a Google OAuth Egyszeri Bejelentkezést a Galleria admin panel biztonságos, jelszó nélküli hitelesítéséhez.

1. lépés: Hozz létre Google Cloud projektet

  1. Lépj a Google Cloud Console-ra
  2. Hozz létre egy új projektet, vagy válassz egy meglévőt
  3. Navigálj az API-k és szolgáltatások → Hitelesítő adatok menüpontra
  4. Kattints a Hitelesítő adatok létrehozása → OAuth kliensazonosító lehetőségre
  5. Ha kérik, először konfiguráld az OAuth hozzájárulási képernyőt

2. lépés: Konfiguráld az OAuth klienst

  1. Válaszd a Webalkalmazás típust
  2. Add hozzá a domainedet az Engedélyezett JavaScript eredetekhez:
    https://yourdomain.com
  3. Add hozzá a visszahívási URL-t az Engedélyezett átirányítási URI-khoz:
    https://yourdomain.com/api/auth/google/callback
  4. Kattints a Létrehozásra és mentsd el a hitelesítő adataidat

3. lépés: Konfigurálás a Galleria beállításokban

  1. Jelentkezz be a Galleria admin panelre
  2. Navigálj a Beállítások → Google OAuth menüpontra
  3. Írd be a Google Ügyfélazonosítódat
  4. Írd be a Google Ügyféltitkosítódat
  5. Kattints a Mentés gombra a Google OAuth SSO engedélyezéséhez

Automatikus Felhasználó Átalakítás: A meglévő felhasználók, akiknek az e-mail címe megegyezik, automatikusan Google OAuth hitelesítésre lesznek átalakítva. Az OAuth konfigurálása után azonnal be tudnak jelentkezni Google-lal.

Biztonsági Tipp: Csak megbízható e-mail címeket adj hozzá adminisztrátor felhasználókként. A felhasználói hozzáférést az admin panelen kezelheted az első beállítás után.

OpenObserve Analytics Beállítás

Az OpenObserve hatékony naplóanalitikát és valós idejű megfigyelést biztosít a Galleria weboldalad számára geo-gazdagító képességekkel.

1. lépés: Telepítsd az OpenObserve-t Dockerrel

Futtasd az OpenObserve-t Docker Compose segítségével:

2. lépés: Hozz létre Szolgáltatás Fiókot

  1. Érd el az OpenObserve-t a http://localhost:5080 címen
  2. Jelentkezz be adminisztrátori hitelesítő adataiddal
  3. Navigálj a Beállítások → Szolgáltatás Fiókok menüpontra
  4. Kattints a Szolgáltatás Fiók Létrehozása gombra
  5. Adj neki egy nevet (pl. "galleria-analytics") és rendelj hozzá megfelelő jogosultságokat
  6. Másold ki a generált API tokent későbbi használatra

7. lépés: Galleria konfigurálása

  1. Jelentkezzen be a Galleria adminisztrációs paneljére
  2. Navigáljon a Beállítások → Analitika menüpontra
  3. Adja meg az OpenObserve URL-jét (pl.: http://localhost:5080)
  4. Adja meg a Szervezet azonosítóját
  5. Adja meg a Stream nevét (weboldal)
  6. Adja meg a Felhasználónevét (a 2. lépésből)
  7. Adja meg a Jelszavát (a 2. lépésből származó szolgáltatásfiók token)
  8. Kattintson a Mentés gombra az OpenObserve analitika engedélyezéséhez

Siker! Az Ön analitikája mostantól geo-gazdagított adatokat tartalmaz a városról, régióról, országról, internetszolgáltatóról és koordinátákról minden látogató számára.

Hardveres videó kódolás

A Galleria hardveres gyorsítású videó kódolást támogat, amely 5-10x gyorsabb videófeldolgozást tesz lehetővé a GPU-jának használatával.

Támogatott hardver

NVIDIA GPU-k (NVENC)

Docker és natív támogatás

Intel Quick Sync (QSV)

Csak natív támogatás

AMD GPU-k (AMF)

Csak natív támogatás

Apple VideoToolbox

Csak macOS natív

Hardveres kódolás engedélyezése

  1. Menjen az Admin Panel → Beállítások → Videóminőség menüpontra
  2. Kapcsolja "Hardveres átkódolás" engedélyezésre
  3. A videófeldolgozás mostantól GPU gyorsítást fog használni, ha elérhető

Termelési telepítés

PM2 használata

Termelési telepítés Docker nélkül:

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

Automatizált telepítés: Push a master ágba, és a GitHub Actions automatikusan telepíti a változtatásait.

Segítsen javítani ezt a dokumentációt

Hibát találtál, vagy szeretnél hozzájárulni a dokumentációhoz? Üdvözöljük a hozzájárulásokat!

Hozzájárulás a GitHub-on