使用IronPDF 的引擎内模式

原生应用与引擎应用的区别

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

开始使用IronPDF

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

第一步：

免费开始

---

使用 Engine 如何改变您使用IronPDF编写代码的方式

使用引擎配置时，我们建议从NuGet安装 IronPdf.Slim 而不是完整的 IronPdf 包，因为引擎管理了 Native 包中包含的所有额外内容。

Install-Package IronPdf.Slim

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

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.Co/nnectToIronPdfHost(
    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.Co/nnectToIronPdfHost(
    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操作，包括创建、写入、编辑和读取 PDF，所有这些操作都使用 gRPC 协议。 IronPdfEngine 是一个独立的 C# .NET应用程序，可以独立运行，无需在执行期间使用.NET运行时。 我们为您处理 gRPC 连接，让您可以专注于编码！

有关如何将IronPDF作为独立容器运行的快速入门教程，请参阅本教程。 Docker 容器支持 16 个运行时配置参数，用于端口、日志记录、Chrome 限制等——请参阅完整的参数参考。

关于 IronPdfEngine 的其他说明

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

Install-Package IronPdf.Slim

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

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

IronPdfEngine 的局限性

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