1. IronPDF
2. 操作指南
3. 使用IronPdfEngine

如何使用IronPdfEngine

IronPdfEngine 是一个 gRPC 服务器，专门设计用来管理 IronPDF 的多种任务，包括创建、编辑和阅读 PDF 文档。

开始使用IronPDF

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：

免费开始

IronPdf Node.js 和 IronPdfEngine

IronPdf for Node.js 需要 IronPdfEngine 才能运行。 Node.js 代码只是 IronPdfEngine gRPC 的一个 API 掩码。 因此，当您在 IronPdf for Node.js 中调用任何方法时，奇迹将在 IronPdfEngine 内发生。!

默认情况下，IronPdf for Node.js 将会生成 IronPdfEngine 作为子进程，并与之通信，直到您的应用程序关闭。

使用本地 IronPdfEngine 的 Node.js 版 IronPdf

选择1 在运行时下载IronPdfEngine

默认情况下，在您的Java项目中安装IronPdf后，第一次运行时，IronPdf将检测您的平台(例如，Windows x64)并从互联网上下载正确的 IronPdfEngine 二进制文件。

npm i @ironsoftware/ironpdf

优点

• 您的应用程序包将会很小。
• 可以部署在多个平台上

幻灯片

• 首次运行需要连接互联网。
• 启动时间慢

方案 2（推荐）将 IronPdfEngine 作为依赖项安装

IronPdf Node.js 允许您添加 IronPdfEngine 作为依赖项。 这些IronPdfEngine依赖项将IronPdfEngine捆绑到一个.zip文件中，并将自动提取并使用。

您可以选择安装一个或多个IronPdfEngine依赖项。

适用于 Windows x64

npm install @ironsoftware/ironpdf-engine-windows-x64

适用于 Windows x86

npm install @ironsoftware/ironpdf-engine-windows-x86

适用于 Linux x64

npm install @ironsoftware/ironpdf-engine-linux-x64

适用于 macOS x64

npm install @ironsoftware/ironpdf-engine-macos-x64

用于 macOS arm

npm install @ironsoftware/ironpdf-engine-macos-arm64

优点

• 更快的启动时间。
• 安装依赖后不需要互联网访问。

幻灯片

• 您的应用程序包将会很大。
• 需要指定目标平台。

IronPdf for Node.js 与 Remote IronPdfEngine

要使用远程IronPdfEngine，需要特定版本的IronPdfEngine。 例如，如果 IronPdf for Node.js 版本 2024.2.2 需要 IronPdfEngine 版本 2024.2.2，请不要使用 IronPdfEngine 版本 2024.2.1。访问 ironPdfEngineVersion 属性以检查所需的版本。

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

如何连接

假设 IronPdfEngine 在 123.456.7.8:33350 远程运行

[{i：（要远程运行 IronPdfEngine，请参阅"如何拉动和运行 IronPdfEngine.")}]

您只需告诉 IronPdf，IronPdfEngine 的位置在哪里(请确保可以访问该地址，而不是被防火墙阻挡).

在应用程序的初始阶段添加此代码(或在调用任何 IronPdf 方法之前).

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress:"123.456.7.8:33350"
});

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress:"123.456.7.8:33350"
});

就这么简单! 在此之后，您的应用程序将连接到远程IronPdfEngine。!

对于远程IronPdfEngine，无需将IronPdfEngine安装为依赖项。 你可以跳过题为 "方案 2（推荐）将 IronPdfEngine 作为依赖项安装."