Use IronPDF in the engine mode
NativeとEngineの違い
IronPDFには、リモートで実行することを選択できる、処理負荷の高い機能がいくつかあります。 IronPDFはIronPdfEngineなしでも動作しますが、IronPdfEngineをリモートサービスとして設定することは、古いオペレーティングシステムやモバイル環境におけるChromeのプラットフォーム固有の互換性問題を回避するためのオプションの方法です。
IronPDF を始める
今日あなたのプロジェクトでIronPDFを無料トライアルで使用開始。
Engineの利用が、IronPDFを用いたコーディングの在り方をどう変えるか
Engine構成を使用する場合、NuGetからIronPdf.Slimをインストールすることを推奨します。これは、Nativeパッケージに含まれる余分なデータはすべてEngineによって管理されるためです。
Install-Package IronPdf.Slim
IronPdf.Slim をインストールした後、IronPDF を IronPdfEngine インスタンスに指定して接続設定を行ってください。 アプリケーションの起動時(またはIronPDFメソッドを呼び出す前)に、以下のコードを追加してください:
C#コードに追加する設定コードの1行
IronPdfEngineが123.456.7.8:33350でリモート実行されていると仮定して:
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.Co/nnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Additional code for your application
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.Co/nnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Additional code for your application
' Establish a connection with the remote IronPdfEngine
' Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)
' Additional code for your application
IronPdfEngineはどのように機能しますか?
IronPdfEngineは、PDFの作成、書き込み、編集、読み取りなど、さまざまなIronPDF操作をgRPCプロトコルを使用して管理するために設計されたコンテナ化サーバーです。 IronPdfEngineは、独立したC# .NETアプリケーションとして構築されており、実行時に.NETランタイムを必要とせずに動作します。 gRPC接続は当社が代行しますので、お客様はコーディングに集中していただけます!
IronPDFを独自のコンテナとして実行するためのクイックスタートチュートリアルについては、こちらのチュートリアルを参照してください。 この Docker コンテナは、ポート、ロギング、Chrome の制限などに関する 16 のランタイム設定パラメータをサポートしています。詳細については、パラメータリファレンスを参照してください。
IronPdfEngineをリモートサーバーとして使用する方法
- IronPdfEngineを利用するには、C#ライブラリをインストールしてください
- NuGet から IronPdf.Slim パッケージをインストールしてください
- IronPdfConnectionConfiguration クラスを使用して、接続設定を構成します
- IronPdfEngine を使用すると、Chrome と同一のレンダラーで HTML を PDF に変換できます
IronPdfEngineに関するその他の補足事項
IronPDF .NETは、IronPdfEngineを必要とせずに動作します。 IronPdfEngineは、IronPDFを利用するオプションの手段の一つに過ぎません。 デフォルトでは、IronPDF for .NET は IronPdfEngine を使用しません。
IronPDF .NET with Remote IronPdfEngine
IronPdf.Slim NuGet パッケージは、Remote IronPdfEngine を使用して IronPDF for .NET を利用する際に必要な唯一のパッケージです。
IronPdf.slimを使用することもできます。
IronPdfEngineが123.456.7.8:33350でリモート実行されていると仮定します。
NuGet を使用して IronPDF をインストールします:
Install-Package IronPdf.Slim
IronPdf.slimをインストールした後、IronPDFにIronPdfEngineの場所を指定するだけで済みます(そのアドレスがアクセス可能であり、ファイアウォールによってブロックされていないことを確認してください)。 接続設定を行うには、IronPdfConnectionConfiguration クラスを使用してください。 以下のコードを、アプリケーションの初期段階(またはIronPDFメソッドを呼び出す直前)に追加してください。
// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Connect to the remote IronPdfEngine
Installation.Co/nnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
以上です! これで、アプリケーションがリモート IronPdfEngine に接続されます!
IronPdfEngine の制限事項
- 現在、IronPdfEngine自体は水平スケーリング(複数のエンジンインスタンス間での負荷分散)をサポートしていません。これは、エンジンが処理中のPDFバイナリをサーバーのメモリに保持し、PdfDocumentIdを使用してサーバーとクライアント間の連携を行っているためです。 この設計により、帯域幅の使用量が最小限に抑えられ、処理速度が向上します。 なお、この制限はIronPdfEngineサービスにのみ適用されます。IronPDFライブラリを使用するアプリケーション(IronPdfEngineの有無にかかわらず)は、複数のアプリケーションインスタンスを展開することで、引き続き水平スケーリングが可能です。
- IronPdfEngine Dockerをリモートで実行するには、IronPdfEngineのポートにアクセスできることを確認する必要があります。
- Linux x64 (Debian) 上で、公式の ubuntu:22.04 ベースのイメージを使用して IronPdfEngine Docker を実行した場合、OS の動作の違いにより、IronPDF をローカルで実行した際とは若干異なる PDF が出力される可能性があります。
- IronPdfEngine DockerはLinuxベースであるため、Linuxコンテナデーモンが必要です(Windowsを使用している場合は
Switch to Linux Containersを選択してください)。 - IronPdfEngineのバイナリはクロスプラットフォームではないため、各プラットフォーム向けに個別にビルドしています。
- 異なるバージョン間の互換性はサポートされていません。
よくある質問
リモートPDF生成のためにIronPDFEngineをどのようにセットアップできますか?
リモートPDF生成のためにIronPDFEngineをセットアップするには、NuGetからIronPdf.Slimパッケージをインストールし、IronPDFConnectionConfigurationクラスを使用して接続設定を構成します。このセットアップにより、アプリケーションをIronPDFEngineインスタンスにリモートで接続できます。
アプリケーションでIronPDFEngineを使用する主な利点は何ですか?
アプリケーションでIronPDFEngineを使用すると、PDFタスクをリモートで実行することができ、特に古いシステムやモバイルプラットフォームでのプラットフォーム固有の互換性の問題を回避できます。また、実行中に.NETランタイムを必要としません。
ネイティブのPDFライブラリの代わりにIronPDFEngineを利用する理由は何ですか?
パフォーマンス集約型のPDF機能をリモートで実行し、異なるオペレーティングシステムとの互換性の問題を軽減し、HTMLからPDFへの変換にChromeと同一のレンダラを利用することで性能を向上させるためにIronPDFEngineを選ぶかもしれません。
IronPDFEngineで水平方向のスケーリングはサポートされていますか?
いいえ、現在IronPDFEngineは水平方向のスケーリングをサポートしておらず、サーバーメモリ内でのPDFファイルバイナリの取り扱い方法のため、複数のインスタンス間で負荷分散することはできません。
IronPDFEngineは異なるオペレーティングシステムで動作できますか?
IronPDFEngineはDockerコンテナを使用してLinuxシステムで動作するように設計されています。ただし、バイナリはプラットフォーム固有であるため、使用するオペレーティングシステムに適したバージョンを使用する必要があります。
IronPDFEngineを使用しているときにPDFの出力が異なる場合、どうすればよいですか?
異なるオペレーティングシステムの動作によりPDFの出力がわずかに異なることがあります。差異を最小限に抑えるために、正しいDockerイメージを使用し、レンダリングに影響を与える可能性のあるOS特定の設定を確認してください。
アプリケーションがIronPDFEngineの正しいバージョンを使用していることをどうやって確認できますか?
互換性を確保するため、各バージョンのIronPDFには対応するバージョンのIronPDFEngineが必要です。クロスバージョンの問題を避けるために、両方のコンポーネントを同時に更新してください。
WindowsでIronPDFEngineを使用する際の制限は何ですか?
WindowsでIronPDFEngineを使用する場合、DockerのLinuxコンテナが必要であり、サーバーポートが到達可能であることを確認する必要があります。バイナリはプラットフォーム固有であり、Linuxコンテナへの切り替えが必要です。
リモートIronPDFEngineサーバーに接続するようにIronPDFを構成するにはどうすればよいですか?
リモートサーバー用にIronPDFを構成するには、Installation.ConnectToIronPDFHostをIronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServerメソッドと共に使用し、サーバーのIPとポートの詳細を指定します。
IronPDFEngineを使用する際にアプリケーションのサイズを最小化するためにはどのパッケージを使用すればよいですか?
アプリケーションサイズを削減するためにIronPDFをIronPDFEngineで実行するのに必要なコンポーネントのみを含むIronPdf.SlimパッケージをNuGetから使用するべきです。

