Documentazione

Guida completa per il deploy e la gestione del tuo portfolio fotografico Galleria.

Iniziare

Galleria è un sito web moderno per portfolio fotografico costruito con React 19, TypeScript, Express 5 e SQLite. Presenta una consegna delle immagini ottimizzata, un pannello di amministrazione, tracciamento delle analisi e un design reattivo.

Collegamenti rapidi

Impostazione Google OAuth SSO

Abilita Google OAuth Single Sign-On per un'autenticazione sicura e senza password al tuo pannello di amministrazione Galleria.

Passo 1: Crea un progetto Google Cloud

  1. Vai alla Google Cloud Console
  2. Crea un nuovo progetto o seleziona uno esistente
  3. Naviga su API e Servizi → Credenziali
  4. Clicca su Crea Credenziali → ID client OAuth
  5. Se richiesto, configura prima la schermata di consenso OAuth

Passo 2: Configura il client OAuth

  1. Seleziona Applicazione web come tipo di applicazione
  2. Aggiungi il tuo dominio a Origini JavaScript autorizzate:
    https://yourdomain.com
  3. Aggiungi l'URL di callback a URI di reindirizzamento autorizzati:
    https://yourdomain.com/api/auth/google/callback
  4. Clicca su Crea e salva le tue credenziali

Passo 3: Configura nelle impostazioni di Galleria

  1. Accedi al tuo pannello di amministrazione Galleria
  2. Naviga su Impostazioni → Google OAuth
  3. Inserisci il tuo Google Client ID
  4. Inserisci il tuo Google Client Secret
  5. Clicca su Salva per abilitare Google OAuth SSO

Conversione automatica degli utenti: Gli utenti esistenti con indirizzi email corrispondenti verranno automaticamente convertiti in autenticazione Google OAuth. Possono accedere con Google immediatamente dopo che OAuth è stato configurato.

Suggerimento di sicurezza: Aggiungi solo indirizzi email fidati come utenti amministratori. Puoi gestire l'accesso degli utenti dal pannello di amministrazione dopo la configurazione iniziale.

Impostazione di OpenObserve Analytics

OpenObserve fornisce potenti analisi dei log e monitoraggio in tempo reale per il tuo sito web Galleria con capacità di arricchimento geografico.

Passo 1: Installa OpenObserve con Docker

Esegui OpenObserve utilizzando Docker Compose:

Passo 2: Crea un'account di servizio

  1. Accedi a OpenObserve su http://localhost:5080
  2. Accedi con le tue credenziali di amministratore
  3. Naviga su Impostazioni → Account di servizio
  4. Clicca su Crea account di servizio
  5. Dagli un nome (ad es., "galleria-analytics") e assegna i permessi appropriati
  6. Copia il token API generato per un uso successivo

Passo 7: Configura Galleria

  1. Accedi al tuo pannello di amministrazione Galleria
  2. Naviga su Impostazioni → Analitica
  3. Inserisci il tuo URL OpenObserve (es. http://localhost:5080)
  4. Inserisci il tuo ID Organizzazione
  5. Inserisci il tuo Nome Stream (sito web)
  6. Inserisci il tuo Nome Utente (dal Passo 2)
  7. Inserisci la tua Password (il token dell'account di servizio dal Passo 2)
  8. Clicca su Salva per abilitare le analisi OpenObserve

Successo! Le tue analisi includeranno ora dati geo-arricchiti con città, regione, paese, ISP e coordinate per tutti i visitatori.

Codifica Video Hardware

Galleria supporta la codifica video accelerata dall'hardware per un'elaborazione video 5-10 volte più veloce utilizzando la tua GPU.

Hardware Supportato

GPU NVIDIA (NVENC)

Supporto Docker e nativo

Intel Quick Sync (QSV)

Supporto solo nativo

GPU AMD (AMF)

Supporto nativo solo

Apple VideoToolbox

solo macOS nativo

Abilita la codifica hardware

  1. Vai al Pannello di Amministrazione → Impostazioni → Qualità Video
  2. Attiva "Transcodifica Hardware" per abilitato
  3. L'elaborazione video utilizzerà ora l'accelerazione GPU quando disponibile

Distribuzione in Produzione

Utilizzando PM2

Per la distribuzione in produzione senza Docker:

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

Distribuzione Automatizzata: Esegui il push nel ramo master e GitHub Actions distribuisce automaticamente le tue modifiche.

Aiuta a Migliorare Questa Documentazione

Hai trovato un errore o vuoi contribuire alla documentazione? Accogliamo con favore i contributi!

Contribuisci su GitHub