Use IronPDF with in-Engine Mode

本地与引擎的区别

IronPDF 有一些性能密集的功能，您可以选择远程运行。 虽然 IronPDF 不需要 IronPdfEngine 运行，但将 IronPdfEngine 设置为远程服务是避免在旧操作系统和移动环境中出现平台特定 Chrome 兼容性问题的可选方法。

开始使用 IronPDF

今天在您的项目中使用 IronPDF，免费试用。

第一步：

免费开始

---

使用引擎如何改变您与 IronPDF 编码的方式

在使用引擎配置时，我们建议从 NuGet 安装 IronPdf.Slim 而不是完整的 IronPdf 包，因为引擎管理本地包中包含的全部额外负载。

Install-Package IronPdf.Slim

安装 IronPdf.Slim 后，通过指向您的 IronPdfEngine 实例来配置连接设置。 在应用程序的启动时 （或在调用任何 IronPDF 方法之前） 添加以下代码：

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

' 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

IronPdfEngine 如何工作？

IronPdfEngine 是一个容器化的服务器，旨在管理各种 IronPDF 操作，包括使用 gRPC 协议创建、写入、编辑和读取 PDF。 作为一个自包含的 C# .NET 应用程序构建，IronPdfEngine 独立运行，消除了在执行过程中对 .NET 运行时的需求。 我们为您处理 gRPC 连接，这样您就可以专注于编码！

有关将 IronPDF 作为自己容器运行的快速入门教程，请参考此教程。

IronPdfEngine 的其他说明

IronPdf .NET 不需要 IronPdfEngine 运行。 IronPdfEngine 只是使用 IronPdf 的一种可选方式。 默认情况下，IronPdf for .NET 将不使用 IronPdfEngine。

Install-Package IronPdf.Slim

// 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")
);

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

IronPdfEngine 的限制

• 目前，IronPdfEngine 尚不支持水平扩展（使用多个实例的负载平衡），因为我们将处理 PDF 文件的二进制文件存储在服务器内存中，并使用 PdfDocumentId 在服务器和客户端之间通信。 这也最大限度地减少了带宽使用并提高了处理速度。
• 要远程运行 IronPdfEngine Docker，您需要确保 IronPdfEngine 端口是可访问的。
• 使用基于官方 ubuntu:22.04 镜像在 Linux x64（Debian）上运行的 IronPdfEngine Docker 可能生成的 PDF 输出与在本地运行 IronPdf 时略有不同，这是由于操作系统行为不同。
• 由于 IronPdfEngine Docker 是基于 Linux 的，它需要 Linux 容器守护程序（如果您使用的是 Windows，请选择切换到 Linux 容器）。
• IronPdfEngine 二进制文件不是跨平台的，因此我们专门为每个平台构建它们。
• 不支持跨版本。