使用 IronPDF 的引擎內模式

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

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

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

使用 Engine 配置時，我們建議從 NuGet 安裝 IronPdf.Slim 而非完整的 IronPdf 套件，因為 Engine 會管理 Native 套件中包含的所有額外內容。

Install-Package IronPdf.Slim

安裝 IronPdf.Slim 後，請將 IronPDF 指向您的 IronPdfEngine 實例，以設定連線設定。 在應用程式啟動時（或在呼叫任何 IronPDF 方法之前）新增以下程式碼：

// 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

IronPDFEngine 的工作原理是什麼？

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

有關如何將 IronPDF 作為獨立容器運行的快速入門教程，請參閱此教學。 此 Docker 容器支援 16 個執行階段配置參數，涵蓋端口、記錄、Chrome 限制等項目 — 請參閱完整的參數參考。

關於 IronPDFEngine 的其他說明

IronPDF for .NET 運行不需要IronPDFEngine。 IronPDFEngine 只是使用 IronPDF 的一種可選方式。 預設情況下，IronPDF 適用於 .NET 不會使用 IronPDFEngine。

Install-Package IronPdf.Slim

// 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"))

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 二進位檔案不是跨平台的，所以我們針對每個平台專門建立它們。
• 不支援跨版本。