Tài liệu

Hướng dẫn đầy đủ để triển khai và quản lý danh mục đầu tư nhiếp ảnh Galleria của bạn.

Bắt đầu

Galleria là một trang web danh mục đầu tư nhiếp ảnh hiện đại được xây dựng với React 19, TypeScript, Express 5 và SQLite. Nó có tính năng phân phối hình ảnh tối ưu, bảng điều khiển quản trị, theo dõi phân tích và thiết kế đáp ứng.

Liên kết nhanh

Cài đặt Google OAuth SSO

Bật Google OAuth Đăng nhập một lần để xác thực an toàn, không cần mật khẩu cho bảng điều khiển quản trị Galleria của bạn.

Bước 1: Tạo Dự án Google Cloud

  1. Đi đến Bảng điều khiển Google Cloud
  2. Tạo một dự án mới hoặc chọn một dự án hiện có
  3. Đi tới APIs & Services → Thông tin xác thực
  4. Nhấp vào Tạo Thông tin xác thực → ID khách hàng OAuth
  5. Nếu được nhắc, hãy cấu hình màn hình đồng ý OAuth trước

Bước 2: Cấu hình Khách hàng OAuth

  1. Chọn ứng dụng Web làm loại ứng dụng
  2. Thêm miền của bạn vào các nguồn JavaScript được ủy quyền:
    https://yourdomain.com
  3. Thêm URL callback vào các URI chuyển hướng được ủy quyền:
    https://yourdomain.com/api/auth/google/callback
  4. Nhấp vào Tạo và lưu thông tin xác thực của bạn

Bước 3: Cấu hình trong Cài đặt Galleria

  1. Đăng nhập vào bảng điều khiển quản trị Galleria của bạn
  2. Đi tới Cài đặt → Google OAuth
  3. Nhập ID khách hàng Google của bạn
  4. Nhập bí mật khách hàng Google của bạn
  5. Nhấn Lưu để kích hoạt Google OAuth SSO

Chuyển đổi người dùng tự động: Những người dùng hiện có với địa chỉ email trùng khớp sẽ tự động được chuyển đổi sang xác thực Google OAuth. Họ có thể đăng nhập bằng Google ngay sau khi OAuth được cấu hình.

Mẹo bảo mật: Chỉ thêm những địa chỉ email đáng tin cậy làm người dùng quản trị. Bạn có thể quản lý quyền truy cập của người dùng từ bảng quản trị sau khi thiết lập ban đầu.

Cài đặt OpenObserve Analytics

OpenObserve cung cấp phân tích nhật ký mạnh mẽ và giám sát thời gian thực cho trang web Galleria của bạn với khả năng làm phong phú địa lý.

Bước 1: Cài đặt OpenObserve với Docker

Chạy OpenObserve bằng Docker Compose:

Bước 2: Tạo Tài khoản Dịch vụ

  1. Truy cập OpenObserve tại http://localhost:5080
  2. Đăng nhập bằng thông tin quản trị của bạn
  3. Đi tới Cài đặt → Tài khoản Dịch vụ
  4. Nhấn Tạo Tài khoản Dịch vụ
  5. Đặt tên cho nó (ví dụ: "galleria-analytics") và gán quyền phù hợp
  6. Sao chép mã thông báo API được tạo để sử dụng sau này

Bước 7: Cấu hình Galleria

  1. Đăng nhập vào bảng điều khiển quản trị Galleria của bạn
  2. Đi tới Cài đặt → Phân tích
  3. Nhập URL OpenObserve của bạn (ví dụ: http://localhost:5080)
  4. Nhập ID Tổ chức của bạn
  5. Nhập Tên Luồng của bạn (trang web)
  6. Nhập Tên người dùng của bạn (từ Bước 2)
  7. Nhập Mật khẩu của bạn (mã thông báo tài khoản dịch vụ từ Bước 2)
  8. Nhấp vào Lưu để kích hoạt phân tích OpenObserve

Thành công! Phân tích của bạn giờ đây sẽ bao gồm dữ liệu được làm phong phú theo địa lý với thành phố, khu vực, quốc gia, ISP và tọa độ cho tất cả khách truy cập.

Mã hóa Video Phần cứng

Galleria hỗ trợ mã hóa video tăng tốc phần cứng để xử lý video nhanh hơn 5-10 lần bằng cách sử dụng GPU của bạn.

Phần cứng được hỗ trợ

GPU NVIDIA (NVENC)

Hỗ trợ Docker và bản địa

Intel Quick Sync (QSV)

Chỉ hỗ trợ bản địa

GPU AMD (AMF)

Chỉ hỗ trợ bản địa

Apple VideoToolbox

Chỉ hỗ trợ macOS bản địa

Kích hoạt Mã hóa Phần cứng

  1. Đi tới Bảng Quản Trị → Cài Đặt → Chất Lượng Video
  2. Chuyển "Chuyển mã Phần cứng" sang trạng thái kích hoạt
  3. Quá trình xử lý video bây giờ sẽ sử dụng tăng tốc GPU khi có sẵn

Triển khai Sản xuất

Sử dụng PM2

Đối với triển khai sản xuất không có Docker:

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

Triển khai Tự động: Đẩy lên nhánh chính và GitHub Actions tự động triển khai các thay đổi của bạn.

Giúp Cải Thiện Tài Liệu Này

Phát hiện lỗi hoặc muốn đóng góp cho tài liệu? Chúng tôi hoan nghênh các đóng góp!

Đóng góp trên GitHub