使用 IronPDF 引擎内模式

本地与引擎的区别

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

开始使用 IronPDF

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

第一步：

免费开始

---

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

使用Engine配置时，我们建议安装IronPdf包，因为Engine会管理Native包中包含的所有额外内容。

Install-Package IronPdf.Slim

安装IronPdf.Slim后，通过将IronPDF指向您的IronPdfEngine实例来配置连接设置。 在应用程序的启动时 （或在调用任何 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

IronPDFEngine 如何工作？

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

有关将 IronPDF 作为自己容器运行的快速入门教程，请参考此教程。 该 Docker 容器支持 16 个运行时配置参数，涵盖端口、日志记录、Chrome 限制等内容——请参阅完整的参数参考文档。

IronPDFEngine 的其他说明

IronPDF .NET 不需要 IronPdfEngine来运行。 IronPdfEngine只是使用IronPDF的一种可选方式。 默认情况下，IronPDF for .NET不会使用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")
)

IronPDFEngine 的限制

• 目前，IronPdfEngine 本身不支持水平扩展（跨多个引擎实例的负载均衡），因为该引擎将正在处理的 PDF 二进制文件保存在服务器内存中，并使用 PdfDocumentId 在服务器和客户端之间进行协调。 此设计可最大限度地减少带宽使用并提高处理速度。 请注意，此限制仅适用于 IronPdfEngine 服务；使用 IronPDF 库（无论是否配合 IronPdfEngine）的应用程序仍可通过部署多个应用程序实例实现水平扩展。
• 要远程运行 IronPDFEngine Docker，您需要确保 IronPDFEngine 端口是可访问的。
• 在使用基于ubuntu:22.04官方镜像的Linux x64（Debian）上运行的IronPdfEngine Docker可能会由于不同的操作系统行为产生与在本地运行IronPDF时略有不同的PDF输出。
• 由于IronPdfEngine Docker基于Linux，它需要Linux Containers daemon（如果您使用的是Windows，请选择Switch to Linux Containers）。
• IronPDFEngine 二进制文件不是跨平台的，因此我们专门为每个平台构建它们。
• 不支持跨版本。