Use o IronPDF com o Modo integrado ao mecanismo.

Diferença entre Native e Engine

O IronPDF possui algumas funções que exigem alto desempenho e que você pode optar por executar remotamente. Embora o IronPDF não exija o IronPDFEngine para funcionar, configurar o IronPDFEngine como um serviço remoto é uma maneira opcional de evitar problemas de compatibilidade com o Chrome em sistemas operacionais mais antigos e ambientes móveis.

Comece a usar o IronPDF

Comece a usar IronPDF no seu projeto hoje mesmo com um teste gratuito.

Primeiro passo:

Comece gratuitamente

---

Como o uso do Engine muda a forma como você programa com o IronPDF

Ao usar a configuração Engine, recomendamos instalar IronPdf.Slim em vez do pacote completo IronPdf do NuGet, pois o Engine gerencia todo o volume extra incluído no pacote Native.

Install-Package IronPdf.Slim

Após instalar IronPdf.Slim, configure as definições de conexão apontando o IronPDF para a sua instância de IronPdfEngine. Adicione o seguinte código na inicialização da sua aplicação (ou antes de chamar qualquer método do IronPDF) :

:path=/static-assets/pdf/content-code-examples/get-started/ironpdfengine-2.cs

// 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

Como funciona o IronPDFEngine?

O IronPDFEngine é um servidor conteinerizado projetado para gerenciar várias operações do IronPDF, incluindo a criação, gravação, edição e leitura de PDFs, tudo usando o protocolo gRPC. Construído como um aplicativo C# .NET independente, o IronPDFEngine opera de forma autônoma, eliminando a necessidade do ambiente de execução .NET durante a execução. Nós cuidamos da conexão gRPC para você, para que você possa se concentrar na programação!

Para um tutorial rápido sobre como executar o IronPDF como um contêiner independente, consulte este tutorial . O contêiner Docker suporta 16 parâmetros de configuração de tempo de execução para porta, registro de logs, limites do Chrome e muito mais — consulte a referência completa de parâmetros .

Outros esclarecimentos para o IronPDFEngine

IronPDF .NET não requer IronPdfEngine para executar. IronPdfEngine é apenas uma maneira opcional de usar o IronPDF. Por padrão, o IronPDF for .NET não usará IronPdfEngine.

Install-Package IronPdf.Slim

:path=/static-assets/pdf/content-code-examples/get-started/ironpdfengine-4.cs

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

Imports IronPdf

' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)

Limitações do IronPDFEngine

• Atualmente, o IronPdfEngine em si não suporta escalonamento horizontal (balanceamento de carga entre várias instâncias do mecanismo) porque o mecanismo mantém os binários PDF em andamento na memória do servidor e usa o PdfDocumentId para coordenar a comunicação entre o servidor e o cliente. Este projeto minimiza o uso de largura de banda e aumenta a velocidade de processamento. Note que essa limitação se aplica apenas ao serviço IronPdfEngine; aplicativos que usam a biblioteca IronPDF (com ou sem IronPdfEngine) ainda podem ser escalados horizontalmente implantando várias instâncias do aplicativo. Para executar o IronPDFEngine em Docker remotamente, você precisa garantir que a porta do IronPDFEngine esteja acessível.
• A execução do IronPdfEngine Docker no Linux x64 (Debian) usando imagens baseadas no ubuntu:22.04 oficial pode produzir uma saída PDF ligeiramente diferente do que você obteria executando o IronPDF localmente devido ao comportamento diferente do sistema operacional.
• Como o IronPdfEngine Docker é baseado em Linux, ele requer o daemon de Contêineres Linux (selecione Switch to Linux Containers se você estiver usando Windows).
• Os binários do IronPDFEngine não são multiplataforma, por isso os compilamos especificamente para cada plataforma.
• Não há suporte disponível entre versões diferentes.