Documentație

Ghid complet pentru implementarea și gestionarea portofoliului dvs. fotografic Galleria.

Începeți

Galleria este un site modern de portofoliu fotografic construit cu React 19, TypeScript, Express 5 și SQLite. Oferă livrare optimizată a imaginilor, panou de administrare, urmărirea analiticii și design receptiv.

Linkuri rapide

Configurare Google OAuth SSO

Activează autentificarea Google OAuth Single Sign-On pentru acces securizat, fără parolă, la panoul de administrare Galleria.

Pasul 1: Creează un proiect Google Cloud

  1. Accesează Google Cloud Console
  2. Creează un nou proiect sau selectează unul existent
  3. Navighează la API-uri și servicii → Credite
  4. Click pe Creează credite → ID client OAuth
  5. Dacă ți se solicită, configurează mai întâi ecranul de consimțământ OAuth

Pasul 2: Configurează clientul OAuth

  1. Selectează aplicație web ca tip de aplicație
  2. Adaugă domeniul tău la origini JavaScript autorizate:
    https://yourdomain.com
  3. Adaugă URL-ul de redirecționare la URI-uri de redirecționare autorizate:
    https://yourdomain.com/api/auth/google/callback
  4. Click pe Creează și salvează-ți creditele

Pasul 3: Configurează în setările Galleria

  1. Conectează-te la panoul tău de administrare Galleria
  2. Navighează la Setări → Google OAuth
  3. Introduceți ID-ul clientului Google
  4. Introduceți secretul clientului Google
  5. Faceți clic pe Salvați pentru a activa SSO Google OAuth

Conversie automată a utilizatorilor: Utilizatorii existenți cu adrese de email corespunzătoare vor fi convertiți automat la autentificarea Google OAuth. Aceștia se pot conecta cu Google imediat după ce OAuth este configurat.

Sfat de securitate: Adăugați doar adrese de email de încredere ca utilizatori administratori. Puteți gestiona accesul utilizatorilor din panoul de administrare după configurarea inițială.

Configurare OpenObserve Analytics

OpenObserve oferă analize puternice de jurnal și monitorizare în timp real pentru site-ul dvs. Galleria, cu capacități de geo-enrișare.

Pasul 1: Instalați OpenObserve cu Docker

Rulați OpenObserve folosind Docker Compose:

Pasul 2: Creați un cont de serviciu

  1. Accesați OpenObserve la http://localhost:5080
  2. Conectați-vă cu acreditivele dvs. de administrator
  3. Navigați la Setări → Conturi de serviciu
  4. Faceți clic pe Creați cont de serviciu
  5. Dați-i un nume (de exemplu, "galleria-analytics") și atribuiți permisiuni corespunzătoare
  6. Copiați tokenul API generat pentru utilizare ulterioară

Pasul 7: Configurează Galleria

  1. Conectează-te la panoul de administrare Galleria
  2. Navighează la Setări → Analitică
  3. Introdu URL-ul tău OpenObserve (de exemplu, http://localhost:5080)
  4. Introdu ID-ul organizației tale
  5. Introdu numele fluxului tău (website)
  6. Introdu numele tău de utilizator (din Pasul 2)
  7. Introdu parola ta (token-ul contului de serviciu din Pasul 2)
  8. Apasă pe Salvează pentru a activa analitica OpenObserve

Succes! Analitica ta va include acum date geo-îmbogățite cu oraș, regiune, țară, ISP și coordonate pentru toți vizitatorii.

Codare video hardware

Galleria suportă codarea video accelerată hardware pentru procesare video de 5-10 ori mai rapidă folosind GPU-ul tău.

Hardware suportat

GPU-uri NVIDIA (NVENC)

Suport Docker și nativ

Intel Quick Sync (QSV)

Suport nativ doar

GPU-urile AMD (AMF)

Suport nativ doar

Apple VideoToolbox

doar nativ macOS

Activează Codarea Hardware

  1. Mergi la Panoul de Administrare → Setări → Calitate Video
  2. Comută "Transcodare Hardware" la activat
  3. Procesarea video va folosi acum accelerarea GPU când este disponibilă

Implementare în Producție

Folosind PM2

Pentru implementarea în producție fără Docker:

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

Implementare Automată: Împinge în ramura master și GitHub Actions implementează automat modificările tale.

Ajută la Îmbunătățirea Aceastei Documentații

Ați găsit o eroare sau doriți să contribuiți la documentație? Acceptăm contribuții!

Contribuiți pe GitHub