❓ 어드민 자주 묻는 질문 (FAQ)

본 문서는 어드민 페이지 관리 시 발생할 수 있는 백업 복원, 외부 이미지 저장소 연동, 대시보드 통계 관련 자주 묻는 질문의 원인과 확인 사항을 안내합니다.

---

🗄️ Q1. 백업 데이터 가져오기(Restore) 시 오류가 발생합니다.

백업 파일 선택 후 복원 진행 시 오류가 발생하는 경우의 점검 사항입니다.

💡 주요 점검 사항

1. 백업 파일 손상:
   • 다운로드 중 텍스트가 정상적으로 저장되지 않은 경우 복원에 실패할 수 있습니다. .json 파일을 메모장 등으로 열어 온전한 데이터 형식인지 확인합니다.
2. 메뉴 경로 불일치:
   • 데이터 종류에 맞는 복원 메뉴를 사용해야 합니다. 포스트 데이터는 콘텐츠 백업 메뉴의 데이터 백업 및 복원 섹션, 이미지 미디어 파일은 콘텐츠 백업 메뉴의 미디어 백업 및 복원 섹션, 전체 시스템 데이터는 사이트 설정 메뉴의 시스템 전체 백업 및 복원 섹션에서 복원을 수행해야 합니다.
3. 데이터베이스(D1) 연결 바인딩:
   • Cloudflare의 데이터베이스(D1) 연결 정보가 정상적으로 연동되어 있는지 관리 콘솔에서 확인합니다.

---

📂 Q2. 이미지 저장소 변경 후 업로드 또는 표시 오류가 발생합니다.

기본 저장소(KV)에서 R2, Supabase, ImageKit 등으로 변경한 후 업로드 오류가 발생하거나 이미지가 표시되지 않는 현상에 대한 원인 분석입니다.

💡 주요 점검 사항

1. Cloudflare R2:
   • 프로젝트 설정에 IMAGES R2 버킷 바인딩이 연결되어 있는지 확인합니다 (wrangler.json).
2. Supabase Storage:
   • 입력한 API 주소(supabase_storage_url), 서비스 롤 키(supabase_storage_key), 버킷명(supabase_storage_bucket)의 정확성을 확인합니다. 특히 버킷의 접근 권한이 **Public(공개)**으로 설정되어야 이미지가 정상 노출됩니다.
3. ImageKit.io:
   • 엔드포인트 주소(imagekit_url_endpoint)의 형식을 확인하고, 도메인 간 보안 차단(CORS) 설정을 점검합니다.
4. 업로드 크기 제한:
   • 에지 서버 환경의 1회 전송 용량 제한으로 인해 대용량 이미지는 업로드에 실패할 수 있으므로, 원본 이미지의 크기를 조정하여 업로드합니다.

---

📊 Q3. 대시보드 통계 그래프가 데모 데이터로만 표시됩니다.

대시보드 메인 화면에 실제 방문 트래픽 통계 대신 데모 데이터가 표시되는 경우의 확인 사항입니다.

💡 주요 점검 사항

• 원인: 구글 애널리틱스 4(GA4) API 환경변수가 입력되지 않았거나 비정상적인 경우, 오류 방지를 위해 임시 데모 데이터가 대체 표시됩니다.
• 설정 방법: Cloudflare Pages 설정에 아래 환경변수를 입력하고 다시 배포합니다.
  • GA4_PROPERTY_ID: 구글 애널리틱스 속성 ID
  • GA4_CLIENT_EMAIL: 구글 클라우드 서비스 계정 이메일
  • GA4_PRIVATE_KEY: 구글 서비스 계정 비공개 키
• 구글 애드센스: 수익 대시보드 연동을 원할 경우 ADSENSE_ACCOUNT_ID 환경변수 키 값이 바르게 입력되었는지 확인합니다.