安装概述
跨所有平台安装和配置IronPDF的完整指南。
-
1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
-
2Copy and run this code snippet.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3Deploy to test on your live environment
Start using IronPDF in your project today with a free trial
1. 平台要求
| 平台 | .NET 版本 | 硬件 | 附加要求、兼容性 |
|---|---|---|---|
 | .NET 10、9、8、7、6、5、.NET Core、.NET Standard 和 .NET Framework。 |
|
|
 |
| ||
 | 2020 年至今的所有 macOS 版本 |
2. 安装方法
您可以通过两种方式安装IronPDF：本地模式和远程引擎。默认推荐使用本地模式。 对于使用Docker/Kubernetes部署到生产服务器，使用远程引擎模式。
远程引擎模式。 通过 gRPC 协议进行单独的 PDF 处理。
- 最适合：云和容器化部署，以及对旧版操作系统的支持。
- 软件包： IronPdf.Slim
- 大小：更轻巧，仅占用几兆字节。
- 要求：需要配置与主机的连接。
- 最适合：现代 Windows、macOS 和 Linux 部署。
- 包：完整的IronPDF NuGet包。
- 大小：体积较大（数百兆字节），包含 Chrome 和 Pdfium 二进制文件。
- 要求：可在现代操作系统上运行。
3. 安装选项
安装C# PDF库不超过5分钟。 通过NuGet或直接下载免费获取，立即在Visual Studio中使用。
转到IronPDF NuGet库（或Visual Studio中的包管理控制台）
- 在解决方案资源管理器中，右键单击引用
- 选择'管理NuGet包'>'浏览'>搜索IronPDF
- 选择包并安装。
PM > Install-Package IronPdf
- 下载适用于您平台的 IronPDF DLL 包：Windows、Linux、macOS
- 将适用于您操作系统的 ZIP 文件解压缩到解决方案目录中的某个位置。
- 在 Visual Studio 解决方案资源管理器中，右键单击"依赖项"。
- 添加项目参考"> 选择 "浏览 "以包含从压缩包中提取的所有 DLL。
使用NuGet安装IronPDF。
PM > Install-Package IronPdf.Slim
4. 附加配置
购买或注册 IronPDF 30 天试用版后，请查找发送到您电子邮件中的许可证密钥。
在应用程序开始时添加您的许可密钥。
IronPdf.License.LicenseKey = "KEY";Imports IronPdf
IronPdf.License.LicenseKey = "KEY"检查许可证状态。
bool valid = IronPdf.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"在应用程序范围内设置临时文件夹环境变量。
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在安全受限的服务器上，请授予 IIS 用户 (IUSER) 对安装路径文件夹以及 Windows 和临时文件夹的读写权限。
[远程 IronPDFEngine] 安装 IronPdf.Slim 包后，连接到引擎容器，并在应用程序启动时或调用任何 IronPDF 方法之前配置连接。
假设IronPDFEngine在远程运行，地址为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")
)[Linux] 启用IronPDF自动安装所有必需的Linux依赖项。 第一次HTML到PDF操作可能比平时更长。
Installation.LinuxAndDockerDependenciesAutoConfig = true;Installation.LinuxAndDockerDependenciesAutoConfig = True[Docker] 预先初始化Chrome引擎以预加载先决条件并加快在Docker中的首次使用。
IronPdf.Installation.Initialize();IronPdf.Installation.Initialize()5. 部署场景
在以下平台上运行和部署 IronPDF for .NET
Azure 函数
在以下平台上运行和部署 IronPDF for .NET
AWS Lambda
在 Run IronPDF 中运行
Linux Docker 容器
以某种方式运行 IronPDF
远程容器下一步
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镜像，并检查可能影响渲染的任何操作系统特定设置。
我如何确保我的应用程序使用正确版本的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 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.
