Dokumentacija

Išsamus vadovas, kaip diegti ir valdyti savo Galleria fotografijos portfelį.

Pradžia

Galleria yra moderni fotografijos portfelio svetainė, sukurta naudojant React 19, TypeScript, Express 5 ir SQLite. Ji siūlo optimizuotą vaizdų pristatymą, administratoriaus skydelį, analizės stebėjimą ir reaguojantį dizainą.

Greiti nuorodos

Google OAuth SSO nustatymas

Įgalinkite Google OAuth vieno prisijungimo funkciją, kad užtikrintumėte saugų, be slaptažodžio autentifikavimą savo Galleria administravimo panele.

1 žingsnis: sukurti Google Cloud projektą

  1. Eikite į Google Cloud konsolę
  2. Sukurkite naują projektą arba pasirinkite esamą
  3. Eikite į API ir paslaugos → Akreditacijos
  4. Paspauskite Sukurti akreditacijas → OAuth kliento ID
  5. Jei būsite paprašyti, pirmiausia sukonfigūruokite OAuth sutikimo ekraną

2 žingsnis: sukonfigūruoti OAuth klientą

  1. Pasirinkite Interneto programą kaip programos tipą
  2. Pridėkite savo domeną prie Įgaliotų JavaScript šaltinių:
    https://yourdomain.com
  3. Pridėkite grąžinimo URL prie Įgaliotų nukreipimo URI:
    https://yourdomain.com/api/auth/google/callback
  4. Paspauskite Sukurti ir išsaugokite savo akreditacijas

3 žingsnis: sukonfigūruoti Galleria nustatymuose

  1. Prisijunkite prie savo Galleria administravimo panelės
  2. Eikite į Nustatymai → Google OAuth
  3. Įveskite savo Google Kliento ID
  4. Įveskite savo Google Kliento Slaptažodį
  5. Paspauskite Išsaugoti, kad įgalintumėte Google OAuth SSO

Automatinis vartotojų konvertavimas: Esami vartotojai su atitinkančiomis el. pašto adresais bus automatiškai konvertuoti į Google OAuth autentifikavimą. Jie gali prisijungti su Google iš karto po to, kai OAuth bus sukonfigūruotas.

Saugumo patarimas: Pridėkite tik patikimus el. pašto adresus kaip administratorių vartotojus. Galite valdyti vartotojų prieigą iš administratoriaus skydelio po pradinio nustatymo.

OpenObserve Analitikos Nustatymas

OpenObserve teikia galingą žurnalo analitiką ir realaus laiko stebėjimą jūsų Galleria svetainei su geo-praturtinimo galimybėmis.

1 žingsnis: Įdiekite OpenObserve su Docker

Paleiskite OpenObserve naudodami Docker Compose:

2 žingsnis: Sukurkite Paslaugų Paskyrą

  1. Pasiekite OpenObserve adresu http://localhost:5080
  2. Prisijunkite su savo administratoriaus kredencialais
  3. Eikite į Nustatymai → Paslaugų Paskyros
  4. Paspauskite Kurti Paslaugų Paskyrą
  5. Pavadinkite ją (pvz., "galleria-analytics") ir priskirkite tinkamas teises
  6. Kopijuokite sugeneruotą API žetoną vėlesniam naudojimui

7 žingsnis: Sukonfigūruokite Galleria

  1. Prisijunkite prie savo Galleria administravimo panelės
  2. Eikite į Nustatymai → Analitika
  3. Įveskite savo OpenObserve URL (pvz., http://localhost:5080)
  4. Įveskite savo Organizacijos ID
  5. Įveskite savo Srauto pavadinimą (tinklalapis)
  6. Įveskite savo Vartotojo vardą (iš 2 žingsnio)
  7. Įveskite savo Slaptažodį (paslaugų paskyros žetoną iš 2 žingsnio)
  8. Paspauskite Išsaugoti, kad įjungtumėte OpenObserve analitiką

Sėkmė! Jūsų analitika dabar apims geo-praturtintus duomenis su miestu, regionu, šalimi, ISP ir koordinatėmis visiems lankytojams.

Hardverinė vaizdo kodavimas

Galleria palaiko aparatūros pagreitintą vaizdo kodavimą, kuris leidžia 5-10 kartų greičiau apdoroti vaizdo įrašus naudojant jūsų GPU.

Palaikoma aparatinė įranga

NVIDIA GPU (NVENC)

Docker ir vietinis palaikymas

Intel Quick Sync (QSV)

Tik vietinis palaikymas

AMD GPU (AMF)

Tik natyvus palaikymas

Apple VideoToolbox

Tik macOS natyvus

Įgalinti aparatinį kodavimą

  1. Eikite į Administratoriaus skydelį → Nustatymai → Vaizdo kokybė
  2. Perjungti "Aparatinis transkodavimas" į įjungtą
  3. Vaizdo apdorojimas dabar naudos GPU pagreitį, kai jis bus prieinamas

Gamybos diegimas

Naudojant PM2

Gamybos diegimui be Docker:

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

Automatizuotas diegimas: Paskelbkite į pagrindinį šaką ir GitHub Actions automatiškai diegia jūsų pakeitimus.

Padėkite patobulinti šią dokumentaciją

Radote klaidą arba norite prisidėti prie dokumentacijos? Mes laukiame jūsų indėlio!

Prisidėti GitHub