Τεκμηρίωση

Πλήρης οδηγός για την ανάπτυξη και διαχείριση του φωτογραφικού πορτφόλιο Galleria.

Ξεκινώντας

Η Galleria είναι ένας σύγχρονος ιστότοπος φωτογραφικού πορτφόλιο που έχει κατασκευαστεί με React 19, TypeScript, Express 5 και SQLite. Διαθέτει βελτιστοποιημένη παράδοση εικόνας, πίνακα διαχείρισης, παρακολούθηση αναλύσεων και responsive design.

Γρήγοροι σύνδεσμοι

Ρύθμιση Google OAuth SSO

Ενεργοποιήστε την Ενιαία Σύνδεση Google OAuth για ασφαλή, χωρίς κωδικό πρόσβασης αυθεντικοποίηση στο πάνελ διαχείρισης της Γκαλερί σας.

Βήμα 1: Δημιουργία Έργου Google Cloud

  1. Μεταβείτε στην κονσόλα Google Cloud
  2. Δημιουργήστε ένα νέο έργο ή επιλέξτε ένα υπάρχον
  3. Μεταβείτε στις APIs & Υπηρεσίες → Διαπιστευτήρια
  4. Κάντε κλικ στο Δημιουργία Διαπιστευτηρίων → ID πελάτη OAuth
  5. Εάν σας ζητηθεί, ρυθμίστε πρώτα την οθόνη συγκατάθεσης OAuth

Βήμα 2: Ρύθμιση Πελάτη OAuth

  1. Επιλέξτε Εφαρμογή ιστού ως τύπο εφαρμογής
  2. Προσθέστε το τομέα σας στις Εξουσιοδοτημένες προελεύσεις JavaScript:
    https://yourdomain.com
  3. Προσθέστε το URL επιστροφής στις Εξουσιοδοτημένες διευθύνσεις URI ανακατεύθυνσης:
    https://yourdomain.com/api/auth/google/callback
  4. Κάντε κλικ στο Δημιουργία και αποθηκεύστε τα διαπιστευτήριά σας

Βήμα 3: Ρύθμιση στις Ρυθμίσεις Γκαλερί

  1. Συνδεθείτε στο πάνελ διαχείρισης της Γκαλερί σας
  2. Μεταβείτε στις Ρυθμίσεις → Google OAuth
  3. Εισάγετε το Google Client ID σας
  4. Εισάγετε το Google Client Secret σας
  5. Κάντε κλικ στο Αποθήκευση για να ενεργοποιήσετε το Google OAuth SSO

Αυτόματη Μετατροπή Χρηστών: Υπάρχοντες χρήστες με αντίστοιχες διευθύνσεις email θα μετατραπούν αυτόματα σε αυθεντικοποίηση Google OAuth. Μπορούν να συνδεθούν με το Google αμέσως μετά την παραμετροποίηση του OAuth.

Συμβουλή Ασφαλείας: Προσθέστε μόνο αξιόπιστες διευθύνσεις email ως διαχειριστές. Μπορείτε να διαχειριστείτε την πρόσβαση χρηστών από τον πίνακα διαχείρισης μετά την αρχική ρύθμιση.

Ρύθμιση Αναλύσεων OpenObserve

Το OpenObserve παρέχει ισχυρές αναλύσεις καταγραφών και παρακολούθηση σε πραγματικό χρόνο για την ιστοσελίδα Galleria σας με δυνατότητες γεω-εμπλουτισμού.

Βήμα 1: Εγκαταστήστε το OpenObserve με Docker

Εκτελέστε το OpenObserve χρησιμοποιώντας το Docker Compose:

Βήμα 2: Δημιουργία Λογαριασμού Υπηρεσίας

  1. Πρόσβαση στο OpenObserve στο http://localhost:5080
  2. Συνδεθείτε με τα διαπιστευτήρια διαχειριστή σας
  3. Μεταβείτε στις Ρυθμίσεις → Λογαριασμοί Υπηρεσίας
  4. Κάντε κλικ στην Δημιουργία Λογαριασμού Υπηρεσίας
  5. Δώστε του ένα όνομα (π.χ., "galleria-analytics") και αναθέστε τις κατάλληλες άδειες
  6. Αντιγράψτε το παραγόμενο API token για μελλοντική χρήση

Βήμα 7: Ρύθμιση Galleria

  1. Συνδεθείτε στον πίνακα διαχείρισης Galleria
  2. Μεταβείτε στις Ρυθμίσεις → Αναλύσεις
  3. Εισάγετε το URL του OpenObserve σας (π.χ., http://localhost:5080)
  4. Εισάγετε το ID Οργάνωσής σας
  5. Εισάγετε το Όνομα Ροής σας (ιστοσελίδα)
  6. Εισάγετε το Όνομα Χρήστη σας (από το Βήμα 2)
  7. Εισάγετε τον Κωδικό σας (το διακριτικό του λογαριασμού υπηρεσίας από το Βήμα 2)
  8. Κάντε κλικ στην Αποθήκευση για να ενεργοποιήσετε τις αναλύσεις του OpenObserve

Επιτυχία! Οι αναλύσεις σας θα περιλαμβάνουν τώρα γεω- εμπλουτισμένα δεδομένα με πόλη, περιοχή, χώρα, ISP και συντεταγμένες για όλους τους επισκέπτες.

Κωδικοποίηση Βίντεο Υλικού

Η Galleria υποστηρίζει κωδικοποίηση βίντεο επιταχυνόμενη από υλικό για 5-10x ταχύτερη επεξεργασία βίντεο χρησιμοποιώντας την GPU σας.

Υποστηριζόμενο Υλικό

NVIDIA GPUs (NVENC)

Υποστήριξη Docker και εγγενής υποστήριξη

Intel Quick Sync (QSV)

Μόνο εγγενής υποστήριξη

AMD GPUs (AMF)

Μοναδική υποστήριξη

Apple VideoToolbox

Μόνο macOS

Ενεργοποίηση Υλικού Κωδικοποίησης

  1. Μεταβείτε στο Πίνακα Διαχείρισης → Ρυθμίσεις → Ποιότητα Βίντεο
  2. Ενεργοποιήστε το "Hardware Transcoding"
  3. Η επεξεργασία βίντεο θα χρησιμοποιεί τώρα επιτάχυνση GPU όταν είναι διαθέσιμη

Ανάπτυξη Παραγωγής

Χρησιμοποιώντας PM2

Για ανάπτυξη παραγωγής χωρίς Docker:

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

Αυτοματοποιημένη Ανάπτυξη: Σπρώξτε στον κύριο κλάδο και οι GitHub Actions αναπτύσσουν αυτόματα τις αλλαγές σας.

Βοηθήστε να βελτιωθεί αυτή η τεκμηρίωση

Βρήκατε ένα σφάλμα ή θέλετε να συμβάλετε στην τεκμηρίωση; Καλωσορίζουμε τις συνεισφορές!

Συμβάλετε στο GitHub