Node.js와 IronPdfEngine 사용 방법

옵션 1: 런타임 시 IronPdfEngine 다운로드

@ironsoftware/ironpdf를 설치한 후에는 추가 패키지가 필요하지 않습니다. 첫 실행 시, IronPDF는 호스트 플랫폼(예: Windows x64)을 감지하고 인터넷에서 일치하는 IronPdfEngine 바이너리를 다운로드합니다.

//:path=shell
npm install @ironsoftware/ironpdf

//:path=shell
npm install @ironsoftware/ironpdf

장점:

• 애플리케이션 패키지를 작게 유지합니다.
• 플랫폼별 구성이 없이 여러 플랫폼에 배포합니다.

단점:

• 첫 몇 번의 실행에 인터넷 접속이 필요합니다.
• 바이너리를 가져오는 초기 실행 이면 느린 시작 시간입니다.

옵션 2 (추천): IronPdfEngine을 의존성으로 설치하세요

IronPDF for Node.js는 특정 플랫폼을 위한 IronPdfEngine 바이너리를 번들로 제공하는 전용 엔진 패키지를 지원합니다. 런타임 다운로드를 제거하려면 메인 라이브러리와 함께 이러한 패키지 중 하나 이상을 설치하십시오.

Windows x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64

Windows x86:

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86

Linux x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64

macOS x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64

macOS arm64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64

장점:

• 더 빠른 시작 속도 — 런타임에 다운로드 필요 없음. 종속성이 설치된 후에는 인터넷 액세스가 필요하지 않습니다.

단점:

• 더 큰 애플리케이션 패키지 크기.
• 빌드 시 대상 플랫폼을 지정해야 합니다.

필요한 엔진 버전을 어떻게 확인합니까?

엔진 버전은 Node.js 패키지 버전과 일치해야 합니다. ironPdfEngineVersion 속성을 읽어 어떤 버전을 가져올지 확인하십시오:

//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

Docker 이미지 태그를 지정할 때 인쇄된 버전 번호를 사용하세요. 버전이 맞지 않으면 gRPC 통신 오류가 발생합니다.

원격 연결을 어떻게 구성합니까?

IronPdfEngine이 123.456.7.8:33350에서 실행 중이라고 가정합니다. 애플리케이션의 시작 부분에 구성 호출을 배치하십시오 — 어떤 IronPDF 메소드 호출보다도 앞서서.

//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

해당 주소는 Node.js 호스트에서 접근 가능해야 합니다. 애플리케이션 서버와 엔진 호스트 간에 33350 포트를 차단하는 방화벽 규칙이 없는지 확인하십시오.