Documentació

Guia completa per desplegar i gestionar el teu portafoli fotogràfic Galleria.

Començant

Galleria és un lloc web de portafoli fotogràfic modern construït amb React 19, TypeScript, Express 5 i SQLite. Presenta una entrega d'imatges optimitzada, panell d'administració, seguiment d'analítiques i disseny adaptable.

Enllaços ràpids

Configuració de Google OAuth SSO

Habilita Google OAuth Single Sign-On per a una autenticació segura, sense contrasenya, al teu panell d'administració de Galleria.

Pas 1: Crea un projecte de Google Cloud

  1. Vés a la Consola de Google Cloud
  2. Crea un nou projecte o selecciona un existent
  3. Navega a APIs i serveis → Credencials
  4. Fes clic a Crear credencials → ID de client OAuth
  5. Si se't demana, configura primer la pantalla de consentiment d'OAuth

Pas 2: Configura el client OAuth

  1. Selecciona Aplicació web com a tipus d'aplicació
  2. Afegeix el teu domini a Orígens JavaScript autoritzats:
    https://yourdomain.com
  3. Afegeix la URL de callback a URIs de redirecció autoritzades:
    https://yourdomain.com/api/auth/google/callback
  4. Fes clic a Crear i desa les teves credencials

Pas 3: Configura a la configuració de Galleria

  1. Inicia sessió al teu panell d'administració de Galleria
  2. Navega a Configuració → Google OAuth
  3. Introdueix el teu ID de client de Google
  4. Introdueix el teu secret de client de Google
  5. Fes clic a Desa per habilitar Google OAuth SSO

Conversió automàtica d'usuaris: Els usuaris existents amb adreces de correu electrònic coincidents seran convertits automàticament a l'autenticació OAuth de Google. Poden iniciar sessió amb Google immediatament després que OAuth estigui configurat.

Consell de seguretat: Només afegeix adreces de correu electrònic de confiança com a usuaris administradors. Pots gestionar l'accés dels usuaris des del panell d'administració després de la configuració inicial.

Configuració d'OpenObserve Analytics

OpenObserve proporciona potents analítiques de registres i monitoratge en temps real per al teu lloc web de Galleria amb capacitats d'enriquiment geogràfic.

Pas 1: Instal·la OpenObserve amb Docker

Executa OpenObserve utilitzant Docker Compose:

Pas 2: Crea un compte de servei

  1. Accedeix a OpenObserve a http://localhost:5080
  2. Inicia sessió amb les teves credencials d'administrador
  3. Navega a Configuració → Comptes de servei
  4. Fes clic a Crear compte de servei
  5. Dóna-li un nom (per exemple, "galleria-analytics") i assigna permisos adequats
  6. Copia el token API generat per a un ús posterior

Pas 7: Configura Galleria

  1. Inicia sessió al teu panell d'administració de Galleria
  2. Navega a Configuració → Analítica
  3. Introdueix la teva URL d'OpenObserve (per exemple, http://localhost:5080)
  4. Introdueix el teu ID d'Organització
  5. Introdueix el teu Nom de Flux (pàgina web)
  6. Introdueix el teu Nom d'Usuari (del Pas 2)
  7. Introdueix la teva Contrasenya (el token del compte de servei del Pas 2)
  8. Fes clic a Desa per habilitar l'analítica d'OpenObserve

Èxit! La teva analítica ara inclourà dades geo-enriquides amb ciutat, regió, país, ISP i coordenades per a tots els visitants.

Codificació de Vídeo en Maquinari

Galleria admet la codificació de vídeo accelerada per maquinari per a un processament de vídeo 5-10 vegades més ràpid utilitzant la teva GPU.

Maquinari Compatible

GPU NVIDIA (NVENC)

Suport Docker i natiu

Intel Quick Sync (QSV)

Només suport natiu

GPU d'AMD (AMF)

Suport natiu només

Apple VideoToolbox

només natiu de macOS

Habilitar codificació de maquinari

  1. Vés al Panell d'Administració → Configuració → Qualitat de Vídeo
  2. Activa "Transcodificació de Maquinari"
  3. El processament de vídeo ara utilitzarà l'acceleració de GPU quan estigui disponible

Desplegament en Producció

Utilitzant PM2

Per al desplegament en producció sense Docker:

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

Desplegament automatitzat: Feu un push a la branca principal i les Accions de GitHub despleguen automàticament els vostres canvis.

Ajudeu a millorar aquesta documentació

Heu trobat un error o voleu contribuir a la documentació? Benvingudes les contribucions!

Contribuïu a GitHub