문서

Galleria아 사진 포트폴리오를 배포하고 관리하는 완벽한 가이드.

시작하기

Galleria아는 React 19, TypeScript, Express 5 및 SQLite로 구축된 현대적인 사진 포트폴리오 웹사이트입니다. 최적화된 이미지 전송, 관리자 패널, 분석 추적 및 반응형 디자인을 특징으로 합니다.

빠른 링크

Google OAuth SSO 설정

Galleria 관리자 패널에 대한 안전하고 비밀번호 없는 인증을 위해 Google OAuth 단일 로그인 활성화.

1단계: Google Cloud 프로젝트 만들기

  1. Google Cloud Console로 이동
  2. 새 프로젝트를 만들거나 기존 프로젝트를 선택
  3. API 및 서비스 → 인증 정보로 이동
  4. 인증 정보 만들기 → OAuth 클라이언트 ID 클릭
  5. 프롬프트가 표시되면 먼저 OAuth 동의 화면을 구성

2단계: OAuth 클라이언트 구성

  1. 애플리케이션 유형으로 웹 애플리케이션 선택
  2. 허용된 JavaScript 출처에 도메인 추가:
    https://yourdomain.com
  3. 허용된 리디렉션 URI에 콜백 URL 추가:
    https://yourdomain.com/api/auth/google/callback
  4. 생성을 클릭하고 인증 정보를 저장

3단계: Galleria 설정에서 구성

  1. Galleria 관리자 패널에 로그인
  2. 설정 → Google OAuth로 이동
  3. Google 클라이언트 ID를 입력하세요
  4. Google 클라이언트 비밀을 입력하세요
  5. Google OAuth SSO를 활성화하려면 저장을 클릭하세요

자동 사용자 변환: 일치하는 이메일 주소를 가진 기존 사용자는 자동으로 Google OAuth 인증으로 변환됩니다. OAuth가 구성된 후 즉시 Google로 로그인할 수 있습니다.

보안 팁: 신뢰할 수 있는 이메일 주소만 관리자 사용자로 추가하세요. 초기 설정 후 관리자 패널에서 사용자 액세스를 관리할 수 있습니다.

OpenObserve 분석 설정

OpenObserve는 지리적 보강 기능을 갖춘 Galleria 웹사이트에 대한 강력한 로그 분석 및 실시간 모니터링을 제공합니다.

1단계: Docker로 OpenObserve 설치

Docker Compose를 사용하여 OpenObserve 실행:

2단계: 서비스 계정 생성

  1. http://localhost:5080에서 OpenObserve에 액세스
  2. 관리자 자격 증명으로 로그인
  3. 설정 → 서비스 계정으로 이동
  4. 서비스 계정 생성 클릭
  5. 이름을 지정하세요 (예: "galleria-analytics") 및 적절한 권한 부여
  6. 나중에 사용할 수 있도록 생성된 API 토큰을 복사하세요

7단계: Galleria아 구성

  1. Galleria아 관리 패널에 로그인합니다.
  2. 설정 → 분석으로 이동합니다.
  3. 귀하의 OpenObserve URL을 입력하십시오 (예: http://localhost:5080)
  4. 조직 ID를 입력하십시오.
  5. 스트림 이름(웹사이트)을 입력하십시오.
  6. 사용자 이름(2단계에서 가져온)을 입력하십시오.
  7. 비밀번호(2단계에서 가져온 서비스 계정 토큰)를 입력하십시오.
  8. OpenObserve 분석을 활성화하려면 저장을 클릭하십시오.

성공! 이제 귀하의 분석에는 모든 방문자의 도시, 지역, 국가, ISP 및 좌표가 포함된 지리적으로 풍부한 데이터가 포함됩니다.

하드웨어 비디오 인코딩

Galleria아는 GPU를 사용하여 5-10배 더 빠른 비디오 처리를 위한 하드웨어 가속 비디오 인코딩을 지원합니다.

지원되는 하드웨어

NVIDIA GPU (NVENC)

도커 및 네이티브 지원

Intel Quick Sync (QSV)

네이티브 지원만

AMD GPU (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에서 기여하기