LinuxでIronPdfを使う

公式にサポートされているLinuxディストリビューション

最新の64ビット Linux OSを以下に示し、IronPDFの"ゼロ設定"セットアップのために公式サポートおよび推奨しています。

• Ubuntu 22
• Ubuntu 20
• Ubuntu 18
• Ubuntu 16
• Debian 11
• Debian 10
• CentOS 8
• Fedora Linux 33
• Amazon AWS Linux 2

サポートされていないLinuxバージョンにIronPDFをインストールする場合、このドキュメントの末尾にあるLinux共通依存パターンをご覧ください。

Linux自動セットアップ

デフォルト設定LinuxAndDockerDependenciesAutoConfigをtrueに設定すると、IronPDFをLinuxで実行するためのすべての依存関係を自動的にインストールしようとします。 最初のHTMLからPDFへの操作は通常よりも時間がかかる場合があります。

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

' Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

Ubuntu 20

Ubuntu 20を_ゼロ設定_でサポートしています。

• ChromeおよびWebKitベースのHTMLからPDFへのレンダリングエンジンをサポート
• 公式に.NET Core 3.1, 5, 6 (LTS), 7, および8のランタイムをサポート
• Ubuntu 20上で他の多くの.NET Coreランタイムを非公式にサポート
• すべてのリリース前にこのプラットフォームで997以上のユニットテストを行う

公式Microsoft Dockerイメージ:

• 64-bit Ubuntu 20.04 Docker Image for .NET Runtime 3.1 ('3.1-focal')
• 64-bit Ubuntu 20.04 Docker Image for .NET Runtime 5.0 ('5.0-focal')

手動Ubuntu 20セットアップ

手動インストールが必要な場合またはアプリを_sudo_管理者特権で実行できない場合、 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfigプロパティをfalseに設定し、依存関係を手動でインストールします。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Ubuntu 18

Ubuntu 18を_ゼロ設定_でサポートしています。

• ChromeおよびWebKitベースのHTMLからPDFへのレンダリングエンジンをサポート
• .NET Core 3.1 LTSおよび.NET 5ランタイムの公式サポート
• Ubuntu 18および16上で他の多くの.NET Coreランタイムを非公式にサポート
• すべてのリリース前にこのプラットフォームで包括的なスモークテストを行う

公式Microsoft Dockerイメージ:

• 64-bit Ubuntu 18.04 Docker Image for .NET Runtime 3.1 ('3.1-bionic')
• Ubuntu 18では.NET 5の公式dockerイメージはありませんが、互換性は非常に高いです。

手動Ubuntu 18セットアップ

手動インストールが必要な場合またはアプリを_sudo_管理者特権で実行できない場合、 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfigプロパティをfalseに設定し、依存関係を手動でインストールします。

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Ubuntu 16

Ubuntu 16のサポートは限定的です。Ubuntu 16での.NETはMicrosoftによって正式にサポートされており、多くのユーザーからIronPdfで動作する報告があります。 開発者は追加の依存関係を手動でインストールする必要があるかもしれません。

• ChromeとWebKitは通常手動設定で動作します。
• .NET Core 3.1 LTSおよび.NET 5ランタイムがUbuntu 16に対するMicrosoftのサポートを受けています。
• 現在、Ubuntu 16に対する公式のMicrosoft Dockerイメージは存在しません。

手動Ubuntu 16セットアップ

手動インストールが必要な場合またはアプリを_sudo_管理者特権で実行できない場合、 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfigプロパティをfalseに設定し、依存関係を手動でインストールします。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Debian 11

Debian 11を_ゼロ設定_でサポートしています。

• ChromeおよびWebKitベースのHTMLからPDFへのレンダリングエンジンをサポート
• 公式に.NET Core 3.1, 5, 6 (LTS), 7, および8のランタイムをサポート
• Debian 11で他の多くの.NET Coreランタイムを非公式にサポート
• すべてのリリース前にこのプラットフォームで997以上のユニットテストを行う

公式Microsoft Dockerイメージ:

• 64-bit Debian 11 Docker Image for .NET Runtime 3.1
• 64-bit Debian 11 Docker Image for .NET Runtime 5.0

手動Debian 11セットアップ

手動インストールが必要な場合またはアプリを_sudo_管理者特権で実行できない場合、 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfigプロパティをfalseに設定し、依存関係を手動でインストールします。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Debian 10

Debian 10を_ゼロ設定_でサポートしています。

• ChromeおよびWebKitベースのHTMLからPDFへのレンダリングエンジンをサポート
• 公式に.NET Core 3.1, 5, 6 (LTS), 7, および8のランタイムをサポート
• Debian 10で他の多くの.NET Coreランタイムを非公式にサポート
• すべてのリリース前にこのプラットフォームで997以上のユニットテストを行う

公式Microsoft Dockerイメージ:

• 64-bit Debian 10 Docker Image for .NET Runtime 3.1
• 64-bit Debian 10 Docker Image for .NET Runtime 5.0

手動Debian 10セットアップ

手動インストールが必要な場合またはアプリを_sudo_管理者特権で実行できない場合、 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfigプロパティをfalseに設定し、依存関係を手動でインストールします。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Debian 9およびそれ以下

Debian 9は公式にはテストされておらず、IronPdfではすぐに動作しないでしょう。 しかし、Debian 9上の.NETはMicrosoftによって公式にサポートされており、適切に設定すればIronPdfと連携することができます。 このドキュメントの末尾にあるLinux共通依存パターンを参照してください。

Debian 9に対して、Microsoftによる公式のDockerイメージは.NET Core 3.1または.NET 5.0用には存在しません。Debian 10への移行を強くお勧めします。

CentOS 8サポート

CentOS 8を_ゼロ設定_でサポートしています。

• ChromeおよびWebKitベースのHTMLからPDFへのレンダリングエンジンをサポート
• 公式に.NET Core 3.1, 5, 6 (LTS), 7, および8のランタイムをサポート
• CentOS上で他の多くの.NET Coreランタイムを非公式にサポート
• すべてのリリース前にこのプラットフォームで包括的なスモークテストを行う

残念ながら、CentOS 8上の.NET Core 3.1または.NET 5.0のための公式のMicrosoft Dockerイメージは存在しません。

手動CentOS 8セットアップ

手動インストールが必要な場合や、アプリが_sudo_管理者権限で実行できない場合:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;を設定してください。

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

CentOS 7およびそれ以下

CentOS 7はテストされておらず、IronPdfではすぐに動作しません。

しかし、CentOS 7上の.NETはMicrosoftによって公式にサポートされており、適切に設定すればIronPdfと連携することができます。 以下のLinux共通依存パターンをお読みください。

CentOS 7上で.NET Core 3.1または.NET 5.0のための公式のMicrosoft Dockerイメージは存在しません。

.NET 6でのIronPdfEngineを用いたAlpine Dockerの使用

IronPdfはすべてのIronPdf機能を含むコンテナイメージを提供します。 これにより、Alpineで実行されているプロジェクトがIronPdf機能にアクセスできるようになり、IronPdfEngineコンテナに接続します。

ステップ1: IronPdfエンジンドッカーイメージをプルして実行する

以下のコマンドをターミナルで実行して、IronPdfエンジンドッカーイメージをプルして実行します。

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

ステップ2: コンソールアプリのセットアップ

• .NET 6を対象とした新しいコンソールアプリケーションを作成します。
• NuGetパッケージマネージャを使用してIronPdf.Slim NuGetパッケージをインストールします。

IronPdfEngineの使用方法についてもっと学びましょう。

Linux共通依存パターン

他のLinux OSのための依存パッケージを参照してください。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

依存関係の欠如を特定する

lddは欠落している依存関係を診断するための強力なツールです。 ldd IronInterop.soを実行することで、アプリケーションが必要とするすべての共有ライブラリのリストを見ることができます。 ライブラリの横にある"not found"メッセージ（例: libcef.so => not found）は、プログラムの正常な実行を妨げる重大な依存関係の欠如を示します。 IronInterop.soファイルは特定のOSのネイティブフォルダにあります。 例えば、bin/Debug/net6.0/runtimes/linux-x64/nativeなど。

ldd IronInterop.so

ldd IronInterop.so

IronCefSubprocess

IronCefSubprocessはアプリケーションのbinフォルダ内のバイナリファイルです。 .NETプロセスによって実行可能である必要があります。

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess