Node.js 사용하여 PDF 파일을 압축하는 방법

어떤 품질 설정을 사용해야 하나요?

PDF의 압축 후 사용 방식에 따라 적절한 품질 값이 달라집니다:

90-100: 거의 손실이 없음. 문서를 전체 배율로 인쇄하거나 볼 때 사용합니다.

• 80-89: 높은 품질, 눈에 띄게 작은 파일. 대부분의 비즈니스 문서의 기본 시작점. 60-79: 중간 품질. 화면 표시, 웹 전달 및 이메일 첨부에 적합합니다.
• 60 미만: 낮은 품질. 미리보기 썸네일, 보관용 사본 혹은 파일 크기가 중요한 상황에 적합합니다.

Node.js에서 압축 결과를 측정하는 방법은?

Node.js fs 모듈을 사용하면 압축으로 인해 예상한 만큼의 용량 감소가 이루어졌는지 확인하는 것이 간단합니다. compressSize를 호출하기 전과 후의 파일 크기를 확인한 다음, 비율을 계산하여 결과가 애플리케이션의 요구 사항을 충족하는지 확인하십시오.

```JavaScript {.line-numbers} //:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/measure-compression.js import { PdfDocument } from "@ironsoftware/IronPDF"; import { statSync } from "fs";

const inputPath = "annual-report.PDF"; const outputPath = "annual-report-compressed.PDF";

const beforeBytes = statSync(inputPath).size;

const pdf = await PdfDocument.fromFile(inputPath); await pdf.compressSize(75); await pdf.saveAs(outputPath);

const afterBytes = statSync(outputPath).size; const reduction = (((beforeBytes - afterBytes) / beforeBytes) * 100).toFixed(1);

console.log(Before: ${(beforeBytes / 1024).toFixed(1)} KB); console.log(After: ${(afterBytes / 1024).toFixed(1)} KB); console.log(Reduced by ${reduction}%);

[Node.js `fs.statSync` API는](https://nodejs.org/api/fs.html#fsstatsynspath-options) `Stats` 속성을 바이트 단위로 포함하는 `size` 객체를 반환합니다. 프로덕션 파이프라인에서는 이 비율을 문서별로 기록하여 압축이 예상대로 크기를 줄이지 못한 예외적인 경우를 식별할 수 있습니다. 이는 일반적으로 이미 원본에서 압축된 스캔 문서가 해당됩니다.

중요한서버 환경에서 파일을 처리하기 전에 `IRONPDF_ENGINE_PATH` 환경 변수를 설정하거나 `IronPdfGlobalConfig`를 구성하십시오. [IronPDF Node.js 문서](https://ironpdf.com/nodejs/docs/)에서 엔진 설정 세부 정보를 참조하십시오.

## 여러 PDF 파일을 일괄적으로 압축하려면 어떻게 해야 하나요?

프로덕션 애플리케이션은 드물게 단일 문서를 개별적으로 압축합니다. 아래 예제는 `Promise.all`을 사용하여 파일 경로 배열을 동시에 처리합니다. 이를 통해 Node.js 이벤트 루프는 차단 없이 여러 `compressSize` 작업을 처리할 수 있습니다:

```JavaScript {.line-numbers}
//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/batch-compress.js
import { PdfDocument } from "@ironsoftware/IronPDF";
import path from "path";

async function compressPdfFiles(inputPaths, quality = 80) {
const results = await Promise.all(
inputPaths.map(async (inputPath) => {
const pdf = await PdfDocument.fromFile(inputPath);
await pdf.compressSize(quality);

const outputPath = inputPath.replace(".pdf", "-compressed.pdf");
await pdf.saveAs(outputPath);

return { input: inputPath, output: outputPath };
})
);

return results;
}

// 사용
const files = ["report-q1.PDF", "report-q2.PDF", "report-q3.PDF"];
const compressed = await compressPdfFiles(files, 75);
compressed.forEach(r => console.log(`Saved: ${r.output}`));

PdfDocument.fromFile 및 compressSize에 대한 각 호출은 독립적이므로 병렬 처리가 안전합니다. 매우 큰 배치(수백 개의 파일)의 경우, Node.js 메모리 제한을 초과하지 않도록 배열을 청크로 나누는 것을 고려하십시오. 이벤트 루프에 대한 Node.js 문서는 Promise.all가 메인 스레드를 차단하지 않고 병렬 I/O를 스케줄링하는 방법을 설명합니다.

압축을 다른 PDF 작업과 결합하려면 어떻게 하나요?

압축은 더 큰 문서 처리 체인에 자연스럽게 들어맞습니다. 일반적인 패턴은 HTML에서 PDF를 생성하고, 워터마크 또는 서명을 추가한 다음, 전달 전에 압축하는 것입니다:

```JavaScript {.line-numbers} //:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/compress-after-render.js import { PdfDocument, ChromePdfRenderer } from "@ironsoftware/IronPDF";

// HTML을 PDF로 렌더링 const renderer = new ChromePdfRenderer(); const pdf = await renderer.renderHtmlAsPdf("

Amount due: $540.00

// 저장하기 전에 압축 -- Chrome에서 렌더링된 콘텐츠의 이미지 무게를 줄입니다 await pdf.compressSize(85);

// 최종 문서를 저장 await pdf.saveAs("invoice-1042.pdf");

`ChromePdfRenderer`에는 종종 배경 이미지와 CSS로 참조되는 자산이 전체 해상도로 삽입됩니다. 렌더링 후 `compressSize`를 호출하면 HTML 소스 기반 PDF의 파일 크기를 일관되게 줄일 수 있습니다. IronPDF [HTML to PDF 튜토리얼](https://ironpdf.com/nodejs/tutorials/html-to-pdf/)에서는 렌더러 설정에 대해 자세히 다룹니다.

전자 서명이 필요한 문서의 경우, [전자 서명](https://ironpdf.com/nodejs/examples/digitally-sign-a-pdf/)을 압축 후에 적용하세요. 서명은 문서의 바이트 스트림을 잠그며, 이후 수정은 서명을 무효화합니다.

여러 페이지로 구성된 문서를 다룰 때는 압축하기 전에 `PdfDocument.merge()`로 병합하십시오. 병합된 결과를 압축하는 것이 개별 파일을 압축하고 다시 병합하는 것보다 더 효율적입니다.

팁멀티 페이지 문서를 병합한 후 압축하세요. 병합된 결과를 압축하는 것이 개별 파일을 압축하고 다시 병합하는 것보다 더 효율적입니다.

## Node.js에서 PDF 압축의 다음 단계는 무엇입니까?

`compressSize` 메서드는 가장 일반적인 압축 사용 사례인 내장 이미지 용량 줄이기를 다룹니다. 특수한 시나리오에 대해서는 IronPDF [PDF 압축 예제](https://ironpdf.com/nodejs/examples/pdf-compression/)가 추가적인 코드 샘플을 제공하며, [API 레퍼런스](https://ironpdf.com/nodejs/object-reference/api/)는 사용 가능한 모든 메서드 서명을 문서화하고 있습니다.

IronPDF는 또한 [이미지를 PDF로](https://ironpdf.com/nodejs/examples/image-to-pdf/) 변환하고, [PDF 텍스트를 읽으며](https://ironpdf.com/nodejs/examples/reading-pdf-text/), [PDF에서 페이지를 제거하는](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/) 기능을 지원하며, 이러한 모든 작업은 동일한 `PdfDocument` API와 통합됩니다. Node.js PDF 기능에 대한 전체 개요는 [IronPDF Node.js 문서](https://ironpdf.com/nodejs/docs/)를 참조하세요.

프로젝트에서 압축을 테스트할 준비가 되었습니까? [무료 체험판 시작하기](#trial-license)를 통해 위의 예제를 워터마크 없이 실행하거나, [라이선스 옵션 보기](#licensing)를 통해 프로덕션 배포에 대해 알아보세요.

`PdfDocument`