IronPDF for Node.js의 IronPdfEngine 이해

Curtis Chau

업데이트됨:6월 28, 2026

Translated

View the article in English

IronPDF for Node.js는 IronPdfEngine을 통해 렌더링을 수행합니다. 엔진이 시작되는 방식과 스케일이 되는 방식을 아는 것은 한 기기에서 여러 인스턴스를 실행할 때 부딪히는 한계를 설명합니다.

기본 동작

기본적으로 IronPDF for Node.js는 33350 포트에서 gRPC를 통해 IronPdfEngine과 통신하는 하위 프로세스를 생성합니다. 엔진은 로컬에서 실행되며 해당 포트에 연결됩니다.

포트가 기본적으로 고정되어 있기 때문에, 같은 기기에서 IronPDF를 사용하는 두 애플리케이션을 실행하는 것은 포트를 변경하지 않고는 허용되지 않습니다. 여러 개를 나란히 실행해야 할 때 각 애플리케이션 인스턴스에 고유한 엔진 포트를 부여하세요.

확장

IronPdfEngine 자체는 수평으로 확장할 수 없습니다: 로드된 PDF 데이터는 메모리에 존재하며 엔진 인스턴스 간에 공유될 수 없습니다. 대신 인스턴스에 더 많은 리소스를 할당하여 엔진을 수직으로 확장하세요.

애플리케이션은 여전히 수평으로 확장이 가능합니다. IronPdfEngine을 Docker에서 가져와 여러 애플리케이션 인스턴스에 연결하거나, 앱을 Docker라이즈하여 각 수평으로 확장된 인스턴스를 기본 동작 아래 자체 격리된 컨테이너에서 실행하세요.

요약

IronPDF for Node.js는 33350 포트에서 gRPC를 통해 IronPdfEngine과 통신하는 하위 프로세스를 생성합니다.
하나의 기기에서 여러 앱 인스턴스를 실행하려면 각 인스턴스에 다른 엔진 포트가 필요합니다.
기본값 대신 Docker에서 IronPdfEngine을 가져와 여러 애플리케이션 인스턴스에 연결할 수 있습니다.
IronPdfEngine은 수평으로 확장할 수 없습니다; 대신 수직으로 확장하거나, 애플리케이션을 수평으로 확장하여 각 인스턴스를 자체 격리된 컨테이너에서 실행하게 합니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

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

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

시작할 준비 되셨나요?

버전: 2026.6 방금 출시

라이선스 보기