Dokumentasi

Panduan lengkap untuk menyebarkan dan mengurus portfolio fotografi Galleria anda.

Memulakan

Galleria adalah laman web portfolio fotografi moden yang dibina dengan React 19, TypeScript, Express 5, dan SQLite. Ia mempunyai penghantaran imej yang dioptimumkan, panel admin, penjejakan analitik, dan reka bentuk responsif.

Pautan Pantas

Persediaan Google OAuth SSO

Aktifkan Google OAuth Single Sign-On untuk pengesahan yang selamat dan tanpa kata laluan ke panel admin Galleria anda.

Langkah 1: Buat Projek Google Cloud

  1. Pergi ke Konsol Google Cloud
  2. Buat projek baru atau pilih yang sedia ada
  3. Navigasi ke API & Perkhidmatan → Kelayakan
  4. Klik Buat Kelayakan → ID klien OAuth
  5. Jika diminta, konfigurasi skrin persetujuan OAuth terlebih dahulu

Langkah 2: Konfigurasi Klien OAuth

  1. Pilih aplikasi Web sebagai jenis aplikasi
  2. Tambah domain anda ke Asal JavaScript yang Dibenarkan:
    https://yourdomain.com
  3. Tambah URL panggilan balik ke URI pengalihan yang Dibenarkan:
    https://yourdomain.com/api/auth/google/callback
  4. Klik Buat dan simpan kelayakan anda

Langkah 3: Konfigurasi dalam Tetapan Galleria

  1. Log masuk ke panel admin Galleria anda
  2. Navigasi ke Tetapan → Google OAuth
  3. Masukkan ID Klien Google anda
  4. Masukkan Rahsia Klien Google anda
  5. Klik Simpan untuk mengaktifkan Google OAuth SSO

Penukaran Pengguna Automatik: Pengguna sedia ada dengan alamat emel yang sepadan akan ditukarkan secara automatik kepada pengesahan Google OAuth. Mereka boleh log masuk dengan Google sejurus selepas OAuth dikonfigurasikan.

Tip Keselamatan: Hanya tambah alamat emel yang dipercayai sebagai pengguna admin. Anda boleh mengurus akses pengguna dari panel admin selepas penyediaan awal.

Penyediaan Analitik OpenObserve

OpenObserve menyediakan analitik log yang berkuasa dan pemantauan masa nyata untuk laman web Galleria anda dengan keupayaan pengayaan geo.

Langkah 1: Pasang OpenObserve dengan Docker

Jalankan OpenObserve menggunakan Docker Compose:

Langkah 2: Cipta Akaun Perkhidmatan

  1. Akses OpenObserve di http://localhost:5080
  2. Log masuk dengan kelayakan admin anda
  3. Navigasi ke Tetapan → Akaun Perkhidmatan
  4. Klik Cipta Akaun Perkhidmatan
  5. Berikan nama (contohnya, "galleria-analytics") dan berikan kebenaran yang sesuai
  6. Salin token API yang dihasilkan untuk digunakan kemudian

Langkah 7: Konfigurasikan Galleria

  1. Log masuk ke panel admin Galleria anda
  2. Navigasi ke Tetapan → Analitik
  3. Masukkan URL OpenObserve anda (contoh: http://localhost:5080)
  4. Masukkan ID Organisasi anda
  5. Masukkan Nama Aliran anda (laman web)
  6. Masukkan Nama Pengguna anda (dari Langkah 2)
  7. Masukkan Kata Laluan anda (token akaun perkhidmatan dari Langkah 2)
  8. Klik Simpan untuk membolehkan analitik OpenObserve

Kejayaan! Analitik anda kini akan merangkumi data geo-dikaya dengan bandar, wilayah, negara, ISP, dan koordinat untuk semua pelawat.

Penyulitan Video Perkakasan

Galleria menyokong penyulitan video yang dipercepatkan perkakasan untuk pemprosesan video 5-10x lebih pantas menggunakan GPU anda.

Perkakasan yang Disokong

GPU NVIDIA (NVENC)

Sokongan Docker dan asli

Intel Quick Sync (QSV)

Sokongan asli sahaja

GPU AMD (AMF)

Sokongan asli sahaja

Apple VideoToolbox

hanya asli macOS

Aktifkan Pengekodan Perkakasan

  1. Pergi ke Panel Admin → Tetapan → Kualiti Video
  2. Togol "Pentranskoding Perkakasan" kepada diaktifkan
  3. Pemprosesan video kini akan menggunakan penggalakan GPU apabila tersedia

Penyebaran Pengeluaran

Menggunakan PM2

Untuk penyebaran pengeluaran tanpa Docker:

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

Penyebaran Automatik: Tolak ke cabang utama dan GitHub Actions secara automatik menyebarkan perubahan anda.

Bantu Tingkatkan Dokumentasi Ini

Menemui ralat atau ingin menyumbang kepada dokumentasi? Kami mengalu-alukan sumbangan!

Sumbang di GitHub