安装概述

This article was translated from English: Does it need improvement?
Translated
View the article in English

跨所有平台安装和配置IronPDF的完整指南。

Nuget Icon立即开始使用 NuGet 创建 PDF 文件:

  1. 使用 NuGet 包管理器安装 IronPDF

    PM > Install-Package IronPdf

  2. 复制并运行这段代码。

    IronPdf.ChromePdfRenderer
           .StaticRenderHtmlAsPdf("<p>Hello World</p>")
           .SaveAs("pixelperfect.pdf");
  3. 部署到您的生产环境中进行测试

    立即开始在您的项目中使用 IronPDF,免费试用!
    arrow pointer

1. 平台要求

Platform .NET 版本 Hardware 附加要求、兼容性
Logo Table Windows related to 1. 平台要求
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)
Logo Table Linux related to 1. 平台要求
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 依赖项
Logo Table Mac related to 1. 平台要求
macOS
2020 年至今的所有 macOS 版本

2. 安装方法

您可以通过两种方式安装IronPDF:本地模式和远程引擎。默认推荐使用本地模式。 对于使用Docker/Kubernetes部署到生产服务器,使用远程引擎模式。

远程引擎模式通过 gRPC 协议进行单独的 PDF 处理
  • 最适合:云和容器化部署,以及对旧版操作系统的支持。
  • 软件包: IronPdf.Slim
  • 大小:更轻巧,仅占用几兆字节。
  • 要求:需要配置与主机的连接。

3. 安装选项

安装C# PDF库不超过5分钟。 通过NuGet或直接下载免费获取,立即在Visual Studio中使用。

NuGet 包
手动下载
远程 IronPdfEngine

转至 IronPDF NuGet 库(或 Visual Studio 中的软件包管理器控制台)

  1. 在解决方案资源管理器中,右键单击引用
  2. 选择 '管理 NuGet 包' > '浏览' > 搜索 IronPdf
  3. 选择包并安装。
Install-Package IronPdf
  1. 下载适用于您平台的 IronPDF DLL 包:Windows、Linux、macOS
  2. 将适用于您操作系统的 ZIP 文件解压缩到解决方案目录中的某个位置。
  3. 在 Visual Studio 解决方案资源管理器中,右键单击"依赖项"。
  4. 添加项目参考"> 选择 "浏览 "以包含从压缩包中提取的所有 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

[{t:(在锁定的服务器上,赋予 IIS 用户 (IUSER) 对安装路径文件夹以及 Windows 和 Temp 文件夹的读写权限。

[远程 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. 部署场景

Logo Azure related to 5. 部署场景

在以下平台上运行和部署 IronPDF for .NET

Azure 函数
Logo Aws related to 5. 部署场景

在以下平台上运行和部署 IronPDF for .NET

AWS Lambda
Logo Linux related to 5. 部署场景

在 Run IronPDF 中运行

Linux Docker 容器
Logo Remote related to 5. 部署场景

以某种方式运行 IronPDF

远程容器

下一步


常见问题解答

我如何设置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时,您需要Linux Containers for Docker,并必须确保服务器端口可访问。二进制文件是平台特定的,需要切换到Linux Containers。

如何配置IronPDF以连接到远程IronPdfEngine服务器?

要为远程服务器配置IronPDF,请使用Installation.ConnectToIronPdfHost方法中的IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer,指定服务器的IP和端口详细信息。

使用IronPdfEngine时应该使用哪个包以最小化应用程序大小?

您应使用NuGet中的IronPdf.Slim包,因为它仅包含运行IronPDF与IronPdfEngine所需的组件,从而减少应用程序大小。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

准备开始了吗?
Nuget 下载 16,493,056 | Version: 2025.11 刚刚发布