将 IronPDF 添加到现有的 Docker 容器中

Curtis Chau

已更新:2025年12月3日

Translated

View the article in English

IronPDF for .NET Standard 现已完全支持 Docker，包括适用于 Linux 和 Windows 的 Azure Docker 容器。

是否希望将 IronPDF 部署为单独的 Docker 容器？了解更多关于IronPdfEngine 教程指南的信息。

为什么在 Azure 上使用 Docker？

除了卓越的企业可扩展性，Azure 上的 Docker 容器还享有比普通 WebApps 更多的权限。这使得可以支持 SVG 字体的渲染，因为已启用对 GDI+ 图形的系统访问。

IronPDF 和 Linux 入门

如果您不熟悉 Docker 和 .NET，我们推荐这篇关于设置 Docker 调试和与 Visual Studio 项目的集成的优秀文章。

我们还强烈建议您阅读我们的IronPDF Linux 设置和兼容性指南

IronPDF Linux Docker 安装

使用 Linux 优化的 NuGet 包

我们推荐使用IronPdf.Linux NuGet 包来代替普通的IronPDF包，以节省磁盘空间，并避免在启动 Docker 实例时下载资产。不用担心，它在 Windows 或 macOS 的开发时仍然有效，只是针对 Linux 进行了优化。

Install-Package IronPdf.Linux

另一种解决方案是简单地在普通IronPDF NuGet 包上添加IronPdf.Native.Chrome.Linux。

Install-Package IronPdf.Native.Chrome.Linux

避免自动安装依赖项

许多用户报告称，当将 LinuxAndDockerDependenciesAutoConfig 设置为 false 时，Linux 和 Docker 的效果更好。这是因为 Docker 文件中的 apt-get 风格的包管理器已经安装了所需的先决条件。

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

$vbLabelText $csharpLabel

禁用 GPU 加速

Linux Docker 容器通常无法访问 GPU。默认情况下禁用 GPU 加速。如果您已启用 ChromeGpuModes.Enabled，我们强烈建议您在 Docker 部署中禁用它：

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

$vbLabelText $csharpLabel

Ubuntu Linux Docker 文件

Ubuntu 22 和 .NET 8

Ubuntu 22 with .NET 7

使用 .NET 6 的 Ubuntu 20.

Ubuntu 20 with .NET 5

Ubuntu 20 with .NET 3.1 LTS

Ubuntu 18 with .NET 3.1 LTS

Debian Linux Docker 文件

Debian 12 与 .NET 8

Debian 11 with .NET 7

Debian 11 与 .NET 6

Debian 11 with .NET 5

Debian 11 with .NET 3.1 LTS

Debian 10 with .NET 5

Debian 10 with .NET 3.1 LTS

Alpine Linux Docker 文件

在 Alpine Linux 上运行 IronPDF 不受支持。我们希望能做到，但我们做不到。坦率地说，我们喜欢 Alpine，希望这个项目能继续下去并不断发展壮大。截至 2023 年，Alpine 仍在使用过时的 "musl" C 语言库，无法让 Chromium 开发人员完全支持此操作系统。

在 .NET 6 中使用 IronPdfEngine 的 Alpine Docker

IronPDF 提供一个包含所有 IronPDF 功能的容器映像。这样，在 Alpine 上运行的项目就可以通过连接 IronPdfEngine 容器访问 IronPD 功能。

步骤 1：提取并运行 IronPDF 引擎 Docker 映像

在终端中执行以下命令，提取并运行 IronPDF 引擎 Docker 映像：

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

SHELL

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

SHELL

步骤 2：设置控制台应用程序

创建一个以 .NET 6 为目标的新控制台应用程序。使用 NuGet 包管理器安装 IronPdf.Slim NuGet 包。

Windows Docker 文件

Windows Docker 容器在 Azure 上越来越受欢迎，因为它们提供了更高水平的性能和可扩展性，并为开发人员提供了更多配置实例的权限。

由于对图形库和虚拟显卡的访问级别更高，IronPdf 在 Azure 上的 Docker 容器（Windows 或 Linux）内实际上会执行更有吸引力的文本渲染。

用于 Docker 的 Visual Studio 容器工具"一文是一份非常棒的入门指南。

这是 .NET Core 3.1 的 Windows 容器 Dockerfile 示例

Windows Server 2019 .NET 6.0.

预配置的 Windows 容器包含运行 IronPDF 所需的所有依赖项。

请注意请注意，这些容器并非用于构建.NET应用程序，而是用于运行它们。

请访问 Docker 资源库，探索更多用于运行 IronPDF 的预配置镜像。

常见问题解答

如何将 .NET 库集成到 Docker 容器中生成 PDF？

您可以通过使用 Microsoft 的官方 Docker 镜像和 IronPDF.Linux NuGet 包（用于 Linux）或预配置的 Windows Docker 容器（用于 Windows 环境）将 IronPDF 这个 .NET PDF 生成库集成到 Docker 容器中。

在 Azure 上使用 Docker 容器进行 PDF 操作有什么好处？

在 Azure 上使用 Docker 容器进行 PDF 操作提供了增强的企业级可扩展性和比常规 WebApps 更多的权限。此设置非常适合启用高级功能，例如通过 GDI+ 图形访问渲染 SVG 字体。

哪些 Linux 发行版最适合在 Docker 中运行 .NET PDF 库？

最适合在 Docker 中运行 IronPDF 的 Linux 发行版包括 Ubuntu 18/20/22、Debian 10/11、CentOS 8 和 Amazon AWS Linux 2，因为它们提供简单的配置和兼容性。

如何优化 Linux Docker 容器中 .NET PDF 库的性能？

要优化性能，请使用 IronPdf.Linux 包，禁用自动依赖安装，并通过配置 IronPdf.Installation.ChromeGpuMode 为 IronPdf.Engines.Chrome.ChromeGpuModes.Disabled 关闭 GPU 加速。

IronPDF 可以在 Docker 容器内的 Alpine Linux 上运行吗？

由于 'musl' 库不兼容，IronPDF 不原生支持 Alpine Linux。要在 Alpine Linux 上使用 IronPDF，可以通过 IronPDFEngine Docker 容器运行它。

使用预配置的 Docker 容器运行 .NET 库的目的是什么？

预配置的 Docker 容器提供了运行 IronPDF 所需的所有依赖，以确保高性能和可扩展性，特别是在如 Azure 这样的平台上部署时。

如何为 .NET 应用程序在 Docker 中配置 .NET PDF 库？

您可以通过将 IronPDF 与 Linux 和 Windows Docker 容器集成，实现微服务架构中的强大 PDF 功能，来为 .NET 应用程序配置 IronPDF。

部署 .NET 库在 Docker 中的推荐设置步骤是什么？

推荐步骤包括使用诸如 IronPDF.Linux 的 Linux 优化包，禁用自动依赖安装，以及在 Docker 环境的运行时预初始化 IronPDF 以防止延迟。

我如何在运行 .NET 6.0 的 Windows Server 2019 Docker 容器中设置 .NET PDF 库？

通过使用包含所有必要依赖和配置来运行 IronPDF 的预配置 Dockerfile，在 Windows Server 2019 Docker 容器中设置 .NET PDF 库与 .NET 6.0。

为什么在 Docker 设置中对于 .NET 库要禁用 GPU 加速？

禁用 Docker 中 IronPDF 的 GPU 加速可以通过避免在资源有限的 GPU 环境中可能发生的图形相关问题来实现更流畅的部署和性能。