如何在Node.js中使用IronPdfEngine

选项 1: 在运行时下载IronPdfEngine

安装 @ironsoftware/ironpdf 后，无需额外安装其他软件包。 首次运行时，IronPDF会检测主机平台（例如，Windows x64）并从互联网下载匹配的IronPdfEngine二进制文件。

//:path=shell
npm install @ironsoftware/ironpdf

//:path=shell
npm install @ironsoftware/ironpdf

优点：

• 保持应用程序包的体积小。
• 无需特定平台的配置即可部署到多个平台。

缺点：

• 前几次运行时需要互联网连接。
• 初次执行时由于下载二进制文件会有较慢的启动时间。

选项2（推荐）：将IronPdfEngine作为依赖项安装

IronPDF for Node.js支持专用引擎包，这些包捆绑了特定平台的IronPdfEngine二进制文件。 与主库一同安装一个或多个这些包以消除运行时下载。

Windows x64：

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64

Windows x86：

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86

Linux x64：

//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64

macOS x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64

macOS arm64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64

优点：

• 启动速度更快 — 运行时不需要下载。
• 安装依赖项后无需互联网访问。

缺点：

• 应用程序包大小更大。
• 需要在构建时指定目标平台。

如何验证所需的引擎版本？

引擎版本必须与Node.js包版本匹配。 读取 ironPdfEngineVersion 属性以确认应拉取哪个版本：

//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

在指定Docker镜像标签时使用打印出的版本号。 运行不匹配的版本会导致gRPC通信错误。

如何配置远程连接？

假设 IronPdfEngine 正在 123.456.7.8:33350 处运行。 将配置调用放在应用程序的开头 - 在调用任何IronPDF方法之前。

//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

该地址必须可从 Node.js 主机访问。请确认应用程序服务器与引擎主机之间的 33350 端口未被任何防火墙规则阻塞。