使用IronPDF 的引擎內模式

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

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

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

使用引擎配置時，我們建議從NuGet安裝 IronPdf.Slim 而不是完整的 IronPdf 包，因為引擎管理了 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.Co/nnectToIronPdfHost(
    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.Co/nnectToIronPdfHost(
    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 .NET運作不需要IronPdfEngine。 IronPdfEngine 只是使用IronPDF 的一種可選方式。 預設情況下， IronPDF for .NET不會使用 IronPdfEngine。

Install-Package IronPdf.Slim

// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

IronPdfEngine 的局限性

• 目前，IronPdfEngine 本身不支援水平擴展（跨多個引擎實例進行負載平衡），因為該引擎將正在處理的 PDF 二進位檔案保存在伺服器記憶體中，並使用 PdfDocumentId 在伺服器和用戶端之間進行協調。 這種設計最大限度地減少了頻寬使用，提高了處理速度。 請注意，此限制僅適用於 IronPdfEngine 服務；使用IronPDF庫（無論是否使用 IronPdfEngine）的應用程式仍可透過部署多個應用程式實例進行水平擴展。
• 要遠端執行 IronPdfEngine Docker，您需要確保 IronPdfEngine 連接埠可存取。
• 由於作業系統行為不同，在 Linux x64 (Debian) 上使用官方 ubuntu:22.04 映像運行的 IronPdfEngine Docker 可能會產生與在本地運行IronPDF時略有不同的 PDF 輸出。
• 由於 IronPdfEngine Docker 是基於 Linux 的，因此需要 Linux Containers 守護程序（如果您使用的是 Windows，請選擇 Switch to Linux Containers）。
• IronPdfEngine 二進位檔案不是跨平台的，所以我們針對每個平台專門建立它們。
• 不支援跨版本。