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

How to Use 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文檔。

class="hsg-featured-snippet">

如何在Node.js中使用IronPdfEngine

  1. 安裝Node.js庫以使用IronPdfEngine。
  2. 通過npm安裝來包含該庫。
  3. 通過同一安裝獲取Chrome二進位文件。
  4. 通過訪問`ironPdfEngineVersion`屬性檢查所需版本。
  5. 使用IronPdfEngine用類似Chrome的渲染器渲染HTML到PDF。

開始使用IronPDF

IronPdf Node.js及IronPdfEngine

IronPdf for Node.js 需要 IronPdfEngine來運行。 Node.js代碼僅僅是IronPdfEngine gRPC上的API遮罩。 因此，當您調用Node.js的IronPdf中的任何方法時，魔術發生在IronPdfEngine內部！

默認情況下，Node.js的IronPdf將以子進程的方式生成IronPdfEngine並與之通信，直到您的應用程式關閉。

注意：Node.js的每個版本的IronPdf要求特定版本的IronPdfEngine。不支持跨版本。

Node.js的IronPdf與本地IronPdfEngine

選項1：在運行時下載IronPdfEngine

默認情況下，在您將IronPdf安裝到您的JavaScript專案中後，在首次運行時，IronPdf將檢測您的平台（如Windows x64）並從互聯網下載正確的IronPdfEngine二進位文件。

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

優點：

  • 您的應用程序包將很小。
  • 可以部署到多個平台。

缺點：

  • 在最初的幾次運行中需要互聯網連接。
  • 啟動時間較慢。

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

Node.js的IronPdf允許您將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

優點：

  • 啟動速度較快。
  • 依賴項安裝完畢後不需要互聯網連接。

缺點：

  • 您的應用程序包將很大。
  • 需要指定目標平台。

Node.js的IronPdf與遠端IronPdfEngine

要使用遠端IronPdfEngine，需要特定版本的IronPdfEngine。 例如，如果Node.js版本2024.2.2的IronPdf需要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作為依賴項安裝"的部分。

常見問題解答

在Node.js中，IronPdfEngine是做什麼用的？

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

如何為Node.js安裝IronPDF？

您可以使用 npm 透過指令npm install @ironsoftware/ironpdf安裝適用於 Node.js 的 IronPDF。

IronPdfEngine 的本地部署和遠端部署有什麼區別？

本機安裝方式包括在運行時下載 IronPdfEngine 或將其作為依賴項安裝，從而提供更快的啟動速度。遠端安裝方式則連接到遠端託管的 IronPdfEngine，無需本機安裝。

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

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

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

將 IronPdfEngine 作為依賴項安裝可以加快啟動速度，並在安裝後消除對網路存取的需求，儘管這會增加應用程式套件的大小。

如何連線到遠端 IronPdfEngine？

若要連線到遠端 IronPdfEngine，請使用IronPdfGlobalConfig.setConfig指定伺服器位址，確保其可存取且未被防火牆封鎖。

IronPdfEngine運行時下載是否需要網路連線？

是的，在執行時下載 IronPdfEngine 時，最初幾次運行需要連網，這也會導致啟動速度變慢。

遠端使用IronPdfEngine需要安裝嗎？

不，使用遠端 IronPdfEngine 時，無需將其作為依賴項在本機安裝。

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

是的，IronPdfEngine 可以部署在多個平台上。針對 Windows、Linux 和 macOS 平台，都提供了對應的 npm 安裝指令。

IronPDF 是否相容於 .NET 10？它支援哪些環境？

是的，IronPDF 完全相容於 .NET 10（以及 .NET 9、8、7 等）。它支援 C#、VB.NET 和 F#，並且可以在 Windows、Linux、macOS 等平台上運行，包括 Docker 和雲端環境，因此適用於 .NET 10 的 Web、桌面、主機或雲端專案。

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

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

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

準備好開始了嗎？
版本： 2025.11 剛剛發布