FAQ - 자주 묻는 질문 | PreviewFile.dev

PreviewFile.dev 기능, 가격, 보안 및 기술 구현에 대한 일반적인 질문들.

일반 질문

PreviewFile.dev란 무엇인가요?

PreviewFile.dev는 110+ 파일 형식의 단기간 사용자 정의 가능한 미리보기 링크를 생성하는 보안 파일 미리보기 서비스입니다. 원본 URL을 노출하거나 다운로드를 요구하지 않고 PDF, Office 문서, 이미지, 비디오 등을 공유할 수 있습니다.

→ 시작하기에서 자세히 알아보기

어떤 파일 형식이 지원되나요?

110+ 형식을 지원합니다:

문서: PDF, DOCX, PPTX, XLSX, TXT, MD
이미지: JPG, PNG, GIF, WebP, SVG, TIFF
비디오: MP4, WebM, MOV, AVI
코드: JS, Python, Java, Go 및 50+ 언어
아카이브: ZIP, RAR, 7z, TAR

→ 전체 목록은 지원 형식에서 확인

가격은 어떻게 작동하나요?

무료: 100 미리보기/월, 15분 TTL
Pro: 10,000 미리보기/월, 사용자 정의 워터마크, 24시간 TTL
팀: 100,000 미리보기/월, 화이트라벨, SSO
엔터프라이즈: 무제한, SLA, 전용 지원

→ 플랜 비교는 가격에서 확인

기술 질문

미리보기 링크를 어떻게 생성하나요?

REST API를 사용하여 프로그래밍 방식으로 미리보기 링크를 생성:

curl -X POST https://previewfile.dev/api/u \
  -H "x-api-key: $API_KEY" \
  -d '{"url": "https://example.com/file.pdf", "ttlMinutes": 60}'

→ 전체 가이드는 API 문서에서 확인

제 파일을 저장하나요?

아니요. 메타데이터와 썸네일만 캐시합니다.

→ 아키텍처에 대한 내용은 보안 정책에서 확인

민감한 문서에 사용할 수 있나요?

네. 다음 보안 기능을 활성화하세요:

시간 제한 링크: 5분에서 24시간까지 자동 만료
워터마크: 사용자 정의 텍스트 오버레이 추가
다운로드 금지 모드: 파일 다운로드 방지
일회성 링크: 첫 번째 액세스 후 만료

→ 모든 옵션은 보안 정책에서 확인

링크가 만료되면 어떻게 되나요?

만료된 링크는 "링크 만료됨" 오류 페이지를 표시합니다. 미리보기 메타데이터는 데이터베이스에서 자동으로 삭제되고, 캐시된 썸네일은 1시간 내에 제거됩니다.

앱에 미리보기를 임베드할 수 있나요?

네. 미리보기 URL로 <iframe>을 사용:

<iframe src="https://previewfile.dev/p/abc123" 
        width="100%" height="600px"></iframe>

팀 플랜은 임베드가 작동하는 위치를 제한하는 도메인 화이트리스트를 지원합니다.

→ API 세부사항은 API 문서에서 확인

보안 질문

원본 URL이 노출되나요?

아니요. 수신자는 짧은 미리보기 URL(예: previewfile.dev/p/abc123)만 봅니다. 원본 파일 URL은 브라우저나 네트워크 로그에서 볼 수 없습니다.

워터마크는 어떻게 작동하나요?

워터마크는 Canvas/GPU 오버레이를 사용하여 클라이언트 측에서 렌더링됩니다. 텍스트, 위치, 불투명도를 사용자 정의할 수 있습니다. 팀 플랜은 사용자 정의 글꼴과 로고를 지원합니다.

→ 설정 가이드는 보안 정책에서 확인

IP나 리퍼러로 액세스를 제한할 수 있나요?

네(팀+ 플랜). 다음을 구성:

IP 화이트리스트: 특정 IP만 허용
리퍼러 제한: 핫링킹 차단
User-Agent 검증: 자동 스크래핑 방지

→ 고급 제어는 보안 정책에서 확인

GDPR/HIPAA를 준수하나요?

엔터프라이즈 플랜에는 다음이 포함됩니다:

데이터 처리 계약(DPA)
모든 액세스 이벤트의 감사 로그
지역 데이터 거주 옵션
SOC 2 Type II 인증

컴플라이언스 문서는 영업팀에 문의하세요.

제품 질문

Free와 Pro의 차이점은 무엇인가요?

기능	Free	Pro
월간 미리보기	100	10,000
최대 TTL	15분	24시간
사용자 정의 워터마크	❌	✅
다운로드 제어	✅	✅
일회성 링크	✅	✅

→ 전체 비교는 가격에서 확인

미리보기 페이지를 화이트라벨할 수 있나요?

네(팀+ 플랜). 다음을 사용자 정의:

사용자 정의 도메인(preview.yourdomain.com)
브랜드화된 헤더/푸터
사용자 정의 CSS 테마
"Powered by PreviewFile" 푸터 제거

화이트라벨 설정은 영업팀에 문의하세요.

API 속도 제한이 있나요?

네. 플랜별 속도 제한:

무료: 100 요청/시간
Pro: 1,000 요청/시간
팀: 10,000 요청/시간
엔터프라이즈: 사용자 정의 제한

제한을 초과하면 HTTP 429와 Retry-After 헤더가 반환됩니다.

→ API 참조는 API 문서에서 확인

사용 분석을 얻을 수 있나요?

네. 대시보드에 표시:

생성된 총 미리보기
가장 많이 본 파일
지리적 분포
형식별 분석
만료 패턴

팀 플랜에는 CSV 내보내기와 웹훅 알림이 포함됩니다.

통합 질문

어떤 언어를 지원하나요?

다음에 대한 예제를 제공:

JavaScript/Node.js, Python, Java, C#, Go
Rust, PHP, Ruby, Swift, Kotlin

→ 코드 샘플은 API 문서에서 확인

AWS S3 / Google Cloud에서 사용할 수 있나요?

네. 스토리지 공급자에서 서명된 URL을 생성한 다음 PreviewFile에 전달:

const s3Url = await getSignedUrl(s3Client, getObjectCommand);
const preview = await fetch('/api/u', {
  body: JSON.stringify({ url: s3Url })
});

서명된 URL이 미리보기 TTL보다 오래 유효한지 확인하세요.

파일 확장자가 MIME 타입과 일치하는지 확인
형식이 지원 형식에 있는지 확인
원본 URL이 공개적으로 액세스 가능한지 확인
올바른 MIME 타입으로 다시 업로드 시도

미리보기 링크가 404를 반환함

일반적인 원인:

링크 만료(expireAt 타임스탬프 확인)
일회성 링크가 이미 액세스됨
잘못된 짧은 URL(오타 확인)

비디오/오디오 미리보기가 작동하지 않음

다음을 확인:

파일이 지원되는 코덱(H.264/AAC 권장)
원본 서버가 올바른 Content-Type 헤더를 전송
CORS 헤더가 크로스 오리진 액세스를 허용
파일 크기 < 500 MB로 최적 성능

→ 문제를 보고하려면 GitHub Issues에서

신용/직불 카드(Visa, Mastercard, Amex)
PayPal(팀+ 플랜)
송장/ACH(엔터프라이즈만)

비영리 단체에 대한 할인이 있나요?

네. 비영리 단체와 교육 기관은 Pro/팀 플랜에서 50% 할인을 받습니다. 상태 증명과 함께 영업팀에 문의하세요.

아직 질문이 있나요?

📧 이메일: [email protected]
💬 Discord: 커뮤니티 참여
🐦 Twitter: @previewfile
📖 문서: 모든 문서 탐색

FAQ - 자주 묻는 질문