เอกสาร

คู่มือฉบับสมบูรณ์ในการปรับใช้และจัดการพอร์ตโฟลิโอการถ่ายภาพ Galleria ของคุณ

เริ่มต้นใช้งาน

Galleria เป็นเว็บไซต์พอร์ตโฟลิโอการถ่ายภาพสมัยใหม่ที่สร้างขึ้นด้วย React 19, TypeScript, Express 5 และ SQLite มันมีการส่งภาพที่ปรับให้เหมาะสม, แผงผู้ดูแลระบบ, การติดตามการวิเคราะห์, และการออกแบบที่ตอบสนอง

ลิงค์ด่วน

การตั้งค่า Google OAuth SSO

เปิดใช้งาน Google OAuth Single Sign-On สำหรับการตรวจสอบสิทธิ์ที่ปลอดภัยและไม่ใช้รหัสผ่านไปยังแผงผู้ดูแลระบบ Galleria ของคุณ

ขั้นตอนที่ 1: สร้างโปรเจกต์ Google Cloud

  1. ไปที่ Google Cloud Console
  2. สร้างโปรเจกต์ใหม่หรือเลือกโปรเจกต์ที่มีอยู่
  3. ไปที่ APIs & Services → Credentials
  4. คลิก สร้าง Credentials → OAuth client ID
  5. หากมีการแจ้งเตือน ให้กำหนดค่าหน้าจอการอนุญาต OAuth ก่อน

ขั้นตอนที่ 2: กำหนดค่า OAuth Client

  1. เลือก Web application เป็นประเภทแอปพลิเคชัน
  2. เพิ่มโดเมนของคุณใน Authorized JavaScript origins:
    https://yourdomain.com
  3. เพิ่ม URL การเรียกกลับใน Authorized redirect URIs:
    https://yourdomain.com/api/auth/google/callback
  4. คลิก สร้าง และบันทึกข้อมูลประจำตัวของคุณ

ขั้นตอนที่ 3: กำหนดค่าในการตั้งค่า Galleria

  1. เข้าสู่ระบบไปยังแผงผู้ดูแลระบบ Galleria ของคุณ
  2. ไปที่ การตั้งค่า → Google OAuth
  3. กรุณาใส่ Google Client ID ของคุณ
  4. กรุณาใส่ Google Client Secret ของคุณ
  5. คลิกบันทึกเพื่อเปิดใช้งาน Google OAuth SSO

การแปลงผู้ใช้โดยอัตโนมัติ: ผู้ใช้ที่มีอยู่ที่มีที่อยู่อีเมลตรงกันจะถูกแปลงเป็นการตรวจสอบสิทธิ์ Google OAuth โดยอัตโนมัติ พวกเขาสามารถลงชื่อเข้าใช้ด้วย Google ได้ทันทีหลังจากที่ได้ตั้งค่า OAuth แล้ว

เคล็ดลับด้านความปลอดภัย: เพิ่มที่อยู่อีเมลที่เชื่อถือได้เท่านั้นในฐานะผู้ดูแลระบบ คุณสามารถจัดการการเข้าถึงผู้ใช้จากแผงผู้ดูแลระบบหลังจากการตั้งค่าเริ่มต้น

การตั้งค่า OpenObserve Analytics

OpenObserve ให้บริการการวิเคราะห์บันทึกที่ทรงพลังและการตรวจสอบแบบเรียลไทม์สำหรับเว็บไซต์ Galleria ของคุณพร้อมความสามารถในการเสริมข้อมูลทางภูมิศาสตร์

ขั้นตอนที่ 1: ติดตั้ง OpenObserve ด้วย Docker

เรียกใช้ OpenObserve โดยใช้ Docker Compose:

ขั้นตอนที่ 2: สร้างบัญชีบริการ

  1. เข้าถึง OpenObserve ที่ http://localhost:5080
  2. ลงชื่อเข้าใช้ด้วยข้อมูลประจำตัวผู้ดูแลระบบของคุณ
  3. ไปที่การตั้งค่า → บัญชีบริการ
  4. คลิกสร้างบัญชีบริการ
  5. ตั้งชื่อให้มัน (เช่น "galleria-analytics") และมอบสิทธิ์ที่เหมาะสม
  6. คัดลอกโทเค็น API ที่สร้างขึ้นเพื่อใช้ในภายหลัง

ขั้นตอนที่ 7: ตั้งค่ากาเลอเรีย

  1. เข้าสู่ระบบแผงผู้ดูแลระบบกาเลอเรียของคุณ
  2. ไปที่การตั้งค่า → การวิเคราะห์
  3. กรอก URL OpenObserve ของคุณ (เช่น, http://localhost:5080)
  4. กรอก ID องค์กรของคุณ
  5. กรอกชื่อสตรีมของคุณ (เว็บไซต์)
  6. กรอกชื่อผู้ใช้ของคุณ (จากขั้นตอนที่ 2)
  7. กรอกรหัสผ่านของคุณ (โทเค็นบัญชีบริการจากขั้นตอนที่ 2)
  8. คลิกบันทึกเพื่อเปิดใช้งานการวิเคราะห์ OpenObserve

สำเร็จ! การวิเคราะห์ของคุณจะรวมข้อมูลที่มีการเสริมภูมิศาสตร์ด้วยเมือง, ภูมิภาค, ประเทศ, ISP, และพิกัดสำหรับผู้เข้าชมทั้งหมด

การเข้ารหัสวิดีโอด้วยฮาร์ดแวร์

กาเลอเรียรองรับการเข้ารหัสวิดีโอด้วยฮาร์ดแวร์ที่เร่งความเร็วเพื่อการประมวลผลวิดีโอที่เร็วขึ้น 5-10 เท่าด้วย GPU ของคุณ

ฮาร์ดแวร์ที่รองรับ

NVIDIA GPUs (NVENC)

การสนับสนุน Docker และพื้นเมือง

Intel Quick Sync (QSV)

การสนับสนุนเฉพาะพื้นเมือง

GPU ของ AMD (AMF)

รองรับเฉพาะแบบเนทีฟ

Apple VideoToolbox

เฉพาะ macOS เท่านั้น

เปิดใช้งานการเข้ารหัสฮาร์ดแวร์

  1. ไปที่แผงผู้ดูแลระบบ → การตั้งค่า → คุณภาพวิดีโอ
  2. เปลี่ยน "การแปลงสัญญาณฮาร์ดแวร์" เป็นเปิดใช้งาน
  3. การประมวลผลวิดีโอจะใช้การเร่งความเร็ว GPU เมื่อมีให้ใช้งาน

การปรับใช้ในสภาพแวดล้อมการผลิต

ใช้ PM2

สำหรับการปรับใช้ในสภาพแวดล้อมการผลิตโดยไม่ใช้ Docker:

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

การปรับใช้โดยอัตโนมัติ: ดันไปยังสาขาหลักและ GitHub Actions จะปรับใช้การเปลี่ยนแปลงของคุณโดยอัตโนมัติ.

ช่วยปรับปรุงเอกสารนี้

พบข้อผิดพลาดหรืออยากมีส่วนร่วมในเอกสาร? เราต้อนรับการมีส่วนร่วม!

มีส่วนร่วมบน GitHub