1. IronPDF
  2. 開始
  3. 使用 IronPdfEngine

如何使用 IronPdfEngine

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine 是一個 gRPC 伺服器，旨在管理一系列 IronPDF 任務，包括建立、編輯和讀取 PDF 文件。

如何在Node.js中使用IronPdfEngine

  1. 安裝 Node.js 函式庫以使用 IronPdfEngine。
  2. 使用 npm 安裝該庫，即可將其包含進來。
  3. 透過相同的安裝方式取得 Chrome 二進位。
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. 使用IronPdfEngine以與Chrome渲染器相同的效果將HTML渲染為PDF。

開始使用 IronPdf

IronPdf Node.js 和 IronPdfEngine

Node.js 版 IronPdf需要IronPdfEngine 才能運作。 Node.js 程式碼只是對 IronPdfEngine gRPC 的一個 API 遮罩。 因此，當您在 IronPdf for Node.js 中呼叫任何方法時，神奇的事情都會在 IronPdfEngine 內部發生！

預設情況下，Node.js 版 IronPdf 會將 IronPdfEngine 作為子進程啟動，與其通信，直到應用程式關閉為止。

注意：每個版本的 Node.js 版 IronPdf 都需要特定版本的 IronPdfEngine。不支援跨版本相容。

適用於 Node.js 的 IronPdf 和本地 IronPdfEngine

方案一：運行時下載 IronPdfEngine

預設情況下，在 JavaScript 專案中安裝 IronPdf 後，首次執行時，IronPdf 將偵測您的平台（例如 Windows x64）並從網路下載正確的 IronPdfEngine 二進位檔案。

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

Pros: 您的申請包會很小。

  • 可部署在多個平台上。

Cons:

  • 前幾次運行需要連接網路。 啟動速度慢。

選項 2（建議）：將 IronPdfEngine 安裝為依賴項

IronPdf for Node.js 允許您新增 IronPdfEngine 作為依賴項。 這些 IronPdfEngine 依賴項將 IronPdfEngine 打包到一個.zip檔案中，並會自動提取和使用它。

您可以選擇安裝一個或多個 IronPdfEngine 依賴項。

注意： ironpdf和ironpdf-engine-xxx-xxx依賴項的版本必須相同。 ironpdf-engine-xxx-xxx依賴項版本並不指 IronPdfEngine 內部的版本。

平台特定安裝：

  • Windows x64：

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

  • Windows x86：

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

  • Linux x64：

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

  • macOS x64：

    npm install @ironsoftware/ironpdf-engine-macos-x64
    npm install @ironsoftware/ironpdf-engine-macos-x64
    SHELL
  • macOS arm：
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    SHELL

Pros: 啟動速度更快。 安裝依賴項後，無需連接網路。

Cons: 您的申請文件會很大。

  • 需要指定目標平台。

適用於 Node.js 的 IronPdf 和遠端 IronPdfEngine

要使用遠端 IronPdfEngine，需要特定版本的 IronPdfEngine。 例如，如果 Node.js 版本的 IronPdf 2024.2.2 需要 IronPdfEngine 2024.2.2 版本，請勿使用 IronPdfEngine 2024.2.1 版本。存取ironPdfEngineVersion屬性以檢查所需的版本。

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

如何連接

假設 IronPdfEngine 在遠端123.456.7.8:33350上運行。

請參閱"如何拉取和運行 IronPdfEngine "。

要連接，您只需指定 IronPdfEngine 的位置（請確保地址可訪問，未被防火牆阻止）。 在應用程式的初始階段，或在呼叫任何 IronPdf 方法之前，請新增此程式碼。

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

就這麼簡單！ 之後，您的應用程式將連接到遠端 IronPdfEngine！

對於遠端 IronPdfEngine，無需將 IronPdfEngine 作為依賴項安裝。 您可以跳過標題為"選項 2（建議）將 IronPdfEngine 安裝為依賴項"的部分。

常見問題解答

IronPdfEngine 在 Node.js 中有何用途？

IronPdfEngine 是在 Node.js 中使用的 gRPC 伺服器，用來管理 PDF 任務，例如建立、編輯和渲染，提供無縫的 PDF 處理體驗。

如何安裝 IronPDF for Node.js？

您可以使用 npm 指令 npm install @ironsoftware/ironpdf 安裝 IronPDF for Node.js。

IronPdfEngine 的本地設定與遠端設定有何差異？

本地安裝包括在運行時下載 IronPdfEngine 或將其作為依賴安裝，提供更快的啟動時間。遠端安裝則是連線至遠端託管的 IronPdfEngine，省去本機安裝的麻煩。

如何確保 IronPdf 和 IronPdfEngine 版本之間的相容性？

每個版本的 IronPDF for Node.js 都需要特定版本的 IronPdfEngine。使用 ironPdfEngineVersion 屬性來檢查所需的版本，並確保兩個版本相符。

安裝 IronPdfEngine 作為依賴有什麼好處？

將 IronPdfEngine 作為相依性安裝，可加快啟動時間，且安裝後不需存取網際網路，但會增加應用程式套件的大小。

如何連接遠端 IronPdfEngine？

要連接到遠端的 IronPdfEngine，使用 IronPdfGlobalConfig.setConfig 來指定伺服器位址，確保它可以被存取，並且不會被防火牆阻擋。

IronPdfEngine 的運行下載是否需要互聯網連接？

是的，在運行時下載 IronPdfEngine 時，前幾次運行需要網路存取，這也會導致啟動時間較慢。

遠端使用 IronPdfEngine 需要安裝嗎？

不，當使用遠端 IronPdfEngine 時，您不需要在本機安裝它作為依賴。

IronPdfEngine 可以在不同的平台上使用嗎？

是的，IronPdfEngine 可以部署在多個平台上。特定平台的 npm 指令可用於 Windows、Linux 和 macOS 上的安裝。

IronPDF 是否與 .NET 10 相容，支援哪些環境？

是的，IronPDF 與 .NET 10 完全相容（與 .NET 9、8、7 等相容）。它支援 C#、VB.NET、F#，並可跨平台運作，例如 Windows、Linux、macOS，包括 Docker 和雲端環境，因此適用於 .NET 10 網頁、桌面、主控台或雲端專案。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
版本： 2025.12 剛發表