Belgeler

Galleria fotoğraf portföyünüzü dağıtma ve yönetme konusunda eksiksiz bir rehber.

Başlarken

Galleria, React 19, TypeScript, Express 5 ve SQLite ile oluşturulmuş modern bir fotoğraf portföyü web sitesidir. Optimize edilmiş görüntü teslimatı, yönetici paneli, analitik izleme ve duyarlı tasarım özelliklerine sahiptir.

Hızlı Bağlantılar

Google OAuth SSO Kurulumu

Galleria yönetim panelinize güvenli, şifresiz kimlik doğrulama için Google OAuth Tek Oturum Açma'yı etkinleştirin.

Adım 1: Google Cloud Projesi Oluşturun

  1. Google Cloud Konsolu'na gidin
  2. Yeni bir proje oluşturun veya mevcut birini seçin
  3. APIs & Services → Kimlik Bilgileri'ne gidin
  4. Kimlik Bilgileri Oluştur → OAuth istemci kimliği'ne tıklayın
  5. İstenirse, önce OAuth onay ekranını yapılandırın

Adım 2: OAuth İstemcisini Yapılandırın

  1. Uygulama türü olarak Web uygulamasını seçin
  2. Alan adınızı Yetkilendirilmiş JavaScript kökenlerine ekleyin:
    https://yourdomain.com
  3. Geri çağırma URL'sini Yetkilendirilmiş yönlendirme URI'lerine ekleyin:
    https://yourdomain.com/api/auth/google/callback
  4. Kimlik bilgilerinizi oluşturun ve kaydedin

Adım 3: Galleria Ayarlarında Yapılandırın

  1. Galleria yönetim panelinize giriş yapın
  2. Ayarlar → Google OAuth'a gidin
  3. Google Müşteri Kimliğinizi girin
  4. Google Müşteri Sırrınızı girin
  5. Google OAuth SSO'yu etkinleştirmek için Kaydet'e tıklayın

Otomatik Kullanıcı Dönüşümü: Eşleşen e-posta adreslerine sahip mevcut kullanıcılar otomatik olarak Google OAuth kimlik doğrulamasına dönüştürülecektir. OAuth yapılandırıldıktan sonra hemen Google ile oturum açabilirler.

Güvenlik İpucu: Yalnızca güvenilir e-posta adreslerini yönetici kullanıcılar olarak ekleyin. İlk kurulumdan sonra kullanıcı erişimini yönetim panelinden yönetebilirsiniz.

OpenObserve Analitik Kurulumu

OpenObserve, Galleria web siteniz için güçlü günlük analitiği ve gerçek zamanlı izleme sağlar ve coğrafi zenginleştirme yeteneklerine sahiptir.

Adım 1: OpenObserve'u Docker ile kurun

OpenObserve'u Docker Compose kullanarak çalıştırın:

Adım 2: Hizmet Hesabı Oluşturun

  1. OpenObserve'a http://localhost:5080 adresinden erişin
  2. Yönetici kimlik bilgilerinizle oturum açın
  3. Ayarlar → Hizmet Hesapları'na gidin
  4. Hizmet Hesabı Oluştur'a tıklayın
  5. Bir isim verin (örneğin, "galleria-analytics") ve uygun izinleri atayın
  6. Sonraki kullanım için oluşturulan API jetonunu kopyalayın

Adım 7: Galleria'yı Yapılandırın

  1. Galleria yönetim panelinize giriş yapın
  2. Ayarlar → Analitikler bölümüne gidin
  3. OpenObserve URL'nizi girin (örneğin, http://localhost:5080)
  4. Organizasyon Kimliğinizi girin
  5. Akış Adınızı (web sitesi) girin
  6. Kullanıcı Adınızı (Adım 2'den) girin
  7. Parolanızı (Adım 2'den hizmet hesabı belirteci) girin
  8. OpenObserve analitiklerini etkinleştirmek için Kaydet'e tıklayın

Başarılı! Artık analitikleriniz, tüm ziyaretçiler için şehir, bölge, ülke, ISP ve koordinatlarla zenginleştirilmiş coğrafi verileri içerecek.

Donanım Video Kodlama

Galleria, GPU'nuzu kullanarak 5-10 kat daha hızlı video işleme için donanım hızlandırmalı video kodlamayı destekler.

Desteklenen Donanım

NVIDIA GPU'ları (NVENC)

Docker ve yerel destek

Intel Quick Sync (QSV)

Sadece yerel destek

AMD GPU'ları (AMF)

Sadece yerel destek

Apple VideoToolbox

Sadece macOS yerel

Donanım Kodlamayı Etkinleştir

  1. Yönetim Paneli → Ayarlar → Video Kalitesi'ne gidin
  2. "Donanım Transcoding" seçeneğini etkinleştir olarak değiştirin
  3. Video işleme artık mevcut olduğunda GPU hızlandırmasını kullanacak

Üretim Dağıtımı

PM2 Kullanarak

Docker olmadan üretim dağıtımı için:

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

Otomatik Dağıtım: Ana dalına itme yapın ve GitHub Actions değişikliklerinizi otomatik olarak dağıtır.

Bu Belgeyi Geliştirmeye Yardımcı Olun

Bir hata mı buldunuz yoksa belgelere katkıda mı bulunmak istiyorsunuz? Katkılara açığız!

GitHub'da katkıda bulunun