Dokumentacija

Potpuni vodič za implementaciju i upravljanje vašim Galleria sajtom za fotografije.

Uvod

Galleria je savremeni sajt za fotografije izgrađen sa React 19, TypeScript, Express 5 i SQLite. Sadrži optimizovanu isporuku slika, administratorski panel, praćenje analitike i responzivni dizajn.

Brze veze

Podešavanje Google OAuth SSO

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

Korak 1: Kreirajte Google Cloud projekat

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

Korak 2: Konfigurišite OAuth klijenta

  1. Odaberite Web aplikaciju kao tip aplikacije
  2. Dodajte svoju domenu u Ovlašćene JavaScript izvore:
    https://yourdomain.com
  3. Dodajte URL za povratak u Ovlašćene preusmerene URI-je:
    https://yourdomain.com/api/auth/google/callback
  4. Kliknite na Kreiraj i sačuvajte svoje kredencijale

Korak 3: Konfigurišite u Galleria podešavanjima

  1. Prijavite se na vaš Galleria administratorski panel
  2. Idite na Podešavanja → Google OAuth
  3. Unesite svoj Google Client ID
  4. Unesite svoj Google Client Secret
  5. Kliknite na Sačuvaj da omogućite Google OAuth SSO

Automatska konverzija korisnika: Postojeći korisnici sa odgovarajućim email adresama biće automatski konvertovani na Google OAuth autentifikaciju. Mogu se prijaviti sa Google-om odmah nakon što je OAuth konfigurisan.

Savjet za sigurnost: Dodajte samo pouzdane email adrese kao admin korisnike. Možete upravljati pristupom korisnika iz admin panela nakon inicijalne postavke.

Postavka OpenObserve Analytics

OpenObserve pruža moćnu analitiku logova i praćenje u realnom vremenu za vašu Galleria veb stranicu sa mogućnostima geo-obogaćivanja.

Korak 1: Instalirajte OpenObserve sa Docker-om

Pokrenite OpenObserve koristeći Docker Compose:

Korak 2: Kreirajte servisni nalog

  1. Pristupite OpenObserve na http://localhost:5080
  2. Prijavite se sa svojim admin akreditivima
  3. Idite na Podešavanja → Servisni nalozi
  4. Kliknite na Kreiraj servisni nalog
  5. Dajte mu ime (npr., "galleria-analytics") i dodelite odgovarajuće dozvole
  6. Kopirajte generisani API token za kasniju upotrebu

Korak 7: Konfigurišite Galleriju

  1. Prijavite se na svoj Galleria administratorski panel
  2. Idite na Podešavanja → Analitika
  3. Unesite svoj OpenObserve URL (npr., http://localhost:5080)
  4. Unesite svoj ID organizacije
  5. Unesite ime svog strima (vебсајт)
  6. Unesite svoje korisničko ime (iz koraka 2)
  7. Unesite svoju lozinku (token servisnog naloga iz koraka 2)
  8. Kliknite na Sačuvaj da omogućite OpenObserve analitiku

Uspeh! Vaša analitika će sada uključivati geo-obogaćene podatke sa gradom, regionom, državom, ISP-om i koordinatama za sve posetioce.

Hardversko kodiranje videa

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

Podržani hardver

NVIDIA GPU-ovi (NVENC)

Docker i nativna podrška

Intel Quick Sync (QSV)

Samo nativna podrška

AMD GPU (AMF)

Samo nativna podrška

Apple VideoToolbox

Samo macOS nativno

Omogućite hardversko kodiranje

  1. Idite na Administratorski panel → Podešavanja → Kvalitet videa
  2. Prebacite "Hardversko transkodiranje" na omogućeno
  3. Obrada videa će sada koristiti GPU akceleraciju kada je dostupna

Proizvodna implementacija

Korišćenje PM2

Za proizvodnu implementaciju bez Dockera:

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

Automatizovana implementacija: Pritisnite na master granu i GitHub Actions automatski implementira vaše promene.

Pomozite da poboljšamo ovu dokumentaciju

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

Doprinosite na GitHub-u