Dokumentacija

Celovit vodnik za uvajanje in upravljanje vašega portfelja fotografij Galleria.

Začetek

Galleria je moderna spletna stran portfelja fotografij, zgrajena z React 19, TypeScript, Express 5 in SQLite. Ponuja optimizirano dostavo slik, administrativno ploščo, sledenje analitiki in odziven dizajn.

Hitre povezave

Nastavitev Google OAuth SSO

Omogočite Google OAuth enotno prijavo za varno, brezgeselno avtentikacijo v vašem Galleria administrativnem panelu.

Korak 1: Ustvarite Google Cloud projekt

  1. Pojdite na Google Cloud Console
  2. Ustvarite nov projekt ali izberite obstoječega
  3. Pojdite na API-ji in storitve → Kredenciali
  4. Kliknite Ustvari kredenciale → OAuth ID stranke
  5. Če vas pozove, najprej konfigurirajte zaslon za soglasje OAuth

Korak 2: Konfigurirajte OAuth stranko

  1. Izberite spletno aplikacijo kot vrsto aplikacije
  2. Dodajte svojo domeno v Pooblaščene JavaScript izvore:
    https://yourdomain.com
  3. Dodajte URL za preusmeritev v Pooblaščene preusmeritvene URI:
    https://yourdomain.com/api/auth/google/callback
  4. Kliknite Ustvari in shranite svoje kredenciale

Korak 3: Konfigurirajte v nastavitvah Galleria

  1. Prijavite se v svoj Galleria administrativni panel
  2. Pojdite na Nastavitve → Google OAuth
  3. Vnesite svoj Google Client ID
  4. Vnesite svoj Google Client Secret
  5. Kliknite Shrani, da omogočite Google OAuth SSO

Samodejna pretvorba uporabnikov: Obstoječi uporabniki z ujemajočimi se e-poštnimi naslovi bodo samodejno pretvorjeni v Google OAuth avtentikacijo. V Google se lahko prijavijo takoj, ko je OAuth konfiguriran.

Varnostni nasvet: Dodajte samo zaupanja vredne e-poštne naslove kot skrbniške uporabnike. Dostop uporabnikov lahko upravljate iz skrbniškega panela po začetni nastavitvi.

Nastavitev OpenObserve Analytics

OpenObserve zagotavlja močno analitiko dnevnikov in spremljanje v realnem času za vašo spletno stran Galleria z zmogljivostmi geoinformacij.

Korak 1: Namestite OpenObserve z Dockerjem

Zaženite OpenObserve z uporabo Docker Compose:

Korak 2: Ustvarite storitveno računa

  1. Dostopajte do OpenObserve na http://localhost:5080
  2. Prijavite se s svojimi skrbniškimi poverilnicami
  3. Pojdite na Nastavitve → Storitveni računi
  4. Kliknite Ustvari storitveni račun
  5. Dajte mu ime (npr. "galleria-analytics") in dodelite ustrezna dovoljenja
  6. Kopirajte ustvarjeni API žeton za kasnejšo uporabo

Korak 7: Konfigurirajte Gallerijo

  1. Prijavite se v svoj administrativni panel Gallerije
  2. Pojdite na Nastavitve → Analitika
  3. Vnesite svoj OpenObserve URL (npr. http://localhost:5080)
  4. Vnesite svoj ID organizacije
  5. Vnesite ime svojega toka (spletna stran)
  6. Vnesite svoje uporabniško ime (iz koraka 2)
  7. Vnesite svojo geslo (žeton storitvenega računa iz koraka 2)
  8. Kliknite Shrani, da omogočite OpenObserve analitiko

Uspešno! Vaša analitika bo zdaj vključevala geo-obogateno podatke z mestom, regijo, državo, ISP in koordinatami za vse obiskovalce.

Strojno kodiranje videa

Galleria podpira strojno pospešeno kodiranje videa za 5-10x hitrejšo obdelavo videa z uporabo vaše GPU.

Podprta strojna oprema

NVIDIA GPU (NVENC)

Podpora za Docker in nativna podpora

Intel Quick Sync (QSV)

Samo nativna podpora

AMD GPU-ji (AMF)

Samo nativna podpora

Apple VideoToolbox

Samo macOS nativno

Omogoči strojno kodiranje

  1. Pojdite na Administratorska plošča → Nastavitve → Kakovost videa
  2. Preklopite "Strojno transcoding" na omogočeno
  3. Obdelava videa bo zdaj uporabljala pospeševanje GPU, ko bo na voljo

Proizvodna namestitev

Uporaba PM2

Za proizvodno namestitev brez Dockerja:

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

Avtomatizirana namestitev: Potisnite v glavno vejo in GitHub Actions samodejno namesti vaše spremembe.

Pomagajte izboljšati to dokumentacijo

Ste našli napako ali želite prispevati k dokumentaciji? Veseli smo prispevkov!

Prispevajte na GitHubu