Dokumentasi

Panduan lengkap untuk menerapkan dan mengelola portofolio fotografi Galleria Anda.

Memulai

Galleria adalah situs portofolio fotografi modern yang dibangun dengan React 19, TypeScript, Express 5, dan SQLite. Ini memiliki pengiriman gambar yang dioptimalkan, panel admin, pelacakan analitik, dan desain responsif.

Tautan Cepat

Pengaturan Google OAuth SSO

Aktifkan Google OAuth Single Sign-On untuk autentikasi yang aman dan tanpa kata sandi ke panel admin Galleria Anda.

Langkah 1: Buat Proyek Google Cloud

  1. Pergi ke Google Cloud Console
  2. Buat proyek baru atau pilih yang sudah ada
  3. Navigasi ke API & Layanan → Kredensial
  4. Klik Buat Kredensial → ID klien OAuth
  5. Jika diminta, konfigurasikan layar persetujuan OAuth terlebih dahulu

Langkah 2: Konfigurasi Klien OAuth

  1. Pilih aplikasi web sebagai jenis aplikasi
  2. Tambahkan domain Anda ke Asal JavaScript yang Diizinkan:
    https://yourdomain.com
  3. Tambahkan URL pengalihan ke URI pengalihan yang Diizinkan:
    https://yourdomain.com/api/auth/google/callback
  4. Klik Buat dan simpan kredensial Anda

Langkah 3: Konfigurasi di Pengaturan Galleria

  1. Masuk ke panel admin Galleria Anda
  2. Navigasi ke Pengaturan → Google OAuth
  3. Masukkan ID Klien Google Anda
  4. Masukkan Rahasia Klien Google Anda
  5. Klik Simpan untuk mengaktifkan Google OAuth SSO

Konversi Pengguna Otomatis: Pengguna yang ada dengan alamat email yang cocok akan secara otomatis dikonversi ke otentikasi Google OAuth. Mereka dapat masuk dengan Google segera setelah OAuth dikonfigurasi.

Tip Keamanan: Hanya tambahkan alamat email yang tepercaya sebagai pengguna admin. Anda dapat mengelola akses pengguna dari panel admin setelah pengaturan awal.

Pengaturan Analitik OpenObserve

OpenObserve menyediakan analitik log yang kuat dan pemantauan waktu nyata untuk situs web Galleria Anda dengan kemampuan pengayaan geo.

Langkah 1: Instal OpenObserve dengan Docker

Jalankan OpenObserve menggunakan Docker Compose:

Langkah 2: Buat Akun Layanan

  1. Akses OpenObserve di http://localhost:5080
  2. Masuk dengan kredensial admin Anda
  3. Navigasi ke Pengaturan → Akun Layanan
  4. Klik Buat Akun Layanan
  5. Beri nama (misalnya, "galleria-analytics") dan berikan izin yang sesuai
  6. Salin token API yang dihasilkan untuk digunakan nanti

Langkah 7: Konfigurasi Galleria

  1. Masuk ke panel admin Galleria Anda
  2. Navigasi ke Pengaturan → Analitik
  3. Masukkan URL OpenObserve Anda (misalnya, http://localhost:5080)
  4. Masukkan ID Organisasi Anda
  5. Masukkan Nama Stream Anda (situs web)
  6. Masukkan Nama Pengguna Anda (dari Langkah 2)
  7. Masukkan Kata Sandi Anda (token akun layanan dari Langkah 2)
  8. Klik Simpan untuk mengaktifkan analitik OpenObserve

Sukses! Analitik Anda sekarang akan mencakup data yang diperkaya geo dengan kota, wilayah, negara, ISP, dan koordinat untuk semua pengunjung.

Pengkodean Video Perangkat Keras

Galleria mendukung pengkodean video yang dipercepat perangkat keras untuk pemrosesan video 5-10x lebih cepat menggunakan GPU Anda.

Perangkat Keras yang Didukung

GPU NVIDIA (NVENC)

Dukungan Docker dan asli

Intel Quick Sync (QSV)

Dukungan asli saja

GPU AMD (AMF)

Dukungan asli hanya

Apple VideoToolbox

hanya macOS asli

Aktifkan Pengkodean Perangkat Keras

  1. Pergi ke Panel Admin → Pengaturan → Kualitas Video
  2. Alihkan "Transcoding Perangkat Keras" ke aktif
  3. Pemrosesan video sekarang akan menggunakan akselerasi GPU saat tersedia

Penerapan Produksi

Menggunakan PM2

Untuk penerapan produksi tanpa Docker:

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

Penerapan Otomatis: Dorong ke cabang master dan GitHub Actions secara otomatis menerapkan perubahan Anda.

Bantu Tingkatkan Dokumentasi Ini

Menemukan kesalahan atau ingin berkontribusi pada dokumentasi? Kami menyambut kontribusi!

Kontribusi di GitHub