使用 IronPDF 的引擎內模式

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

原生應用與引擎應用的差別

IronPDF 有一些對效能要求很高的功能,您可以選擇遠端執行這些功能。 雖然 IronPDF 不需要 IronPdfEngine 即可運行,但將 IronPdfEngine 設定為遠端服務是一種可選方法,可以避免在較舊的作業系統和行動環境中出現特定於平台的 Chrome 相容性問題。

開始使用 IronPDF

立即開始在您的項目中使用 IronPDF 並免費試用。

第一步:
green arrow pointer


使用 Engine 如何改變您使用 IronPDF 編寫程式碼的方式

使用引擎配置時,我們建議安裝IronPdf.Slim而不是從 NuGet 安裝完整的IronPdf套件,因為引擎會管理 Native 套件中包含的所有額外體積。

Install-Package IronPdf.Slim

安裝IronPdf.Slim後,透過將 IronPDF 指向您的 IronPdfEngine 實例來配置連線設定。 在應用程式啟動時(或在呼叫任何 IronPDF 方法之前)新增以下程式碼:

要新增到 C# 程式碼中的額外配置程式碼行

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

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application
' Establish a connection with the remote IronPdfEngine
' Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))

' Additional code for your application
$vbLabelText   $csharpLabel

IronPdfEngine 的工作原理是什麼?

IronPdfEngine 是一個容器化伺服器,旨在管理各種 IronPDF 操作,包括建立、寫入、編輯和讀取 PDF,所有這些操作都使用 gRPC 協定。 IronPdfEngine 是一個獨立的 C# .NET 應用程序,可以獨立運行,無需在執行期間使用 .NET 運行時。 我們為您處理 gRPC 連接,讓您可以專注於編碼!

有關如何將 IronPDF 作為獨立容器運行的快速入門教程,請參閱此教學

關於 IronPdfEngine 的其他說明

IronPDF for .NET 運行不需要IronPdfEngine。 IronPdfEngine 只是使用 IronPdf 的一種可選方式。 預設情況下,IronPdf for .NET 不會使用 IronPdfEngine。

每個版本的 IronPdf for .NET 都需要特定版本的 IronPdfEngine。不支援跨版本相容。 對於 IronPdf for .NET,所需的 IronPdfEngine 版本始終相符。 例如,IronPdf 2024.2.2 將使用 IronPdfEngine 2024.2.2)}]

IronPdf.NET 與遠端 IronPdfEngine

使用 IronPdf for .NET 和 Remote IronPdfEngine 時,只需 IronPdf.slim NuGet 套件即可。

如果您使用的是IronPdfIronPdf.Linux ,則可以使用IronPdf.slim來減少應用程式的大小。

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

使用 NuGet 安裝 IronPdf:

Install-Package IronPdf.Slim

安裝IronPdf.slim後,您只需告訴 IronPdf IronPdfEngine 在哪裡(請確保該地址可訪問,未被防火牆阻止)。 使用IronPdfConnectionConfiguration類別配置連線設定。 將以下程式碼新增至應用程式的初始階段(或在呼叫任何 IronPdf 方法之前)。

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))
$vbLabelText   $csharpLabel

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


IronPdfEngine 的局限性

  • 目前,IronPdfEngine 還不支援水平擴展(使用多個實例進行負載平衡),因為我們將處理的 PDF 文件二進位檔案儲存在伺服器記憶體中,並使用 PdfDocumentId 在伺服器和客戶端之間進行通訊。 這樣也能最大限度地減少頻寬使用,提高處理速度。
  • 要遠端執行 IronPdfEngine Docker,您需要確保 IronPdfEngine 連接埠可存取。
  • 由於作業系統行為不同,在 Linux x64 (Debian) 上使用官方 ubuntu:22.04 映像運行的 IronPdfEngine Docker 可能會產生與在本地運行 IronPdf 時略有不同的 PDF 輸出。
  • 由於 IronPdfEngine Docker 是基於 Linux 的,因此需要 Linux 容器守護程序(如果您使用的是 Windows,請選擇Switch to Linux Containers ")。 IronPdfEngine 二進位檔案不是跨平台的,所以我們針對每個平台專門建立它們。
  • 不支援跨版本。

常見問題解答

我如何設置 IronPdfEngine 以進行遠程 PDF 生成?

要設置 IronPdfEngine 進行遠程 PDF 生成,請從 NuGet 安裝 IronPdf.Slim 包,並使用 IronPdfConnectionConfiguration 類配置連接設置。此設置允許您遠程連接您的應用程序到 IronPdfEngine 實例。

在我的應用程序中使用 IronPdfEngine 的主要好處是什麼?

將 IronPdfEngine 與您的應用程序一起使用允許遠程執行 PDF 任務,幫助避免平台特定的兼容性問題,特別是在較舊的系統和移動平台上。它還消除了執行期間對 .NET 運行時的需求。

為什麼我可能會選擇使用 IronPdfEngine 而不是本機 PDF 庫?

您可能會選擇使用 IronPdfEngine 遠程運行性能密集的 PDF 功能,以減少與不同操作系統的兼容性問題,並通過利用一個 Chrome 相同的渲染器來改善 HTML 到 PDF 轉換的性能。

IronPdfEngine 是否支持橫向擴展?

不,IronPdfEngine 目前不支持橫向擴展,這意味著它不能在多個實例之間進行負載平衡,因為 PDF 文件二進制文件在服務器內存中的處理方式。

IronPdfEngine 能否在不同的操作系統上運行?

IronPdfEngine 被設計為使用 Docker 容器運行在 Linux 系統上。然而,這些二進制文件是平台特定的,因此您需要確保您正在使用適合您的操作系統的正確版本。

如果使用 IronPdfEngine 時我的 PDF 輸出不同,我應該怎麼做?

由於不同的操作系統行為,PDF 輸出可能會略有不同。為了盡量減少差異,請確保您使用正確的 Docker 映像,並檢查任何可能影響渲染的操作系統特定設置。

我如何確保我的應用程序使用的是正確版本的 IronPdfEngine?

為確保兼容性,每個版本的IronPDF需要匹配版本的IronPdfEngine。請確保同時更新這兩個組件,以避免跨版本問題。

在 Windows 上使用 IronPdfEngine 有什麼限制?

在 Windows 上使用 IronPdfEngine 時,您需要 Docker 的 Linux 容器,並且必須確保服務器端口可達。這些二進制文件是平台特定的,必須切換到 Linux 容器。

我如何配置 IronPDF 以連接到遠程 IronPdfEngine 服務器?

要配置 IronPDF 遠程服務器,請使用 Installation.ConnectToIronPdfHost,結合 IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer 方法,指定服務器的 IP 和端口詳細信息。

使用 IronPdfEngine 時,應使用哪個包來將應用程序大小降至最低?

您應從 NuGet 使用 IronPdf.Slim 包,因為它只包含運行 IronPDF 與 IronPdfEngine 所需的組件,從而減少應用程序大小。

Curtis Chau
技術作家

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

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

準備好開始了嗎?
Nuget 下載 16,685,821 | 版本: 2025.12 剛發表