如何在 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 映像標籤時，請使用 PRINT 版本號。 若執行不相容的版本，將導致 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 埠。