Dokumentation

Fullständig guide för att distribuera och hantera din Galleria fotografportfölj.

Kom igång

Galleria är en modern fotografportfölj webbplats byggd med React 19, TypeScript, Express 5 och SQLite. Den har optimerad bildleverans, adminpanel, analysövervakning och responsiv design.

Snabblänkar

Google OAuth SSO-inställning

Aktivera Google OAuth Single Sign-On för säker, lösenordsfri autentisering till din Galleria-administrationspanel.

Steg 1: Skapa Google Cloud-projekt

  1. Gå till Google Cloud Console
  2. Skapa ett nytt projekt eller välj ett befintligt
  3. Navigera till API:er och tjänster → Referenser
  4. Klicka på Skapa referenser → OAuth-klient-ID
  5. Om du uppmanas, konfigurera OAuth-samtyckesskärmen först

Steg 2: Konfigurera OAuth-klient

  1. Välj webbapplikation som applikationstyp
  2. Lägg till din domän i Auktoriserade JavaScript-ursprung:
    https://yourdomain.com
  3. Lägg till återkopplings-URL:en i Auktoriserade omdirigerings-URI:er:
    https://yourdomain.com/api/auth/google/callback
  4. Klicka på Skapa och spara dina referenser

Steg 3: Konfigurera i Galleria-inställningar

  1. Logga in på din Galleria-administrationspanel
  2. Navigera till Inställningar → Google OAuth
  3. Ange ditt Google Client ID
  4. Ange din Google Client Secret
  5. Klicka på Spara för att aktivera Google OAuth SSO

Automatisk användarkonvertering: Befintliga användare med matchande e-postadresser kommer automatiskt att konverteras till Google OAuth-autentisering. De kan logga in med Google omedelbart efter att OAuth har konfigurerats.

Säkerhetstips: Lägg endast till betrodda e-postadresser som administratörsanvändare. Du kan hantera användartillgång från adminpanelen efter den initiala installationen.

OpenObserve Analytics-installation

OpenObserve erbjuder kraftfull logganalys och realtidsövervakning för din Galleria-webbplats med geo-berikningsmöjligheter.

Steg 1: Installera OpenObserve med Docker

Kör OpenObserve med Docker Compose:

Steg 2: Skapa tjänstekonto

  1. Åtkomst till OpenObserve på http://localhost:5080
  2. Logga in med dina administratörsuppgifter
  3. Navigera till Inställningar → Tjänstekonton
  4. Klicka på Skapa tjänstekonto
  5. Ge det ett namn (t.ex. "galleria-analytics") och tilldela lämpliga behörigheter
  6. Kopiera den genererade API-token för senare användning

Steg 7: Konfigurera Galleria

  1. Logga in på din Galleria-administrationspanel
  2. Navigera till Inställningar → Analys
  3. Ange din OpenObserve-URL (t.ex., http://localhost:5080)
  4. Ange ditt Organisations-ID
  5. Ange ditt Strömnamn (webbplats)
  6. Ange ditt Användarnamn (från Steg 2)
  7. Ange ditt Lösenord (tjänstekontots token från Steg 2)
  8. Klicka på Spara för att aktivera OpenObserve-analys

Framgång! Din analys kommer nu att inkludera geo-berikad data med stad, region, land, ISP och koordinater för alla besökare.

Hårdvaru Video Kodning

Galleria stöder hårdvaruaccelererad videokodning för 5-10x snabbare videoprocessering med hjälp av din GPU.

Stödd Hårdvara

NVIDIA GPU:er (NVENC)

Docker och inbyggt stöd

Intel Quick Sync (QSV)

Endast inbyggt stöd

AMD GPU:er (AMF)

Endast inbyggt stöd

Apple VideoToolbox

endast macOS

Aktivera hårdvaruavkodning

  1. Gå till Adminpanel → Inställningar → Videokvalitet
  2. Växla "Hårdvaruavkodning" till aktiverad
  3. Videobearbetning kommer nu att använda GPU-acceleration när det är tillgängligt

Produktionsdistribution

Använda PM2

För produktionsdistribution utan Docker:

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

Automatiserad distribution: Tryck till mastergrenen och GitHub Actions distribuerar automatiskt dina ändringar.

Hjälp till att förbättra denna dokumentation

Hittade du ett fel eller vill du bidra till dokumentationen? Vi välkomnar bidrag!

Bidra på GitHub