1. IronPDF
  2. 시작하기
  3. IronPdfEngine을 사용하세요

IronPdfEngine 사용 방법

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine은 PDF 문서의 생성, 편집 및 읽기를 포함한 다양한 IronPDF 작업을 관리하도록 설계된 gRPC 서버입니다.

## Node.js에서 IronPdfEngine을 사용하는 방법
  1. IronPdfEngine을 사용하려면 Node.js 라이브러리를 설치하세요.
  2. npm을 사용하여 라이브러리를 설치함으로써 포함시키세요.
  3. Chrome 실행 파일은 설치 과정과 동일한 방법으로 다운로드할 수 있습니다.
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. IronPdfEngine을 사용하면 Chrome 렌더러와 동일한 방식으로 HTML을 PDF로 렌더링할 수 있습니다.

IronPdf Node.js 및 IronPdfEngine

Node.js용 IronPdf를 실행하려면 IronPdfEngine이 필요합니다 . Node.js 코드는 IronPdfEngine gRPC 위에 씌워진 API 마스크일 뿐입니다. 따라서 Node.js용 IronPdf에서 어떤 메서드를 호출하든 모든 마법은 IronPdfEngine 내부에서 일어납니다!

기본적으로 Node.js용 IronPdf는 IronPdfEngine을 하위 프로세스로 생성하고 애플리케이션이 종료될 때까지 해당 프로세스와 통신합니다.

참고: Node.js용 IronPdf의 각 버전은 특정 버전의 IronPdfEngine을 필요로 합니다. 버전 간 호환은 지원되지 않습니다.

Node.js용 IronPdf(로컬 IronPdfEngine 포함)

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

기본적으로 IronPdf를 JavaScript 프로젝트에 설치한 후 처음 실행할 때 IronPdf는 사용자의 플랫폼(예: Windows x64)을 감지하고 인터넷에서 올바른 IronPdfEngine 바이너리를 다운로드합니다.

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

장점:

  • 제출하실 지원 서류는 간소할 것입니다.
  • 다양한 플랫폼에 배포할 수 있습니다.

단점:

  • 처음 몇 번 실행 시에는 인터넷 연결이 필요합니다.
  • 부팅 속도가 느립니다.

옵션 2(권장): IronPdfEngine을 종속성으로 설치합니다.

Node.js용 IronPdf를 사용하면 IronPdfEngine을 종속성으로 추가할 수 있습니다. 이러한 IronPdfEngine 종속성은 IronPdfEngine을 .zip 파일로 묶고 자동으로 압축을 해제하여 사용합니다.

IronPdfEngine 종속성 중 하나 또는 여러 개를 설치하도록 선택할 수 있습니다.

참고: ironpdf 및 ironpdf-engine-xxx-xxx 종속성 버전은 동일해야 합니다. ironpdf-engine-xxx-xxx 종속성 버전은 내부의 IronPdfEngine 버전을 참조하지 않습니다.

플랫폼별 설치:

  • 윈도우 x64:

    npm install @ironsoftware/ironpdf-engine-windows-x64
    npm install @ironsoftware/ironpdf-engine-windows-x64
    SHELL

  • 윈도우 x86:

    npm install @ironsoftware/ironpdf-engine-windows-x86
    npm install @ironsoftware/ironpdf-engine-windows-x86
    SHELL

  • 리눅스 x64:

    npm install @ironsoftware/ironpdf-engine-linux-x64
    npm install @ironsoftware/ironpdf-engine-linux-x64
    SHELL

  • macOS x64:

    npm install @ironsoftware/ironpdf-engine-macos-x64
    npm install @ironsoftware/ironpdf-engine-macos-x64
    SHELL
  • macOS arm:
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    SHELL

장점:

  • 부팅 시간이 더 빨라졌습니다.
  • 필수 구성 요소가 설치되면 인터넷 연결이 필요하지 않습니다.

단점:

  • 제출하시는 지원서 파일의 용량이 클 것입니다.
  • 대상 플랫폼을 명시해야 합니다.

Node.js용 IronPdf와 원격 IronPdfEngine을 함께 사용해 보세요.

원격 IronPdfEngine을 사용하려면 특정 버전의 IronPdfEngine이 필요합니다. 예를 들어, Node.js용 IronPdf 버전 2024.2.2에 IronPdfEngine 버전 2024.2.2가 필요한 경우 IronPdfEngine 버전 2024.2.1을 사용하지 마십시오. 필요한 버전을 확인하려면 ironPdfEngineVersion 속성을 참조하십시오.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

연결 방법

IronPdfEngine이 123.456.7.8:33350에서 원격으로 실행된다고 가정합니다.

" IronPdfEngine을 다운로드하고 실행하는 방법 "을 참조하십시오.

연결하려면 IronPdfEngine의 위치를 지정하기만 하면 됩니다(주소가 방화벽에 의해 차단되지 않고 접근 가능한지 확인하십시오). 이 코드를 애플리케이션 초기 단계, 즉 IronPdf 메서드를 호출하기 직전에 추가하십시오.

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});
JAVASCRIPT

정말 간단하죠! 이후, 여러분의 애플리케이션은 원격 IronPdfEngine에 연결될 것입니다!

원격 IronPdfEngine을 사용하는 경우 IronPdfEngine을 종속성으로 설치할 필요가 없습니다. " 옵션 2(권장): IronPdfEngine을 종속성으로 설치 "라는 제목의 섹션은 건너뛰셔도 됩니다.

자주 묻는 질문

Node.js에서 IronPdfEngine은 무엇에 사용되나요?

IronPdfEngine은 Node.js에서 사용되는 gRPC 서버로, PDF 생성, 편집 및 렌더링과 같은 작업을 관리하여 원활한 PDF 처리 환경을 제공합니다.

Node.js용 IronPDF를 어떻게 설치할 수 있나요?

`npm install @ironsoftware/ironpdf` 명령어를 사용하여 Node.js용 IronPDF를 설치할 수 있습니다.

IronPdfEngine의 로컬 설정과 원격 설정의 차이점은 무엇입니까?

로컬 설치는 런타임에 IronPdfEngine을 다운로드하거나 종속성으로 설치하는 방식으로, 시작 속도가 더 빠릅니다. 원격 설치는 원격으로 호스팅된 IronPdfEngine에 연결하므로 로컬 설치가 필요하지 않습니다.

IronPdf와 IronPdfEngine 버전 간의 호환성을 어떻게 보장할 수 있습니까?

Node.js용 IronPdf의 각 버전은 특정 버전의 IronPdfEngine을 필요로 합니다. `ironPdfEngineVersion` 속성을 사용하여 필요한 버전을 확인하고 두 버전이 일치하는지 확인하십시오.

IronPdfEngine을 종속성으로 설치하면 어떤 이점이 있습니까?

IronPdfEngine을 종속성으로 설치하면 시작 속도가 빨라지고 설치 후 인터넷 연결이 필요 없어지지만, 애플리케이션 패키지 크기가 증가합니다.

원격 IronPdfEngine에 어떻게 연결하나요?

원격 IronPdfEngine에 연결하려면 `IronPdfGlobalConfig.setConfig` 사용하여 서버 주소를 지정하고, 해당 주소가 방화벽에 의해 차단되지 않고 접근 가능한지 확인하십시오.

IronPdfEngine의 런타임 다운로드에 인터넷 연결이 필요한가요?

네, 처음 몇 번 실행할 때는 런타임에 IronPdfEngine을 다운로드하기 위해 인터넷 연결이 필요하며, 이로 인해 시작 시간이 다소 느려집니다.

원격 사용을 위해 IronPdfEngine을 설치해야 하나요?

아니요, 원격 IronPdfEngine을 사용하는 경우 로컬에 종속성으로 설치할 필요가 없습니다.

IronPdfEngine은 다양한 플랫폼에서 사용할 수 있나요?

네, IronPdfEngine은 여러 플랫폼에 배포할 수 있습니다. Windows, Linux 및 macOS에 설치하기 위한 플랫폼별 npm 명령어가 제공됩니다.

IronPDF는 .NET 10과 호환되나요? 그리고 어떤 개발 환경을 지원하나요?

네, IronPDF는 .NET 10과 완벽하게 호환됩니다(NET 9, 8, 7 등도 지원). C#, VB.NET, F#을 지원하며 Windows, Linux, macOS는 물론 Docker 및 클라우드 환경까지 다양한 플랫폼에서 작동하므로 .NET 10 기반 웹, 데스크톱, 콘솔 또는 클라우드 프로젝트에 적합합니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
버전: 2026.2 방금 출시되었습니다