엔진 내 모드에서 IronPDF를 사용하십시오.

This article was translated from English: Does it need improvement?
Translated
View the article in English

네이티브와 엔진의 차이점

IronPDF에는 원격으로 실행할 수 있는 고성능 기능이 몇 가지 있습니다. IronPDF는 실행에 IronPdfEngine이 필수적인 것은 아니지만, IronPdfEngine을 원격 서비스로 설정하는 것은 구형 운영 체제 및 모바일 환경에서 플랫폼별 Chrome 호환성 문제를 방지하는 선택적인 방법입니다.

IronPDF 시작하기

지금 바로 무료 체험판을 통해 IronPDF을 프로젝트에서 사용해 보세요.

첫 번째 단계:
green arrow pointer


Engine을 사용하면 IronPDF로 코딩하는 방식이 어떻게 달라지나요?

엔진 구성을 사용할 때는 NuGet에서 전체 IronPdf 패키지 대신 IronPdf.Slim 패키지를 설치하는 것이 좋습니다. 엔진이 네이티브 패키지에 포함된 모든 추가 파일을 관리하기 때문입니다.

Install-Package IronPdf.Slim

IronPdf.Slim을 설치한 후 IronPDF가 IronPdfEngine 인스턴스를 가리키도록 연결 설정을 구성하십시오. 애플리케이션 시작 시 (또는 IronPDF 메서드를 호출하기 전에) 다음 코드를 추가하십시오.

C# 코드에 추가할 구성 코드 한 줄

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

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
$vbLabelText   $csharpLabel

IronPdfEngine은 어떻게 작동하나요?

IronPdfEngine은 gRPC 프로토콜을 사용하여 PDF 생성, 작성, 편집 및 읽기를 포함한 다양한 IronPDF 작업을 관리하도록 설계된 컨테이너화된 서버입니다. IronPdfEngine은 독립적인 C# .NET 애플리케이션으로 개발되었으며, 실행 시 .NET 런타임이 필요하지 않으므로 독립적으로 작동합니다. 저희가 gRPC 연결을 처리해 드리므로 여러분은 코딩에만 집중하실 수 있습니다!

IronPDF를 자체 컨테이너로 실행하는 방법에 대한 빠른 시작 튜토리얼은 이 튜토리얼을 참조하십시오.

IronPdfEngine에 대한 추가 설명

IronPdf .NET은 실행에 IronPdfEngine이 필요하지 않습니다 . IronPdfEngine은 IronPdf를 사용하는 선택적 방법일 뿐입니다. 기본적으로 .NET용 IronPdf는 IronPdfEngine을 사용하지 않습니다.

참고해 주세요각 IronPdf for .NET 버전에는 특정 버전의 IronPdfEngine이 필요합니다. 버전 간 호환성은 지원되지 않습니다. .NET용 IronPdf의 경우, 필요한 IronPdfEngine 버전은 항상 일치합니다. 예를 들어, IronPdf 2024.2.2는 IronPdfEngine 2024.2.2를 사용합니다.

원격 IronPdfEngine을 사용한 IronPdf .NET

IronPdf.slim NuGet 패키지는 원격 IronPdfEngine을 사용하여 .NET용 IronPdf를 사용하는 데 필요한 유일한 패키지입니다.

[{i:(만약 IronPdf 또는 IronPdf.Linux을 사용하고 있다면, 애플리케이션 크기를 줄이기 위해 IronPdf.slim을 대신 사용할 수 있습니다.

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

NuGet을 사용하여 IronPdf를 설치하세요:

Install-Package IronPdf.Slim

IronPdf.slim를 설치한 후에는 IronPdfEngine의 위치를 IronPdf에 알려주기만 하면 됩니다(해당 주소가 방화벽에 의해 차단되지 않고 접근 가능한지 확인하십시오). IronPdfConnectionConfiguration 클래스를 사용하여 연결 설정을 구성하십시오. 아래 코드를 애플리케이션의 초기 단계(또는 IronPdf 메서드를 호출하기 직전)에 추가하십시오.

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
$vbLabelText   $csharpLabel

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


IronPdfEngine 제한 사항

  • 현재 IronPdfEngine은 서버 메모리에 PDF 파일 바이너리를 저장하고 서버와 클라이언트 간 통신에 PdfDocumentId를 사용하기 때문에 수평 확장(여러 인스턴스를 사용한 로드 밸런싱)을 지원하지 않습니다. 이렇게 하면 대역폭 사용량이 최소화되고 처리 속도가 향상됩니다. IronPdfEngine Docker를 원격으로 실행하려면 IronPdfEngine 포트에 접근이 가능한지 확인해야 합니다.
  • 공식 ubuntu:22.04 기반 이미지를 사용하여 Linux x64(Debian)에서 실행되는 IronPdfEngine Docker는 운영 체제의 동작 방식 차이로 인해 로컬에서 IronPdf를 실행할 때와 약간 다른 PDF 출력을 생성할 수 있습니다.
  • IronPdfEngine Docker는 Linux 기반이므로 Linux 컨테이너 데몬이 필요합니다(Windows를 사용하는 경우 Switch to Linux Containers를 선택하세요).
  • IronPdfEngine 바이너리는 크로스 플랫폼을 지원하지 않으므로 각 플랫폼에 맞게 별도로 빌드합니다.
  • 버전 간 호환성은 지원되지 않습니다.

자주 묻는 질문

IronPdfEngine을 사용하여 원격으로 PDF를 생성하려면 어떻게 설정해야 하나요?

원격 PDF 생성을 위해 IronPdfEngine을 설정하려면 NuGet에서 `IronPdf.Slim` 패키지를 설치하고 `IronPdfConnectionConfiguration` 클래스를 사용하여 연결 설정을 구성하십시오. 이 설정을 통해 애플리케이션을 IronPdfEngine 인스턴스에 원격으로 연결할 수 있습니다.

IronPdfEngine을 애플리케이션과 함께 사용할 때의 주요 이점은 무엇입니까?

IronPdfEngine을 애플리케이션과 함께 사용하면 PDF 작업을 원격으로 실행할 수 있으므로 특히 구형 시스템 및 모바일 플랫폼에서 플랫폼별 호환성 문제를 방지하는 데 도움이 됩니다. 또한 실행 중에 .NET 런타임이 필요하지 않습니다.

PDF 기본 라이브러리 대신 IronPdfEngine을 사용하는 것을 선택할 수 있는 이유는 무엇일까요?

IronPdfEngine을 선택하면 성능 집약적인 PDF 기능을 원격으로 실행할 수 있으며, 이를 통해 다양한 운영 체제와의 호환성 문제를 줄이고 Chrome과 동일한 HTML-PDF 변환 렌더러를 활용하여 성능을 향상시킬 수 있습니다.

IronPdfEngine에서 수평 확대/축소가 지원되나요?

아니요, IronPdfEngine은 현재 수평 확장을 지원하지 않습니다. 즉, 서버 메모리에서 PDF 파일 바이너리가 처리되는 방식 때문에 여러 인스턴스에 걸쳐 로드 밸런싱이 불가능합니다.

IronPdfEngine은 다양한 운영 체제에서 실행될 수 있습니까?

IronPdfEngine은 Docker 컨테이너를 사용하여 Linux 시스템에서 실행되도록 설계되었습니다. 하지만 바이너리 파일은 플랫폼별로 다르므로 사용 중인 운영 체제에 맞는 버전을 사용해야 합니다.

IronPdfEngine을 사용할 때 PDF 출력 결과가 다르게 나오면 어떻게 해야 하나요?

운영 체제의 동작 방식에 따라 PDF 출력 결과가 약간씩 다를 수 있습니다. 차이를 최소화하려면 올바른 Docker 이미지를 사용하고 렌더링에 영향을 줄 수 있는 운영 체제별 설정을 확인하십시오.

내 애플리케이션이 올바른 버전의 IronPdfEngine을 사용하고 있는지 어떻게 확인할 수 있습니까?

호환성을 보장하기 위해 IronPDF의 각 버전에는 해당 버전의 IronPdfEngine이 필요합니다. 버전 간 문제를 방지하려면 두 구성 요소를 동시에 업데이트하십시오.

Windows에서 IronPdfEngine을 사용할 때의 제한 사항은 무엇입니까?

Windows에서 IronPdfEngine을 사용하려면 Docker용 Linux 컨테이너가 필요하며 서버 포트에 접근 가능한지 확인해야 합니다. 바이너리는 플랫폼별로 다르므로 Linux 컨테이너로 전환해야 합니다.

IronPDF가 원격 IronPDFEngine 서버에 연결되도록 구성하려면 어떻게 해야 합니까?

원격 서버에 대한 IronPDF를 구성하려면 `Installation.ConnectToIronPdfHost` `IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer` 메서드와 함께 사용하고 서버의 IP 주소와 포트 정보를 지정하십시오.

IronPdfEngine을 사용할 때 애플리케이션 크기를 최소화하려면 어떤 패키지를 사용해야 할까요?

IronPdfEngine을 사용하여 IronPDF를 실행하는 데 필요한 구성 요소만 포함되어 있으므로 애플리케이션 크기를 줄이려면 NuGet에서 `IronPdf.Slim` 패키지를 사용하는 것이 좋습니다.

커티스 차우
기술 문서 작성자

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

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

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다