安裝概述

Q: 我如何設置IronPdfEngine以進行遠端PDF生成？

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

Q: 如何配置IronPDF以連接到遠端IronPdfEngine伺服器？

要配置IronPDF用於遠端伺服器，使用 Installation.ConnectToIronPdfHost ，結合 IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer 方法，指定伺服器的IP和端口詳情。

Q: 使用IronPdfEngine時應使用哪個包以減小應用程式大小？

您應該使用來自NuGet的 IronPdf.Slim 包，因為它僅包含運行IronPDF與IronPdfEngine所需的組件，因此可以減小應用程式大小。

Curtis Chau

Updated: 2026年6月4日

完整的指南來安裝和配置IronPDF於各種平台上。

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2Copy and run this code snippet.

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

3Deploy to test on your live environment

Start using IronPDF in your project today with a free trial

1. 平台要求

平台	.NET版本	硬體	附加要求，相容性
Windows	.NET 10，9，8，7，6，5，.NET Core，.NET Standard，和.NET Framework。	最低要求：1個核心和1.75 GB的 RAM 建議：2個核心和8 GB的 RAM或以上	Windows 10，11，和Windows Server Visual C++ Redistributable (x86 & x64)
Linux			64位Linux操作系統：Ubuntu 22，Ubuntu 20，Ubuntu 18，Ubuntu 16，Debian 10-11，CentOS 8，Fedora Linux 33，Amazon，AWS，Linux 2 IronCefSubprocess Chrome依賴項
macOS			所有2020年以來的macOS版本

2. 安裝方法

有兩種方式可以安裝IronPDF：本機模式和遠端引擎。預設推薦使用本機模式。若要使用Docker/Kubernetes部署到生產伺服器，請使用遠端引擎模式。

最適合：雲端和容器化部署，舊版操作系統支持。
套餐：IronPdf.Slim
大小：更輕量，占用幾MB。
要求：需要配置到主機的連接。

最適合：現代Windows，macOS和Linux部署。
套餐：完整的IronPDF NuGet套餐。
大小：尺寸較大（數百MB），包括Chrome和Pdfium二進位文件。
要求：適用於現代操作系統。

3. 安裝選項

安裝C# PDF程式庫僅需不到5分鐘。通過NuGet或直接下載免費獲取，並立即在Visual Studio中開始使用。

NuGet 套件

手動下載

遠端IronPdfEngine

前往IronPDF NuGet程式庫（或在Visual Studio中打開套件管理器主控台）

在方案總覽中，右鍵點擊References
選擇'管理NuGet套件' > '瀏覽' > 搜尋IronPDF
選擇包並安裝。

PM > Install-Package IronPdf

Install-Package IronPdf

下載適用於您的平台的IronPDF DLL包：Windows，Linux，macOS
將您操作系統的ZIP文件解壓縮至您的方案目錄中的一個位置。
在Visual Studio方案總覽中，右鍵點擊'Dependencies'。
'新增專案參考' > 選擇'瀏覽'以包含從zip解壓縮的所有DLLs。

Please note: 請注意：每個IronPDF版本需要匹配版本的IronPdfEngine。不支持跨版本。

例如，IronPDF 2024.2.2必須使用IronPdfEngine 2024.2.2。 )}]

使用NuGet安裝IronPDF。

PM > Install-Package IronPdf.Slim

Install-Package IronPdf.Slim

4. 附加配置

管理授權

Path & Permission

遠端引擎

在您購買或註冊IronPDF的30天試用後，找到發送到您電子郵件中的授權金鑰。

在您的應用程式開始時新增您的授權金鑰。

IronPdf.License.LicenseKey = "KEY";

IronPdf.License.LicenseKey = "KEY";

Imports IronPdf

IronPdf.License.LicenseKey = "KEY"

Imports IronPdf

IronPdf.License.LicenseKey = "KEY"

檢查授權狀態。

bool valid = IronPdf.License.IsLicensed;

bool valid = IronPdf.License.IsLicensed;

Imports IronPdf

Dim valid As Boolean = License.IsLicensed

Imports IronPdf

Dim valid As Boolean = License.IsLicensed

設置IronPdf.Installation物件的TempFolderPath屬性。

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";

IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"

IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"

Tips: 確保在更新路徑後清除所有開發和伺服器上的臨時和快取文件夾，然後重新部署乾淨版本的應用程式。

在應用程式範圍內設置臨時文件夾環境變數。

using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");

using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");

Imports IronPdf

' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
    Doc.SaveAs("example.pdf")
End Using

Imports IronPdf

' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
    Doc.SaveAs("example.pdf")
End Using

Tips: 在被鎖定的伺服器上，給予IIS使用者(IUSER)讀寫您安裝路徑文件夾的權限，並對您的Windows和臨時文件夾。

[遠端IronPdfEngine] 安裝IronPdf.Slim包後，連接到引擎容器並在應用程式啟動時或在調用任何IronPDF方法之前配置連接。

假設IronPdfEngine在遠程運行於123.456.7.8:33350：

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

Imports IronPdf

Installation.ConnectToIronPdfHost(
    GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)

Imports IronPdf

Installation.ConnectToIronPdfHost(
    GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)

[Linux] 使IronPDF自動安裝所有必需的Linux依賴項。第一次HTML到PDF的操作可能比平常花費更長的時間。

Installation.LinuxAndDockerDependenciesAutoConfig = true;

Installation.LinuxAndDockerDependenciesAutoConfig = true;

Installation.LinuxAndDockerDependenciesAutoConfig = True

Installation.LinuxAndDockerDependenciesAutoConfig = True

**[Docker]**預初始化Chrome引擎以預載入前置條件，加快在Docker中的首次使用。

IronPdf.Installation.Initialize();

IronPdf.Installation.Initialize();

IronPdf.Installation.Initialize()

IronPdf.Installation.Initialize()

5. 部署場景

運行並部署IronPDF .NET於

運行並部署IronPDF .NET於

運行IronPDF於

將IronPDF作為

下一步

HTML到PDF C#完整指南

查看教程

變更日誌：更新，里程碑，路線圖

查看產品更新

請求工程支援

查看故障排除

Frequently Asked Questions

我如何設置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影像，並檢查可能影響渲染的任何OS特定設置。

如何確保我的應用程式正在使用正確版本的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

Chat with engineering team now

Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...