1. IronPDF
2. 操作指南
3. Docker容器（Linux、Windows以及Azure）

向现有的 Docker 容器中添加 IronPDF

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

您想将IronPDF部署为单独的Docker容器吗？ 了解更多关于IronPDF 引擎教程指南.

为什么在Azure上使用Docker？

除了出色的企业可扩展性外，Azure 上的 Docker 容器比常规 WebApps 拥有更多权限。

这样就可以渲染 SVG 字体，因为系统访问 GDI+ 图形的功能已启用。

IronPDF 和 Linux 入门

如果 Docker 与 .NET 对您来说是新的，我们推荐这篇优秀的文章关于设置 Docker 调试并与 Visual Studio 项目集成.

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

推荐的Linux Docker发行版

我们推荐以下最新的64位Linux操作系统，以便于配置IronPDF。

Ubuntu 22

• 乌班图 20

  Ubuntu 18

  Debian 11

  Debian 10[目前 Microsoft Azure 默认 Linux 发行版]_

• CentOS 8

  Amazon AWS Linux 2阅读《IronPDF AWS Lambda 设置指南

  我们建议使用Microsoft的.NET 的官方 Docker 映像 . 其他 Linux 发行版部分支持，但可能需要使用 apt-get 手动配置。 请参阅我们的“Linux 手动设置“指南”

  本文档包含 Ubuntu 和 Debian 的 Docker 工作文件：

IronPDF Linux Docker 安装要点

使用针对Linux优化的NuGet包

我们建议使用IronPdf.LinuxNuGet 软件包，而不是常规的IronPdf将包裹保存磁盘空间并避免在启动您的Docker实例时下载资产。 不用担心，即使在Windows或macOS上开发，它依然有效——它只是针对Linux进行了优化。

Install-Package IronPdf.Linux

另一种解决方案是简单地添加IronPdf.Native.Chrome.Linux在常规翻译的基础上IronPdfNuGet 软件包。

Install-Package IronPdf.Native.Chrome.Linux

避免自动安装依赖

许多用户报告说，当LinuxAndDockerDependenciesAutoConfig设置为false时，Linux和Docker的结果更佳。 这是因为所需的先决条件已经通过apt-get样式的包管理器安装在您的Docker文件中了。

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

禁用 GPU 加速

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

IronPdf.Installation.ChromeGpuMode=IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

“提前”初始化

您也可以选择调用 IronPdf.Installation.Initialize()手动启动 IronPDF 的方法。 首次使用 Docker 实例运行 IronPDF 时，下载先决条件可能需要一些时间。 我们可以通过在创建实例时调用这段代码来避免这种情况：

IronPdf.Installation.Initialize();

Ubuntu Linux DockerFiles

Ubuntu 22 与 .NET 8

请将用户从'app'更改为'root'。 这将确保库获得足够的权限。 通过这一改变，将不需要为IronCefSubprocess设置'rwx'。

Ubuntu 22 与 .NET 7

Ubuntu 20 与 .NET 6

Ubuntu 20 与 .NET 5

配备 .NET 3.1 LTS 的 Ubuntu 20

Ubuntu 18 与 .NET 3.1 LTS

Debian Linux DockerFiles

Debian 12 与 .NET 8

Debian 11 与 .NET 7

配备 .NET 6 的 Debian 11

配备 .NET 5 的 Debian 11

配备 .NET 3.1 LTS 的 Debian 11

Debian 10 与 .NET 5

配备 .NET 3.1 LTS 的 Debian 10

Alpine Linux Docker文件

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

在 .NET 6 中使用 Alpine Docker 和 IronPdfEngine

IronPdf提供一个包含所有IronPdf功能的容器映像。 这使得在 Alpine 上运行的项目能够通过连接 IronPdfEngine 容器访问 IronPdf 功能。

步骤1：拉取并运行 IronPdf Engine Docker 镜像

在终端执行以下命令以拉取并运行 IronPdf Engine Docker 镜像：

docker pull ironsoftwareofficial/ironpdfengine

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

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

创建一个针对 .NET 6 的新控制台应用程序。

使用 NuGet 包管理器安装 IronPdf.Slim NuGet 包。

IronPDF Windows Docker 容器

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

IronPDF将在Docker容器内实现更吸引人的文本渲染。(Windows 或 Linux)在Azure上，因为可以更高级别地访问图形库和虚拟图形卡。

文章 '适用于 Docker 的 Visual Studio 容器工具'是一个非常好的入门指南。

这是一个用于 .NET Core 3.1 的示例 Windows 容器 Dockerfile。

Windows Server 2019 .NET 6.0

预配置的 Windows 容器，包括运行 IronPdf 所需的所有必要依赖项。

FROM mcr.microsoft.com/dotnet/sdk:6.0-windowsservercore-ltsc2019 AS build
WORKDIR /src
COPY ["nuget.config", "."]
COPY ["ConsoleApp/ConsoleApp.csproj", "ConsoleApp/"]
RUN dotnet restore "ConsoleApp/ConsoleApp.csproj"
COPY . .
WORKDIR "/src/ConsoleApp"
RUN dotnet build "ConsoleApp.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "ConsoleApp.csproj" -c Release -o /app/publish /p:UseAppHost=false

FROM ironsoftwareofficial/windows:2019-net60
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "ConsoleApp.dll"]

访问IronSoftware 在 Docker Hub 上的 Docker 存储库探索更多用于运行 IronPdf 的预配置镜像。