如何在Node.js中使用IronPdfEngine

選項1：在運行時下載IronPdfEngine

安裝@ironsoftware/ironpdf之後，不需要額外的套件。 首次運行時，IronPDF檢測主機平台（例如，Windows x64）並從互聯網下載匹配的IronPdfEngine二進制文件。

 npm i @ironsoftware/ironpdf

優點：

• 保持應用程式包小。
• 部署到多個平台而無需特定平台配置。

缺點：

• 在前幾次運行中需要網路存取。
• 在初始運行時下載二進制文件時啟動時間較慢。

選項2（推薦）：將IronPdfEngine作為依賴項安裝

Node.js的IronPDF支持專用引擎包，這些包捆綁特定平台的IronPdfEngine二進制文件。 在主庫 alongside the main library旁安裝這些包之一或多個，以消除運行時下載。

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 arm64：

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

優點：

• 啓動更快——運行時無需下載。
• 安裝依賴後無需網路存取。

缺點：

• 應用程式包尺寸更大。
• 在構建時需要指定目標平臺。

如何驗證所需的引擎版本？

引擎版本必須與Node.js套件版本匹配。 請閱讀ironPdfEngineVersion屬性以確認要拉取的版本：

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/use-ironpdfengine-8.js

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

在指定Docker鏡像標籤時使用列印的版本號。 運行不匹配的版本將導致gRPC通信錯誤。

如何配置遠程連接？

假設IronPdfEngine正在123.456.7.8:33350運行。 將配置調用放在應用程式的開頭——在任何IronPDF方法調用之前。

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/use-ironpdfengine-9.js

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

地址必須從Node.js主機可存取。驗證防火牆規則未阻止應用程式伺服器和引擎主機之間的33350端口。