❓ 어드민 자주 묻는 질문 (FAQ)
본 문서는 어드민 페이지 관리 시 발생할 수 있는 백업 복원, 외부 이미지 저장소 연동, 대시보드 통계 관련 자주 묻는 질문의 원인과 확인 사항을 안내합니다.
🗄️ Q1. 백업 데이터 가져오기(Restore) 시 오류가 발생합니다.
백업 파일 선택 후 복원 진행 시 오류가 발생하는 경우의 점검 사항입니다.
💡 주요 점검 사항
- 백업 파일 손상:
- 다운로드 중 텍스트가 정상적으로 저장되지 않은 경우 복원에 실패할 수 있습니다.
.json파일을 메모장 등으로 열어 온전한 데이터 형식인지 확인합니다.
- 다운로드 중 텍스트가 정상적으로 저장되지 않은 경우 복원에 실패할 수 있습니다.
- 메뉴 경로 불일치:
- 데이터 종류에 맞는 복원 메뉴를 사용해야 합니다. 포스트 데이터는
콘텐츠 백업메뉴의데이터 백업 및 복원섹션, 이미지 미디어 파일은콘텐츠 백업메뉴의미디어 백업 및 복원섹션, 전체 시스템 데이터는사이트 설정메뉴의시스템 전체 백업 및 복원섹션에서 복원을 수행해야 합니다.
- 데이터 종류에 맞는 복원 메뉴를 사용해야 합니다. 포스트 데이터는
- 데이터베이스(D1) 연결 바인딩:
- Cloudflare의 데이터베이스(D1) 연결 정보가 정상적으로 연동되어 있는지 관리 콘솔에서 확인합니다.
📂 Q2. 이미지 저장소 변경 후 업로드 또는 표시 오류가 발생합니다.
기본 저장소(KV)에서 R2, Supabase, ImageKit 등으로 변경한 후 업로드 오류가 발생하거나 이미지가 표시되지 않는 현상에 대한 원인 분석입니다.
💡 주요 점검 사항
- Cloudflare R2:
- 프로젝트 설정에
IMAGESR2 버킷 바인딩이 연결되어 있는지 확인합니다 (wrangler.json).
- 프로젝트 설정에
- Supabase Storage:
- 입력한 API 주소(
supabase_storage_url), 서비스 롤 키(supabase_storage_key), 버킷명(supabase_storage_bucket)의 정확성을 확인합니다. 특히 버킷의 접근 권한이 **Public(공개)**으로 설정되어야 이미지가 정상 노출됩니다.
- 입력한 API 주소(
- ImageKit.io:
- 엔드포인트 주소(
imagekit_url_endpoint)의 형식을 확인하고, 도메인 간 보안 차단(CORS) 설정을 점검합니다.
- 엔드포인트 주소(
- 업로드 크기 제한:
- 에지 서버 환경의 1회 전송 용량 제한으로 인해 대용량 이미지는 업로드에 실패할 수 있으므로, 원본 이미지의 크기를 조정하여 업로드합니다.
📊 Q3. 대시보드 통계 그래프가 데모 데이터로만 표시됩니다.
대시보드 메인 화면에 실제 방문 트래픽 통계 대신 데모 데이터가 표시되는 경우의 확인 사항입니다.
💡 주요 점검 사항
- 원인: 구글 애널리틱스 4(GA4) API 환경변수가 입력되지 않았거나 비정상적인 경우, 오류 방지를 위해 임시 데모 데이터가 대체 표시됩니다.
- 설정 방법: Cloudflare Pages 설정에 아래 환경변수를 입력하고 다시 배포합니다.
GA4_PROPERTY_ID: 구글 애널리틱스 속성 IDGA4_CLIENT_EMAIL: 구글 클라우드 서비스 계정 이메일GA4_PRIVATE_KEY: 구글 서비스 계정 비공개 키
- 구글 애드센스: 수익 대시보드 연동을 원할 경우
ADSENSE_ACCOUNT_ID환경변수 키 값이 바르게 입력되었는지 확인합니다.
댓글 0개
댓글을 작성하려면 로그인이 필요합니다.