기존 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에서 더 나은 결과를 얻는다고 보고합니다. 이는 apt-get 스타일의 패키지 관리자가 Docker 파일 내에 필수 구성 요소를 이미 설치해 두었기 때문입니다.

// 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 버전과 다릅니다(예: libasound2t64 대신 libasound2).

# 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"]

.NET 8이 포함된 Ubuntu 22

.NET 7이 포함된 Ubuntu 22

Ubuntu 20 with .NET 6

Ubuntu 20 with .NET 5

Ubuntu 20 with .NET 3.1 LTS

.NET 3.1 LTS가 설치된 Ubuntu 18

.NET 8이 포함된 Debian 12

.NET 7이 포함된 Debian 11

.NET 6이 포함된 Debian 11

.NET 5가 포함된 Debian 11

.NET 3.1 LTS가 포함된 Debian 11

.NET 5가 포함된 Debian 10

.NET 3.1 LTS가 포함된 Debian 10

.NET 6에서 IronPdfEngine과 함께 Alpine Docker 사용하기

# 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 실행에 필요한 모든 종속성이 포함되어 있습니다.

Docker 저장소를 방문하여 IronPDF 실행을 위한 추가 사전 구성된 이미지를 확인해 보세요.