LinuxでIronPdf.Linuxを動かす：セットアップガイド

更新日:6月 1, 2025

Translated

View the article in English

Linux用のIronPdfは約280MBです（IronPdfのコードとChromeブラウザ全体を含む）。 Dockerイメージは約500MBです。

Chromeには、Linuxディストリビューションに応じて異なる基本的なパッケージが必要です。多くのLinuxディストリビューションはすでにこれらのパッケージがインストールされています。これらはさまざまなアプリケーションやライブラリで使用されるためです。

しかし、最低限のディストリビューションを使用している場合は、ChromeをLinux上で動作させるために必要なLinuxパッケージをインストールする必要があります。

注: デバッグを容易にするため、次の設定をすることができます。

// Enable detailed debugging for IronPdf
IronPdf.Logging.Logger.EnableDebugging = true;

// Specify the log file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to capture all log data
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

// Enable detailed debugging for IronPdf
IronPdf.Logging.Logger.EnableDebugging = true;

// Specify the log file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to capture all log data
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

' Enable detailed debugging for IronPdf
IronPdf.Logging.Logger.EnableDebugging = True

' Specify the log file path
IronPdf.Logging.Logger.LogFilePath = "Default.log"

' Set the logging mode to capture all log data
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All

$vbLabelText $csharpLabel

小型のDockerイメージを作成する方法

1. 実行時にパッケージをインストールする

サイズを削減する方法の1つは、dockerイメージを構築する際ではなく、実行時にapt-getコマンドを実行することです。

Dockerfileからapt-getコマンドを削除します。
IronPdfを初期化するか、ドキュメントをレンダリングする前にInstallation.LinuxAndDockerDependenciesAutoConfig = true;を設定します。
アプリケーションがapt-getコマンドを実行するのに十分な権限で実行されるようにします。

注: 最初の初期化時には、apt-getコマンドが最初のドキュメントをレンダリングする前に完了しなければならないため、初期化が遅くなります。このプロセスは、イメージを再デプロイするたびに繰り返されます。

注: コンソール/ログに、パッケージのインストールが正常に完了したことを示すエントリが表示されるはずです。

Executing command 'apt install -y libnss3' in '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Reading package lists...
Building dependency tree...
Reading state information...
The following additional packages will be installed:
  libnspr4
The following NEW packages will be installed:
  libnspr4 libnss3
0 upgraded, 2 newly installed, 0 to remove and 9 not upgraded.

Executing command 'apt install -y libnss3' in '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Reading package lists...
Building dependency tree...
Reading state information...
The following additional packages will be installed:
  libnspr4
The following NEW packages will be installed:
  libnspr4 libnss3
0 upgraded, 2 newly installed, 0 to remove and 9 not upgraded.

SHELL

2. IronPdf.Slimを使用

また、IronPdf.dllのみを含め、必要なファイルを実行時にダウンロードすることも選択できます。

プロジェクトからIronPdf.Linux（およびその他のIronPdf）NuGetパッケージを削除し、IronPdf.Slimを追加します。
IronPdfを初期化するかドキュメントをレンダリングする前にInstallation.AutomaticallyDownloadNativeBinaries = true;を設定します。
Dockerfileがアプリケーションの作業ディレクトリ全体に読み書き権限を付与するようにします（例: RUN chmod +rwx /app/runtimes/linux-x64/native/IronCefSubprocess を RUN chmod +rwx /app/ に変更します）。

注: 最初の初期化時には、NuGetパッケージのダウンロードと展開が最初のドキュメントをレンダリングする前に行われるため遅くなります。このプロセスは、イメージを再デプロイするたびに繰り返されます。

注: コンソール/ログに、ダウンロードと展開が正常に完了したことを示すエントリが表示されるはずです。

Downloading NuGet package from 'https://www.nuget.org/api/v2/package/IronPdf.Native.Chrome.Linux/2023.1.11387'
Extracting package contents '/app/bin/Debug/netcoreapp3.1/IronPdf.Native.Chrome.Linux.2023.1.11387.nupkg/runtimes/linux-x64/native' to '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Successfully deployed NuGet package 'IronPdf.Native.Chrome.Linux' to '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Successfully located 'IronInterop' at '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'

Downloading NuGet package from 'https://www.nuget.org/api/v2/package/IronPdf.Native.Chrome.Linux/2023.1.11387'
Extracting package contents '/app/bin/Debug/netcoreapp3.1/IronPdf.Native.Chrome.Linux.2023.1.11387.nupkg/runtimes/linux-x64/native' to '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Successfully deployed NuGet package 'IronPdf.Native.Chrome.Linux' to '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Successfully located 'IronInterop' at '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'

SHELL

3. 結論

_初期コンテナサイズを削減する_ための要約:

IronPdf.Slim NuGetパッケージを使用します。
IronPdfを設定します:

// Set installation options for Linux and Docker environments
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.AutomaticallyDownloadNativeBinaries = true;

// Set installation options for Linux and Docker environments
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.AutomaticallyDownloadNativeBinaries = true;

' Set installation options for Linux and Docker environments
Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.AutomaticallyDownloadNativeBinaries = True

$vbLabelText $csharpLabel

アプリケーションディレクトリが書き込み可能/実行可能であることを確認します:

RUN chmod +rwx /app/

1と2の両方のポイントを利用する非常にスリムなDockerイメージは、サイズを約500MBから約200MBに削減するはずです。

可能であれば、スリムなデプロイメントを選ばない場合に最高のパフォーマンスが得られることを知っておいてください。

一部のコンテナ化されたクラウド環境は 永続的ではなく、依存関係の再ダウンロードや apt-get コマンドの再実行が必要になる場合があります。これには最大で数分かかることがあります！

しかし、開発者の中にはデプロイメントのサイズに厳しい要件がある場合も理解しています。

カーティス・チャウ

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？

Nuget ダウンロード 16,685,821 | バージョン: 2025.12 リリース

ライセンスを見る