IronPDF 開始使用 安裝概述 Installation Overview Curtis Chau 更新日期:7月 12, 2025 Download IronPDF NuGet 下載 DLL 下載 Windows 安裝程式 Start Free Trial Copy for LLMs Copy for LLMs Copy page as Markdown for LLMs Open in ChatGPT Ask ChatGPT about this page Open in Gemini Ask Gemini about this page Open in Grok Ask Grok about this page Open in Perplexity Ask Perplexity about this page Share Share on Facebook Share on X (Twitter) Share on LinkedIn Copy URL Email article This article was translated from English: Does it need improvement? Translated View the article in English 完整指南，教你如何在所有平台上安裝和配置 IronPDF。 Get started making PDFs with NuGet now: Install IronPDF with NuGet Package Manager PM > Install-Package IronPdf Copy and run this code snippet. IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf"); Deploy to test on your live environment Start using IronPDF in your project today with a free trial Free 30 day 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++ 可再發行套件（x86 & x64） Linux 64 位 Linux OSs：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 部署到生產服務器，請使用遠程引擎模式。 class="col-6"> class="install-mode"> class="install-mode__header"> class="install-mode__title">遠程引擎模式 class="install-mode__subtitle">通過 gRPC 協議分離 PDF 處理。 class="install-mode__body"> 最佳用於：雲端和容器化部屬、舊版 OS 支援。 包裝：IronPdf.Slim 大小：較輕量級，佔用幾 MB。 要求：需要配置主機連接。 class="col-6"> class="install-mode__header"> class="install-mode__title">本地模式（預設） class="install-mode__subtitle">一切在您的應用程式中本地運行 class="recommended-float"> class="install-mode__body"> 最佳用於：現代 Windows、macOS 和 Linux 部署。 包裝：完整的 IronPdf NuGet 包。 大小：更大（幾百 MB），包括 Chrome 和 Pdfium 二進位文件。 要求：適用於現代作業系統。 3. 安裝選項 安裝 C# PDF 庫需要不到 5 分鐘的時間。 通過 NuGet 或直接下載免費獲取，並立即在 Visual Studio 中使用。 data-active-tab="1"> class="installation-options__tabs"> data-tab="1"> NuGet 包 data-tab="2"> 手動下載 data-tab="3"> 遠程 IronPdfEngine data-tab="1"> data-tab="2"> data-tab="3"> id="nuget-package-start"> 前往 IronPDF NuGet 庫（或在 Visual Studio 中的套件管理器控制台） 在解決方案資源管理器中，右鍵單擊引用 選擇“管理 NuGet 包”>“瀏覽”>搜尋 IronPdf 選擇套件並安裝。 Install-Package IronPdf class="related-link">相關： 更多進階的 IronPDF Nuget 包 id="nuget-package-end"> id="manual-download-start"> 下載適用於您的平台的 IronPDF DLL 包：Windows，Linux，macOS 將適用於您作業系統的 ZIP 文件解壓縮到解決方案目錄中的某個位置。 在 Visual Studio 解決方案資源管理器中，右鍵單擊“依賴項”。 “添加項目參考” > 選擇“瀏覽”以選取從 zip 解壓縮的所有 DLL。 id="manual-download-end"> id="remote-ironpdfengine-start"> 請注意請注意：每個 IronPDF 版本都需要匹配的 IronPdfEngine 版本。跨版本支持不可用。例如，IronPDF 2024.2.2 必須使用 IronPdfEngine 2024.2.2。 使用 NuGet 安裝 IronPdf。 Install-Package IronPdf.Slim id="remote-ironpdfengine-end"> 4. 其他配置 data-active-tab="1"> class="installation-options__tabs"> data-tab="1"> 管理許可證 data-tab="2"> 路徑和權限 data-tab="3"> 遠程引擎 data-tab="1"> data-tab="2"> data-tab="3"> id="manage-license-start"> 購買或註冊 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 id="manage-license-end"> id="path-permission-start"> 設置 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 和臨時文件夾。 id="path-permission-end"> id="remote-engine-start"> [遠程 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 class="related-link">相關： IronPdfEngine 限制 [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 class="related-link">相關： IronPDF Linux Docker 兼容性和設置 id="remote-engine-end"> 5. 部署場景 class="col-6"> class="deployment-card"> class="deployment-card__icon"> class="deployment-card__info"> class="deployment-card__title">運行和部署 IronPDF .NET 於 Azure Function class="col-6"> class="deployment-card"> class="deployment-card__icon"> class="deployment-card__info"> class="deployment-card__title">運行和部署 IronPDF .NET 於 AWS Lambda class="col-6"> class="deployment-card"> class="deployment-card__icon"> class="deployment-card__info"> class="deployment-card__title">在以下運行 IronPDF Linux Docker 容器 class="col-6"> class="deployment-card"> class="deployment-card__icon"> class="deployment-card__info"> class="deployment-card__title">作為以下的 IronPDF 運行 遠程容器 下一步 class="next-step__card-info"> class="next-step__card-icon"> class="next-step__card-text">HTML 到 PDF C# 完整指南 class="next-step__card-cta">查看教程 class="next-step__card-info"> class="next-step__card-icon"> class="next-step__card-text">變更記錄：更新、里程碑、路線圖 class="next-step__card-cta">查看產品更新 class="next-step__card-info"> class="next-step__card-icon"> class="next-step__card-text">請求工程支持 class="next-step__card-cta">查看故障排除 class="tutorials-navigation"> 快速入門指南 本地與遠程引擎 常見問題解答 如何設定 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 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。 準備好開始了嗎？ Nuget 下載 16,133,208 | 版本： 2025.11 剛剛發布 免費 NuGet 下載 總下載量：16,133,208 查看許可證