Dokumentaatio

Kattava opas Galleria-valokuvaportfolion käyttöönottoon ja hallintaan.

Aloitus

Galleria on moderni valokuvaportfoliosivusto, joka on rakennettu React 19:llä, TypeScriptillä, Express 5:llä ja SQLite:llä. Se sisältää optimoidun kuvatoimituksen, hallintapaneelin, analytiikkaseurannan ja responsiivisen suunnittelun.

Pikakuvakkeet

Google OAuth SSO -asetukset

Ota käyttöön Google OAuth -yksittäinen kirjautuminen turvallista, salasanatonta todennusta varten Galleria-admin-paneeliisi.

Vaihe 1: Luo Google Cloud -projekti

  1. Siirry Google Cloud Consoleen
  2. Luo uusi projekti tai valitse olemassa oleva
  3. Siirry kohtaan API:t ja palvelut → Tunnistetiedot
  4. Napsauta Luo tunnistetiedot → OAuth-asiakastunnus
  5. Jos kehotetaan, määritä ensin OAuth-suostumusnäyttö

Vaihe 2: Määritä OAuth-asiakas

  1. Valitse verkkosovellus sovellustyypiksi
  2. Lisää verkkotunnuksesi valtuutettuihin JavaScript-lähteisiin:
    https://yourdomain.com
  3. Lisää palautus-URL valtuutettuihin uudelleenohjaus-URI:hin:
    https://yourdomain.com/api/auth/google/callback
  4. Napsauta Luo ja tallenna tunnistetietosi

Vaihe 3: Määritä Galleria-asetuksissa

  1. Kirjaudu Galleria-admin-paneeliisi
  2. Siirry kohtaan Asetukset → Google OAuth
  3. Syötä Google Client ID
  4. Syötä Google Client Secret
  5. Napsauta Tallenna ottaaksesi käyttöön Google OAuth SSO

Automaattinen käyttäjämuunnos: Olemassa olevat käyttäjät, joilla on vastaavat sähköpostiosoitteet, muunnetaan automaattisesti Google OAuth -tunnistautumiseen. He voivat kirjautua sisään Googlella heti, kun OAuth on konfiguroitu.

Turvavinkki: Lisää vain luotettavat sähköpostiosoitteet ylläpitäjätunnuksiksi. Voit hallita käyttäjäoikeuksia ylläpitopaneelista alkuasetusten jälkeen.

OpenObserve Analytics -asetukset

OpenObserve tarjoaa tehokasta lokianalytiikkaa ja reaaliaikaista seurantaa Galleria-verkkosivustollesi geo-rikastamismahdollisuuksilla.

Vaihe 1: Asenna OpenObserve Dockerilla

Suorita OpenObserve Docker Composea käyttäen:

Vaihe 2: Luo palvelutili

  1. Pääsy OpenObserveen osoitteessa http://localhost:5080
  2. Kirjaudu sisään ylläpitäjätunnuksillasi
  3. Siirry kohtaan Asetukset → Palvelutilit
  4. Napsauta Luo palvelutili
  5. Anna sille nimi (esim. "galleria-analytics") ja määritä sopivat käyttöoikeudet
  6. Kopioi luotu API-tunnus myöhempää käyttöä varten

Vaihe 7: Määritä Galleria

  1. Kirjaudu Galleria-hallintapaneeliisi
  2. Siirry kohtaan Asetukset → Analytiikka
  3. Syötä OpenObserve-URL-osoitteesi (esim. http://localhost:5080)
  4. Syötä Organisaatio-ID:si
  5. Syötä Stream-nimesi (verkkosivusto)
  6. Syötä Käyttäjänimesi (vaiheesta 2)
  7. Syötä Salasanasi (palvelutilin token vaiheesta 2)
  8. Napsauta Tallenna ottaaksesi käyttöön OpenObserve-analytiikan

Onnistui! Analytiikkasi sisältää nyt geo-rikastettua tietoa kaupungista, alueesta, maasta, ISP:stä ja koordinaateista kaikille kävijöille.

Laitteistovideokoodaus

Galleria tukee laitteistokiihdytettyä videokoodausta 5-10 kertaa nopeammalla videonkäsittelyllä käyttämällä GPU:ta.

Tuetut laitteistot

NVIDIA GPU:t (NVENC)

Docker ja natiivituen tuki

Intel Quick Sync (QSV)

Vain natiivituen tuki

AMD GPU:t (AMF)

Natiivituki vain

Apple VideoToolbox

macOS natiivi vain

Ota käyttöön laitteistokoodaus

  1. Siirry ylläpitopaneeliin → Asetukset → Videolaatu
  2. Vaihda "Laitteistotranskoodaus" päälle
  3. Videonkäsittely käyttää nyt GPU-kiihdytystä, kun se on saatavilla

Tuotantoon käyttöönotto

Käyttäen PM2:ta

Tuotantoon käyttöönotto ilman Dockeria:

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

Automaattinen käyttöönotto: Pushaa master-haaraan ja GitHub Actions ottaa automaattisesti muutoksesi käyttöön.

Auta parantamaan tätä dokumentaatiota

Löysitkö virheen tai haluatko osallistua dokumentaation tekemiseen? Tervetuloa osallistumaan!

Osallistu GitHubissa