손상된 PDF 복구하기
PDF 복구는 손상된 PDF를 qpdf로 다시 써서 상호 참조 표를 재구성해 파일이 다시 열리게 합니다. qpdf가 읽을 수 있는 부분은 살리지만 빠진 이미지나 망가진 데이터는 되살리지 못합니다.
여기에 파일을 끌어다 놓거나, 클릭해 고릅니다
PDF 지원 · 파일당 최대 500.0 MB · 한 번에 최대 20개 파일
Ctrl/Cmd+V 또는 클립보드 메뉴로 파일을 붙여넣을 수도 있습니다.
PDF 복구는 파일을 다시 읽어 qpdf로 다시 씁니다(`qpdf input -- output`). 이 재작성은 xref를 다시 만들며, qpdf가 여전히 파싱할 수 있는 파일을 살릴 수 있습니다. 불에 탄 스트림, 빠진 이미지, DRM을 되살리는 포렌식 복원기가 아닙니다.
옵션은 없습니다. qpdf가 파일을 읽을 수 없으면 작업이 실패합니다. 비밀번호로 보호된 파일은 이 페이지에서 비밀번호를 입력하면 해제됩니다(API 호출자는 먼저 비밀번호 해제를 실행). PDF 복구는 비밀번호를 알아내는 도구가 아닙니다.
이미 열리는 파일은 객체 수준에서 조금 달라진 채로 돌아올 수 있지만 화면에서는 똑같이 보입니다.
스트림만 더 작게 만들고 싶다면 PDF 압축이 명시적인 패킹 도구입니다. 주석을 페이지 내용으로 바꿔야 한다면 PDF 평면화를 쓰세요.
실질적인 질문은 파일이 아예 열리느냐입니다. 뷰어가 빈 창이나 "파일이 손상되었습니다" 알림을 보여 주거나 중간에 멈춘다면 상호 참조 테이블(각 객체가 파일의 어디에 있는지 리더에게 알려 주는 색인)이 흔한 원인이며, qpdf가 하는 일이 바로 그 색인을 다시 쓰는 것입니다. 파일은 열리지만 글꼴이 빠졌거나 글자가 깨져 보인다면 문제는 콘텐츠 자체에 있으므로 구조를 다시 쓰는 것으로는 바뀌지 않습니다.
결과는 업로드한 파일 이름에 `.pdf` 확장자를 붙인 새 파일입니다. 원본은 절대 수정되지 않으므로 언제든 둘을 비교할 수 있습니다. 재작성이 성공했다는 것은 qpdf가 문서를 파싱해 쓸 수 있었다는 것만 증명하며 모든 페이지가 렌더링된다는 보장은 아니므로, 원본을 삭제하기 전에 결과를 열어 페이지를 넘겨 보세요.
기능
- 추가 플래그 없는 qpdf 재작성
- qpdf가 파싱할 수 있는 일부 xref/구조 문제를 해결
- 콘텐츠 복원기가 아님
- 익명 API: /api/v1/misc/repair
이런 경우에
- 다른 도구가 부실하게 쓴 내보내기 파일의 xref 다시 만들기
- 조금 손상된 파일을 포기하기 전에 qpdf 시도하기
- PDF 병합 전에 구조 정규화하기
- 메일 게이트웨이나 파일 동기화 클라이언트가 잘못 다시 쓴 PDF 중 색인만 손상된 것 구하기
- 브라우저에서는 열리지만 더 엄격한 데스크톱 리더가 거부하는 파일의 깨끗한 사본 만들기
- 보낸 사람에게 새 사본을 요청하기 전에 오래되었거나 특이한 생성기로 만든 내보내기 파일 다시 시도하기
손상된 PDF를 복구하려면?
- 로컬 qpdf가 여전히 열 수 있을 법한 PDF를 업로드합니다.
- 처리를 누릅니다. 복구 수준 옵션은 없습니다.
- 다시 쓴 PDF를 내려받습니다.
- 열어 봅니다. qpdf가 실패했다면 디스크에 있는 것은 여전히 원본입니다.
- 첫 페이지뿐 아니라 결과의 마지막 페이지까지 스크롤하세요. 파일 끝부분의 손상이 가장 흔하며, 1페이지가 열리는 재작성 결과도 끝부분이 빠져 있을 수 있습니다.
- 페이지 수가 기대보다 적다면 멈추고, 줄어든 사본을 믿지 말고 원본을 다시 내려받거나 다시 내보내세요.
제한과 경계
- 깊은 객체 복원 없음
- 다시 쓰기가 성공해도 모든 페이지가 렌더링된다는 보장은 없으니 결과를 확인할 것
- 파일에서 빠진 이미지나 글꼴 데이터는 다시 만들 수 없음
- 무엇을 고쳤는지에 대한 로그는 반환되지 않고 새 파일만 반환됨
- 비밀번호 해제가 아님
- qpdf가 읽을 수 없는 파일은 실패
- 이 사이트의 업로드 한도는 파일당 500MB이며, 약 95MB를 넘으면 나누어 전송합니다. API 직접 요청 한 건의 본문은 100MB까지입니다.
예시
- xref가 엉망이어도 qpdf가 읽을 수 있는 PDF는 PDF 복구 후 열리는 경우가 많음
- 스트림 중간에서 잘린 파일은 대개 오류가 남
- 색인이 엉뚱한 바이트 오프셋을 가리키는 40페이지 내보내기: 뷰어가 손상을 알리지만 PDF 복구는 정상적으로 열리는 40페이지 파일을 돌려줌
- 60퍼센트에서 멈춘 다운로드: PDF 복구는 바로 실패하거나 더 짧은 파일을 돌려주며, 올바른 다음 단계는 다시 내려받는 것
- 읽을 수 없는 페이지 이미지가 하나 있는 스캔 파일: 구조는 고쳐질 수 있지만 그 페이지는 여전히 비어 있거나 깨져 보임
이 도구의 개인정보 안내
파일은 HTTPS로 업로드되며, 서버 메모리 또는 수명이 짧은 임시 디렉터리에서 처리되고, 결과가 준비되면 삭제됩니다. 이후 열람·학습·광고 프로필용 사본은 보관하지 않습니다. 보관 기간과 AdSense 쿠키 고지는 개인정보 처리방침을 참고하세요.
자주 묻는 질문
- PDF가 브라우저에서는 열리지만 Acrobat에서는 열리지 않습니다. PDF 복구를 실행해야 하나요?
- 예, 잘 맞는 경우입니다. 브라우저는 깨진 색인에 데스크톱 리더보다 관대한 경우가 많고, qpdf로 다시 쓰면 구조가 정규화되어 더 엄격한 리더도 받아들입니다. 다시 쓴 뒤에도 열리지 않는다면 손상은 콘텐츠 스트림 안에 있습니다.
- 실패하면 어떻게 보이나요?
- 작업이 파일 대신 오류를 반환합니다. qpdf가 문서를 쓸 수 있을 만큼 파싱하지 못했다는 뜻입니다. 원본을 다시 내려받거나, 원본 애플리케이션에서 다시 내보내거나, 그 파일을 만든 프로그램에서 열어 새 사본으로 저장해 보세요.
- 파일 크기가 바뀌나요?
- 객체를 다시 쓰기 때문에 약간 늘거나 줄 수 있습니다. PDF 복구는 이미지를 다시 압축하지 않으므로 큰 감소는 기대하지 마세요. 크기가 목표라면 PDF 압축을 쓰세요.
- 이미 잘 열리는 파일에도 PDF 복구를 실행해도 되나요?
- 됩니다. 구조가 깔끔하게 정리된 사본을 얻으며, 눈에 보이는 페이지에는 차이가 없어야 합니다. 입력 파일 중 하나가 PDF 병합이나 PDF 분할에서 오류를 일으켰다면 그 전에 거치는 정규화 단계로 적당합니다.
- 잘려 나간 페이지를 PDF 복구가 되살려 주나요?
- 아니요. 파일에서 데이터가 사라진 페이지는 그대로 없습니다. PDF 복구는 아직 읽을 수 있는 것만 다시 쓸 수 있습니다.
- 끊긴 다운로드를 복구할 수 있나요?
- qpdf가 여전히 파싱할 수 있을 때만 가능합니다. 잘린 파일 중 많은 수가 바로 실패합니다.
- PDF 복구가 암호를 해독하나요?
- 비밀번호 없이 열리는 파일(소유자 비밀번호 제한)에 한해서만 그렇고, 그런 파일은 암호화가 없는 상태로 돌아옵니다. 열려면 비밀번호가 필요한 파일은 거절되므로, 사용할 권한이 있는 비밀번호로 비밀번호 해제를 사용하세요.
- PDF 압축과 같은 건가요?
- 아니요. PDF 복구는 순수한 qpdf 재작성입니다. PDF 압축은 스트림과 객체 스트림 플래그를 추가합니다.
- 텍스트가 바뀌나요?
- 단어를 다시 쓰는 방식으로는 바뀌지 않습니다. 객체 번호와 오프셋은 대개 바뀝니다.
최종 업데이트:
코드에서 호출하기
이 사이트의 도구는 모두 일반 REST 엔드포인트입니다. 익명 사용에는 계정이나 API 키가 필요 없습니다. 브라우저뿐 아니라 개발자와 AI 에이전트도 그대로 쓸 수 있습니다.
curl -X POST "https://pdf123.xyz/api/v1/misc/repair" \
-F "[email protected]" \
-o output.pdfModel Context Protocol을 쓰는 에이전트 클라이언트용 MCP 도구로도 제공합니다(JSON-RPC 2.0, POST /mcp). 전체 API 문서
AI 에이전트에서 사용하기
스킬이 스킬을 설치하면 Claude Code, Codex, Cursor 등 AI 에이전트가 'PDF 복구' 작업을 대신 실행합니다: /skills/pdf123-repair.md
파일은 이번 처리에만 쓰이며, 끝나면 자동으로 삭제됩니다.