使用 IronPDF 进行引擎模式
原生与引擎的区别
IronPDF具有一些性能密集型功能,您可以选择远程运行。 虽然IronPDF不需要IronPdfEngine来运行,但将IronPdfEngine设置为远程服务是一种可选的方法,可避免在较旧的操作系统和移动环境中遇到特定平台的Chrome兼容性问题。
开始使用IronPDF
立即在您的项目中开始使用IronPDF,并享受免费试用。
使用 Engine 如何改变您与 IronPDF 编码的方式
在使用引擎配置时,我们建议安装IronPdf.Slim
而不是从NuGet中安装完整的IronPdf
包,因为引擎会管理本机包中包含的所有额外内容。
PM> Install-Package IronPdf.Slim
安装IronPdf.Slim
后,通过将IronPDF指向您的IronPdfEngine实例来配置连接设置。 在您的应用程序启动时添加以下代码(或在调用任何IronPDF方法之前):
在您的C#代码中添加额外的配置代码行
假设IronPdfEngine在123.456.7.8:33350
远程运行:
// ... your code ...
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// ... your code ...
// ... your code ...
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
// ... your code ...
' ... your code ...
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
' ... your code ...
IronPdfEngine 是如何运作的?
IronPdfEngine 是一个容器化服务器,旨在管理各种 IronPDF 操作,包括使用 gRPC 协议创建、编写、编辑和读取 PDF。 作为一个独立的C# .NET应用程序,IronPdfEngine可以独立操作,执行时无需.NET运行时环境。 我们为您处理 gRPC 连接,让您可以专注于编码!
如何将 IronPdfEngine 用作远程服务器
- 安装 C# 库以使用 IronPdfEngine
- 从 NuGet 安装 IronPdf.slim 软件包
- 利用 IronPdfConnectionConfiguration 类配置连接设置
- 使用 IronPdfEngine 将 HTML 渲染为 PDF,其渲染器与 Chrome 浏览器相同
IronPdfEngine的其他说明
IronPdf .NET 不需要 IronPdfEngine 即可运行。 IronPdfEngine 只是使用 IronPdf 的一个可选方式。 默认情况下,IronPdf for .NET 不会使用 IronPdfEngine。
请注意
IronPdf .NET 与 Remote IronPdfEngine
IronPdf.slim nuget 包是使用带有远程 IronPdfEngine 的 IronPdf for .NET 所需的唯一软件包。
[{i:(如果您正在使用IronPdf
或IronPdf.Linux
,可以使用IronPdf.slim
来缩小您的应用程序体积。
假设IronPdfEngine在远程运行,地址为123.456.7.8:33350
。
使用 NuGet 安装 IronPdf:
PM> Install-Package IronPdf
安装IronPdf.slim
后,您只需告诉IronPdf IronPdfEngine的位置(请确保该地址可访问,不被防火墙阻挡)。 使用 IronPdfConnectionConfiguration 类来配置连接设置。 在您的应用程序的初始阶段(或调用任何IronPdf方法之前)添加以下代码。
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
就这么简单! 之后,您的应用程序将连接到远程IronPdfEngine!
IronPdfEngine 限制
- 目前,IronPdfEngine 还不支持水平扩展。 (通过多实例进行负载均衡。)因为我们将正在处理的 PDF 文件二进制存储在服务器内存中,并使用 PdfDocumentId 在服务器和客户端之间进行通信。 这也减少了带宽使用并提高了处理速度。
- 要远程运行IronPdfEngine Docker,您需要确保IronPdfEngine端口是可访问的。
- 在 Linux x64(Debian)上运行的 IronPdfEngine Docker 使用基于官方 ubuntu:22.04 的镜像,由于不同操作系统的行为,PDF 输出可能与在本地机器上运行 IronPdf 略有不同。
- 由于IronPdfEngine Docker基于Linux,因此需要Linux容器守护程序。 (如果您使用的是Windows,请选择
Switch to Linux Containers
) - IronPdfEngine 的二进制文件不是跨平台的,所以我们针对每个平台特别构建。
- 跨版本不受支持。