安裝概覽

Curtis Chau

更新:2026年4月21日

Translated

View the article in English

跨平台安裝與設定 IronPDF 的完整指南。

using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf
PM > Install-Package IronPdf

請複製並執行此程式碼片段。

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

部署至您的生產環境進行測試

立即透過免費試用，在您的專案中開始使用 IronPDF

1. 平台需求

平台	.NET 版本	硬體	其他要求、相容性
Windows	.NET 10、9、8、7、6、5、.NET Core、.NET Standard 及 .NET Framework。	最低需求：1 核心及 1.75 GB 記憶體建議配置：2 核心及 8 GB 記憶體或更高	Windows 10、11 及 Windows Server Visual C++ 重新發行套件 (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 中的套件管理員主控台）

在"解決方案總覽"中，右鍵點擊"參考項目"
選擇"管理 NuGet 套件">"瀏覽"> 搜尋 IronPDF
選擇套件並進行安裝。

Install-Package IronPdf

下載適用於您平台的 IronPDF DLL 套件：Windows、Linux、macOS
請將適用於您作業系統的 ZIP 檔案解壓縮至您的 Solution 目錄內。
在 Visual Studio 的"解決方案總覽"中，右鍵點擊"依賴項"。
"新增專案參考"> 點選"瀏覽"以加入從 ZIP 檔案中解壓縮的所有 DLL 檔案。

請注意請注意：每個 IronPDF 版本都需要對應的 IronPdfEngine 版本。不支援跨版本使用。例如，IronPDF 2024.2.2 必須譯為 IronPdfEngine 2024.2.2.

using NuGet 安裝 IronPDF。

Install-Package IronPdf.Slim

4. 其他設定

管理授權

Path & Permission

Remote Engine

購買 IronPDF 或註冊 30 天試用版後，請查收寄至您電子郵件的授權金鑰。

請在應用程式啟動時輸入您的授權金鑰。

IronPdf.License.LicenseKey = "KEY";

IronPdf.License.LicenseKey = "KEY";

Imports IronPdf

IronPdf.License.LicenseKey = "KEY"

$vbLabelText $csharpLabel

檢查授權狀態。

bool valid = IronPdf.License.IsLicensed;

bool valid = IronPdf.License.IsLicensed;

Imports IronPdf

Dim valid As Boolean = IronPdf.License.IsLicensed

$vbLabelText $csharpLabel

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

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

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

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

$vbLabelText $csharpLabel

提示請務必清除開發環境與伺服器上的所有暫存檔及快取資料夾，然後在更新路徑後重新部署應用程式的乾淨版本。

在應用程式層級設定暫存資料夾環境變數。

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.Com/bine(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.Com/bine(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

$vbLabelText $csharpLabel

提示在受限的伺服器上，請授予 IIS 使用者 (IUSER) 對安裝路徑資料夾、Windows 資料夾以及 Temp 資料夾的讀寫權限。

[遠端 IronPdfEngine] 安裝 IronPdf.Slim 套件後，請於應用程式啟動時或在呼叫任何 IronPDF 方法之前，連線至引擎容器並進行連線設定。

假設 IronPdfEngine 遠端執行於 123.456.7.8:33350：

Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

Installation.Co/nnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

$vbLabelText $csharpLabel

[Linux] 啟用 IronPDF 以自動安裝所有必要的 Linux 依賴項。首次將 HTML 轉換為 PDF 的操作可能需要比平常更長的時間。

Installation.LinuxAndDockerDependenciesAutoConfig = true;

Installation.LinuxAndDockerDependenciesAutoConfig = true;

Installation.LinuxAndDockerDependenciesAutoConfig = True

$vbLabelText $csharpLabel

[Docker] 預先初始化 Chrome 引擎，以預載必要元件並加速 Docker 中的首次使用。

IronPdf.Installation.Initialize();

IronPdf.Installation.Initialize();

IronPdf.Installation.Initialize()

$vbLabelText $csharpLabel

5. 部署情境

Run & Deploy IronPDF .NET on

Azure Function

Run & Deploy IronPDF .NET on

AWS Lambda

在

Linux Docker 容器

以IronPDF为实例

遠端容器

後續步驟

HTML 轉 PDF C# 完整指南

參閱教學指南

變更紀錄：更新、里程碑、發展藍圖

參閱產品更新

請求工程支援

請參閱疑難排解

常見問題

如何設定 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 套件，因為它僅包含使用 IronPdfEngine 執行 IronPDF 所需的必要元件，從而減小應用程式大小。

Curtis Chau

立即與工程團隊聯繫

技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？

Nuget 下載 18,918,602 | 版本： 2026.5 just released

檢視授權

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例觀看您的 HTML 轉為 PDF。

檢視授權

在 GitHub 上查看

程式碼

https://github.com/iron-software/IronPdf.Examples/tree/main/get-started/installation-overview

下載 ZIP

客戶案例：

開發者焦點：

網路研討會：

立即開始 30天試用

本頁內容

安裝概覽

using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

請複製並執行此程式碼片段。

部署至您的生產環境進行測試

1. 平台需求

2. 安裝方法

3. 安裝選項

4. 其他設定

5. 部署情境

後續步驟

常見問題

如何設定 IronPdfEngine 以進行遠端 PDF 生成？

在我的應用程式中使用 IronPdfEngine 有哪些主要優勢？

為什麼我會選擇使用 IronPdfEngine 而不是原生 PDF 函式庫？

IronPdfEngine 是否支援水平擴展？

IronPdfEngine 能否在不同的作業系統上運行？

若使用 IronPdfEngine 時產生的 PDF 輸出結果與預期不同，我該怎麼辦？

如何確保我的應用程式使用的是正確版本的 IronPdfEngine？

在 Windows 上使用 IronPdfEngine 時有哪些限制？

如何設定 IronPDF 以連線至遠端的 IronPdfEngine 伺服器？

使用 IronPdfEngine 時，應選用哪種套件才能將應用程式大小降至最低？

還在往下捲動嗎？

Iron 支援團隊

立即開始 30天試用

本頁內容

安裝概覽

using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

請複製並執行此程式碼片段。

部署至您的生產環境進行測試

1. 平台需求

2. 安裝方法

3. 安裝選項

4. 其他設定

5. 部署情境

後續步驟

常見問題

如何設定 IronPdfEngine 以進行遠端 PDF 生成？

在我的應用程式中使用 IronPdfEngine 有哪些主要優勢？

為什麼我會選擇使用 IronPdfEngine 而不是原生 PDF 函式庫？

IronPdfEngine 是否支援水平擴展？

IronPdfEngine 能否在不同的作業系統上運行？

若使用 IronPdfEngine 時產生的 PDF 輸出結果與預期不同，我該怎麼辦？

如何確保我的應用程式使用的是正確版本的 IronPdfEngine？

在 Windows 上使用 IronPdfEngine 時有哪些限制？

如何設定 IronPDF 以連線至遠端的 IronPdfEngine 伺服器？

使用 IronPdfEngine 時，應選用哪種套件才能將應用程式大小降至最低？

還在往下捲動嗎？

下一步：開始 30天試用

Thank You

下一步：開始 30天試用

Want to deploy IronSuite to a live project for FREE?

What’s included?

獲得全球數百萬工程師的信賴

Iron 支援團隊