使用 IronPDF 以引擎模式

本地模式與引擎模式的區別

IronPDF 有一些性能密集的功能，您可以選擇遠程運行。 雖然 IronPDF 不需要 IronPdfEngine 運行，但將 IronPdfEngine 配置為遠程服務是一種可選擇的方式，可以避免在舊版操作系統和移動環境中發生與平台相關的 Chrome 相容性問題。

開始使用 IronPDF

今天就使用IronPDF開始專案，免費試用。

第一步：

免費使用

---

使用引擎如何改變您與 IronPDF 的編碼方式

使用引擎配置時，我們建議安裝 IronPdf.Slim 而非完整的 IronPdf NuGet 包，因為引擎管理本地包中包含的所有額外臃腫內容。

Install-Package IronPdf.Slim

安裝 IronPdf.Slim 後，通過指向您的 IronPdfEngine 實例來配置連接設置。 在您的應用程式啟動時（或在調用任何 IronPDF 方法之前）新增以下程式碼：

:path=/static-assets/pdf/content-code-examples/get-started/ironpdfengine-2.cs

// 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 .NET 不需要 IronPdfEngine 來運行。 IronPdfEngine 只是使用 IronPDF 的一種可選方式。 預設情況下，IronPDF for .NET 不會使用 IronPdfEngine。

Install-Package IronPdf.Slim

:path=/static-assets/pdf/content-code-examples/get-started/ironpdfengine-4.cs

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

Imports IronPdf

' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)

IronPdfEngine的限制

• 目前，IronPdfEngine 本身不支持水平擴展（在多個引擎實例之間負載平衡），因為引擎在伺服器記憶體中保持進行中的 PDF 二進位文件，並使用 PdfDocumentId 在伺服器和客戶端之間協同。 此設計最大程度地減少了帶寬使用並提高了處理速度。 請注意，此限制僅適用於 IronPdfEngine 服務；使用 IronPDF 程式庫（無論是否與 IronPdfEngine 一起使用）的應用程式仍然可以通過部署多個應用程式實例進行水平擴展。
• 要遠程運行 IronPdfEngine Docker，您需要確保 IronPdfEngine 端口可存取。
• 在 Linux x64（Debian）上運行的 IronPdfEngine Docker 使用基於官方 ubuntu:22.04 的映像可能會生成稍有不同的 PDF 輸出，這與本地運行 IronPDF 所獲得的不同，原因是不同的操作系統行為。
• 由於 IronPdfEngine Docker 是基於 Linux 的，因此需要 Linux 容器守護程式（如果您使用的是 Windows，選擇 Switch to Linux Containers）。
• IronPdfEngine 二進位文件不是跨平台的，因此我們針對每個平台專門構建它們。
• 不支持跨版本支持。