既存のDockerコンテナへのIronPDFの追加

Linux 向けに最適化された NuGet パッケージを使用する

ディスク容量を節約し、Dockerインスタンスの起動時にアセットがダウンロードされるのを防ぐため、通常のIronPDFパッケージではなく、IronPdf.Linux NuGetパッケージの使用をお勧めします。 ご安心ください。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;

' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False

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;

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

Ubuntu 24 with .NET 10

Ubuntu 24.04 (Noble) では 64 ビットの time_t 移行パッケージが使用されているため、一部のライブラリ名は以前の Ubuntu バージョンとは異なります（例：libasound2 の代わりに libasound2t64）。

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:10.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:10.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

Ubuntu 24 with .NET 8

.NET 8 LTS と Ubuntu 24.04 LTS の組み合わせは、一般的な本番環境構成です。 64ビット移行ライブラリの名称は、これらと同じものを使用します。

# Build stage
FROM mcr.microsoft.com/dotnet/sdk:8.0-noble AS build
WORKDIR /app
COPY *.csproj .
RUN dotnet restore
COPY . .
RUN dotnet publish -c Release -o /app/publish

# Runtime stage
FROM mcr.microsoft.com/dotnet/aspnet:8.0-noble AS runtime

# Install IronPDF dependencies for Ubuntu 24.04 Noble (64-bit transition libraries)
RUN apt-get update && apt-get install -y \
    libasound2t64 \
    libatk1.0-0t64 \
    libatk-bridge2.0-0t64 \
    libcairo2 \
    libcups2t64 \
    libdbus-1-3 \
    libdrm2 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libglib2.0-0t64 \
    libgtk-3-0t64 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libx11-6 \
    libxcb1 \
    libxcomposite1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxkbcommon0 \
    libxrandr2 \
    fonts-liberation \
    wget \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "YourApp.dll"]

Ubuntu 22 with .NET 8

Ubuntu 22 with .NET 7

Ubuntu 20 with .NET 6

Ubuntu 20 with .NET 5

Ubuntu 20 with .NET 3.1 LTS

Ubuntu 18 with .NET 3.1 LTS

Debian 12 with .NET 8

Debian 11 with .NET 7

Debian 11 with .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

.NET 6 での Alpine Docker と IronPdfEngine の使用

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

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

# 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

Windows Server 2019 .NET 6.0

事前構成済みの Windows コンテナには、IronPDF を実行するために必要なすべての依存関係が含まれています。

IronPDF を実行するための追加の事前構成済みイメージについては、Docker リポジトリをご覧ください。