Documentation

Guide complet pour déployer et gérer votre portfolio photographique Galleria.

Commencer

Galleria est un site moderne de portfolio photographique construit avec React 19, TypeScript, Express 5 et SQLite. Il propose une livraison d'images optimisée, un panneau d'administration, un suivi analytique et un design réactif.

Liens rapides

Configuration de Google OAuth SSO

Activez l'authentification unique Google OAuth pour une connexion sécurisée et sans mot de passe à votre panneau d'administration Galleria.

Étape 1 : Créer un projet Google Cloud

  1. Allez dans la console Google Cloud
  2. Créez un nouveau projet ou sélectionnez un projet existant
  3. Accédez à APIs & Services → Identifiants
  4. Cliquez sur Créer des identifiants → ID client OAuth
  5. Si vous y êtes invité, configurez d'abord l'écran de consentement OAuth

Étape 2 : Configurer le client OAuth

  1. Sélectionnez Application Web comme type d'application
  2. Ajoutez votre domaine aux origines JavaScript autorisées :
    https://yourdomain.com
  3. Ajoutez l'URL de rappel aux URI de redirection autorisées :
    https://yourdomain.com/api/auth/google/callback
  4. Cliquez sur Créer et enregistrez vos identifiants

Étape 3 : Configurer dans les paramètres de Galleria

  1. Connectez-vous à votre panneau d'administration Galleria
  2. Accédez à Paramètres → Google OAuth
  3. Entrez votre identifiant client Google
  4. Entrez votre secret client Google
  5. Cliquez sur Enregistrer pour activer l'authentification unique Google OAuth

Conversion automatique des utilisateurs : Les utilisateurs existants avec des adresses e-mail correspondantes seront automatiquement convertis à l'authentification Google OAuth. Ils peuvent se connecter avec Google immédiatement après la configuration de l'OAuth.

Conseil de sécurité : N'ajoutez que des adresses e-mail de confiance en tant qu'utilisateurs administrateurs. Vous pouvez gérer l'accès des utilisateurs depuis le panneau d'administration après la configuration initiale.

Configuration d'OpenObserve Analytics

OpenObserve fournit une puissante analyse des journaux et une surveillance en temps réel pour votre site Web Galleria avec des capacités de géo-enrichissement.

Étape 1 : Installez OpenObserve avec Docker

Exécutez OpenObserve en utilisant Docker Compose :

Étape 2 : Créer un compte de service

  1. Accédez à OpenObserve à http://localhost:5080
  2. Connectez-vous avec vos identifiants administratifs
  3. Accédez à Paramètres → Comptes de service
  4. Cliquez sur Créer un compte de service
  5. Donnez-lui un nom (par exemple, "galleria-analytics") et attribuez les autorisations appropriées
  6. Copiez le jeton API généré pour une utilisation ultérieure

Étape 7 : Configurer Galleria

  1. Connectez-vous à votre panneau d'administration Galleria
  2. Allez dans Paramètres → Analyse
  3. Entrez votre URL OpenObserve (par exemple, http://localhost:5080)
  4. Entrez votre ID d'organisation
  5. Entrez le nom de votre flux (site web)
  6. Entrez votre nom d'utilisateur (de l'étape 2)
  7. Entrez votre mot de passe (le jeton du compte de service de l'étape 2)
  8. Cliquez sur Enregistrer pour activer l'analyse OpenObserve

Succès ! Vos analyses incluront désormais des données géo-enrichies avec ville, région, pays, FAI et coordonnées pour tous les visiteurs.

Encodage vidéo matériel

Galleria prend en charge l'encodage vidéo accéléré par matériel pour un traitement vidéo 5 à 10 fois plus rapide en utilisant votre GPU.

Matériel pris en charge

GPU NVIDIA (NVENC)

Support Docker et natif

Intel Quick Sync (QSV)

Support uniquement natif

GPU AMD (AMF)

Support natif uniquement

Apple VideoToolbox

macOS natif uniquement

Activer l'encodage matériel

  1. Allez dans le panneau d'administration → Paramètres → Qualité vidéo
  2. Basculer "Transcodage matériel" sur activé
  3. Le traitement vidéo utilisera désormais l'accélération GPU lorsque disponible

Déploiement en production

Utilisation de PM2

Pour le déploiement en production sans Docker :

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

Déploiement automatisé : Poussez vers la branche principale et GitHub Actions déploie automatiquement vos modifications.

Aidez à améliorer cette documentation

Vous avez trouvé une erreur ou souhaitez contribuer à la documentation ? Nous accueillons les contributions !

Contribuez sur GitHub