安裝概述

Curtis Chau

更新:7月 12, 2025

Translated

View the article in English

IronPDF 全平台安裝配置完整指南。

使用 NuGet 套件管理器安裝 IronPDF

PM > Install-Package IronPdf

複製並運行這段程式碼。

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

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

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

免費試用30天

1. 平台要求

Platform	.NET 版本	Hardware	附加要求、相容性
Windows	.NET 10、9、8、7、6、5、.NET Core、.NET Standard 和 .NET Framework。	最低配置：單核心處理器和 1.75 GB 內存建議配置：雙核心處理器和 8GB 記憶體或以上	Windows 10、11 和 Windows Server Visual C++ 可再發行元件包（x86 和 x64）
Linux			64 位元 Linux 作業系統：Ubuntu 22、Ubuntu 20、Ubuntu 18、Ubuntu 16、Debian 10-11m CentOS 8、Fedora Linux 33、Amazon、AWS、Linux 2 IronCefSubprocess Chrome 依賴項
macOS			2020 年至今的所有 macOS 版本

2. 安裝方法

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

最適合：雲端和容器化部署，以及對舊版作業系統的支援。
軟體包： IronPdf.Slim
大小：更輕巧，僅佔用幾兆位元組。
需求：需要配置與主機的連線。

最適合：現代 Windows、macOS 和 Linux 部署。
軟體包：完整的 IronPdf NuGet 軟體包。
大小：體積較大（數百兆位元組），包含 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 檔案解壓縮到解決方案目錄中的某個位置。
在 Visual Studio 解決方案資源管理器中，以滑鼠右鍵按一下"依賴項"。
"新增項目參考" > 選擇"瀏覽"以包含從 zip 檔案中提取的所有 DLL 檔案。

請注意請注意：每個 IronPDF 版本都需要符合版本的 IronPdfEngine。不支援跨版本相容。例如，IronPDF 2024.2.2 必須使用 IronPdfEngine 2024.2.2。

使用 NuGet 安裝 IronPdf。

Install-Package IronPdf.Slim

4. 其他配置

管理許可證

Path & Permission

遠端引擎

購買或註冊 IronPDF 30 天試用版後，請尋找寄送至您信箱的許可證金鑰。

請在申請開始時新增您的許可證密鑰。

IronPdf.License.LicenseKey = "KEY";

IronPdf.License.LicenseKey = "KEY";

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

查詢許可證狀態。

bool valid = IronPdf.License.IsLicensed;

bool valid = IronPdf.License.IsLicensed;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$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.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");

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

在安全性受限的伺服器上，請授予 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")
);

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

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

Installation.LinuxAndDockerDependenciesAutoConfig = true;

Installation.LinuxAndDockerDependenciesAutoConfig = true;

IRON VB CONVERTER ERROR developers@ironsoftware.com

$vbLabelText $csharpLabel

[Docker]預先初始化 Chrome 引擎，以預先載入先決條件並加快在 Docker 中的首次使用速度。

IronPdf.Installation.Initialize();

IronPdf.Installation.Initialize();

IronPdf.Installation.Initialize()

$vbLabelText $csharpLabel

5. 部署場景

在以下平台上執行和部署 IronPDF .NET：

Azure 函數

在以下平台上執行和部署 IronPDF .NET：

AWS Lambda

在 Run IronPDF 中運行

Linux Docker 容器

以某種方式運行 IronPDF

遠程容器

後續步驟

HTML 轉 PDF C# 完整指南

請參閱教程

更新日誌：更新、里程碑、路線圖

查看產品更新

請求工程支持

請參閱故障排除

常見問題解答

如何設定 IronPdfEngine 以遠端產生 PDF？

要為遠端 PDF 生成設定 IronPdfEngine，請從 NuGet 安裝 IronPdf.Slim 套件，並使用 IronPdfConnectionConfiguration 類設定連線設定。此設定可讓您將應用程式遠端連線至 IronPdfEngine 實例。

在我的應用程式中使用 IronPdfEngine 的主要好處是什麼？

將 IronPdfEngine 與您的應用程式搭配使用，可遠端執行 PDF 任務，有助於避免特定平台的相容性問題，尤其是在較舊的系統和行動平台上。在執行過程中也不需要 .NET runtime。

為什麼我會選擇使用 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 時，您需要 Linux Containers for Docker，並必須確保伺服器連接埠可以到達。二進位檔是特定平台的，需要切換到 Linux Containers。

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

要為遠端伺服器設定 IronPDF，請使用 Installation.ConnectToIronPdfHost 與 IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer 方法，指定伺服器的 IP 與連接埠詳細資訊。

在使用 IronPdfEngine 時，我應該使用何種套件來最小化應用程式的大小？

您應該使用 NuGet 中的 IronPdf.Slim 套件，因為它只包含使用 IronPdfEngine 執行 IronPDF 的必要元件，因此可縮小應用程式的大小。

Curtis Chau

立即與工程團隊聊天

技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？

Nuget 下載 16,493,056 | Version: 2025.11 剛發表

檢視授權

在 GitHub 上檢視

程式碼

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

下載 ZIP

客戶亮點：

開發者焦點：

網絡研討會：

在此頁面

安裝概述

立即開始使用 NuGet 建立 PDF 檔案：

使用 NuGet 套件管理器安裝 IronPDF

複製並運行這段程式碼。

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

1. 平台要求

2. 安裝方法

3. 安裝選項

4. 其他配置

5. 部署場景

後續步驟

常見問題解答

如何設定 IronPdfEngine 以遠端產生 PDF？

在我的應用程式中使用 IronPdfEngine 的主要好處是什麼？

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

IronPdfEngine 支援水平縮放嗎？

IronPdfEngine 可以在不同的作業系統上執行嗎？

使用 IronPdfEngine 時，如果我的 PDF 輸出不同，該怎麼辦？

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

在 Windows 上使用 IronPdfEngine 有什麼限制？

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

在使用 IronPdfEngine 時，我應該使用何種套件來最小化應用程式的大小？

在此頁面

安裝概述

立即開始使用 NuGet 建立 PDF 檔案：

使用 NuGet 套件管理器安裝 IronPDF

複製並運行這段程式碼。

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

1. 平台要求

2. 安裝方法

3. 安裝選項

4. 其他配置

5. 部署場景

後續步驟

常見問題解答

如何設定 IronPdfEngine 以遠端產生 PDF？

在我的應用程式中使用 IronPdfEngine 的主要好處是什麼？

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

IronPdfEngine 支援水平縮放嗎？

IronPdfEngine 可以在不同的作業系統上執行嗎？

使用 IronPdfEngine 時，如果我的 PDF 輸出不同，該怎麼辦？

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

在 Windows 上使用 IronPdfEngine 有什麼限制？

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

在使用 IronPdfEngine 時，我應該使用何種套件來最小化應用程式的大小？

下一步開始 30 天免費試用

下一步開始 30 天免費試用

全球超過 200 萬工程師的信賴