比較

Gotenberg vs IronPDF：技術比較ガイド

更新日:

.NET開発者がPDF生成ソリューションを評価するとき、GotenbergはREST API呼び出しを通じてHTMLをPDFに変換するDockerベースのマイクロサービスとして際立っています。 Gotenbergは多様なアーキテクチャに適応可能ですが、インフラストラクチャーのオーバーヘッド（Dockerコンテナ、ネットワークレイテンシー、運用の複雑さ）が発生します。 IronPDFは、コンテナ、ネットワークコール、インフラストラクチャ管理なしで同じChromiumベースのレンダリングを提供するプロセス内のNuGetパッケージという代替手段を提供します。

この比較では、プロの開発者やアーキテクトが.NET PDFのニーズに対して十分な情報を得た上で意思決定できるように、技術的に関連する次元で両ソリューションを比較します。

Gotenbergを理解する

Gotenbergは、PDF生成のためのDockerベースのマイクロサービスアーキテクチャです。 HTML、URL、その他のフォーマットをPDFに変換するためのREST APIエンドポイントを公開する別のコンテナとして動作します。 すべてのPDF操作は、GotenbergサービスへのHTTPコールを必要とします。

Gotenberg は、HTML から PDF への変換には POST /forms/chromium/convert/html のようなエンドポイントを使用し、URL から PDF への変換には POST /forms/chromium/convert/url のようなエンドポイントを使用します。 構成は、marginTop、および marginBottom (インチ単位) などの文字列ベースのパラメータを使用して、multipart/form-data 経由で渡されます。 このサービスには、Dockerのデプロイ、コンテナのオーケストレーション（Kubernetes/Docker Compose）、ネットワークインフラが必要です。

アーキテクチャ

  • Dockerコンテナのデプロイと管理
  • PDFリクエストごとにネットワーク通信（10-100ms以上のレイテンシ）
  • コンテナのコールドスタート処理（最初のリクエストは2～5秒）
  • ヘルスチェックエンドポイントとサービスモニタリング
  • すべてのリクエストに対するMultipart/form-dataの構築

IronPDFの理解

IronPdfはNuGetパッケージとしてインプロセスで動作する.NETネイティブライブラリです。 ChromiumベースのHTMLレンダリングを提供し、外部サービス、ネットワークコール、コンテナインフラストラクチャを必要としません。

IronPDF は、RenderHtmlAsPdf() や RenderUrlAsPdf() などのメソッドを持つ ChromePdfRenderer を主なレンダリング クラスとして使用します。 構成では、MarginBottom (ミリメートル単位) を含む RenderingOptions の型指定された C# プロパティを使用します。 ドキュメントは SaveAs() で保存されるか、BinaryData としてアクセスされます。

ライブラリに必要なのは

  • NuGetパッケージのインストール (dotnet add package IronPdf)
  • ライセンスキー設定
  • .NET プロジェクトの標準セットアップ

アーキテクチャとインフラストラクチャの比較

これらのソリューションの基本的な違いは、デプロイとランタイムのアーキテクチャにあります。

ファクターGotenbergIronPDF
デプロイメントDockerコンテナ＋オーケストレーション単一のNuGetパッケージ
アーキテクチャマイクロサービス（REST API）インプロセスライブラリ
リクエストあたりのレイテンシ10-100ms以上（ネットワーク・ラウンドトリップ）<1msのオーバーヘッド
コールドスタート。2～5秒（コンテナinit）1～2秒（最初のレンダリングのみ）
インフラストラクチャDocker、Kubernetes、ロードバランサー不要
ネットワーク依存性。必須なし
失敗モードネットワーク、コンテナ、サービス障害.NET Standardの例外
APIスタイル。REST multipart/form-dataC#ネイティブメソッドコール
スケーリング。水平方向（コンテナを増やす）垂直方向（進行中）
デバッグ。分散トレーシング標準デバッガ
メモリ管理。別コンテナ（512MB～2GB）共有アプリケーションメモリ
バージョン管理。コンテナ画像タグNuGetパッケージのバージョン
健康チェック。必要なHTTPエンドポイント不要（進行中）
CI/CDの複雑さ。コンテナのビルド、レジストリのプッシュ.NET Standardビルド

GotenbergのDockerベースのアプローチでは、コンテナのデプロイ、ヘルスモニタリング、ネットワークインフラ管理が必要です。 IronPdfはインプロセスで実行することにより、このインフラレイヤーを完全に排除します。

コードの比較：一般的なPDF操作

基本的なHTMLからPDFへの変換

最も基本的な操作は、アーキテクチャの違いを明確に示します。

Gotenberg:（英語

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergExample
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Hello from Gotenberg</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("output.pdf", pdfBytes);
        Console.WriteLine("PDF generated successfully");
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergExample
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Hello from Gotenberg</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("output.pdf", pdfBytes);
        Console.WriteLine("PDF generated successfully");
    }
}
$vbLabelText   $csharpLabel

IronPDF:

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var html = "<html><body><h1>Hello from IronPDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully");
    }
}
// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var html = "<html><body><h1>Hello from IronPDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully");
    }
}
$vbLabelText   $csharpLabel

Gotenberg では、HttpClient を作成し、MultipartFormDataContent を構築し、特定のファイル名 (index.html) を持つファイル添付ファイルとして HTML を追加し、Gotenberg サービス エンドポイントに非同期 HTTP POST を実行し、応答バイトを読み取って、ディスクに書き込む必要があります。 すべてのリクエストはネットワークを経由し、それに伴う遅延や障害モードが発生します。

IronPDF はChromePdfRenderer を作成し、HTML 文字列で RenderHtmlAsPdf() を呼び出し、SaveAs() で保存します。 操作は同期、インプロセスで、文字列ベースのフォームデータではなく、型付けされたメソッドを使用します。

高度なHTMLレンダリングオプションについては、HTMLからPDFへの変換ガイドをご覧ください。

URLからPDFへの変換

ライブのウェブページをPDFに変換すると、似たようなアーキテクチャパターンが見られます。

Gotenberg:(英語

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergUrlToPdf
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/url";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        content.Add(new StringContent("https://example.com"), "url");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("webpage.pdf", pdfBytes);
        Console.WriteLine("PDF from URL generated successfully");
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergUrlToPdf
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/url";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        content.Add(new StringContent("https://example.com"), "url");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("webpage.pdf", pdfBytes);
        Console.WriteLine("PDF from URL generated successfully");
    }
}
$vbLabelText   $csharpLabel

IronPDF:

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfUrlToPdf
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://example.com");

        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL generated successfully");
    }
}
// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfUrlToPdf
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://example.com");

        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL generated successfully");
    }
}
$vbLabelText   $csharpLabel

Gotenberg は、フォーム データとして渡された URL を持つ /forms/chromium/convert/url エンドポイントを使用します。IronPDFはURL 文字列で RenderUrlAsPdf() を直接呼び出します。これは、HTTP インフラストラクチャを置き換える単一のメソッド呼び出しです。

ページサイズと余白のカスタマイズ

コンフィギュレーション処理では、API設計の違いを明らかにします。

Gotenberg:(英語

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergCustomSize
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");
        content.Add(new StringContent("8.5"), "paperWidth");
        content.Add(new StringContent("11"), "paperHeight");
        content.Add(new StringContent("0.5"), "marginTop");
        content.Add(new StringContent("0.5"), "marginBottom");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("custom-size.pdf", pdfBytes);
        Console.WriteLine("Custom size PDF generated successfully");
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergCustomSize
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");
        content.Add(new StringContent("8.5"), "paperWidth");
        content.Add(new StringContent("11"), "paperHeight");
        content.Add(new StringContent("0.5"), "marginTop");
        content.Add(new StringContent("0.5"), "marginBottom");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("custom-size.pdf", pdfBytes);
        Console.WriteLine("Custom size PDF generated successfully");
    }
}
$vbLabelText   $csharpLabel

IronPDF:

// NuGet: Install-Package IronPdf
using System;
using IronPdf;
using IronPdf.Rendering;

class IronPdfCustomSize
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("custom-size.pdf");
        Console.WriteLine("Custom size PDF generated successfully");
    }
}
// NuGet: Install-Package IronPdf
using System;
using IronPdf;
using IronPdf.Rendering;

class IronPdfCustomSize
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("custom-size.pdf");
        Console.WriteLine("Custom size PDF generated successfully");
    }
}
$vbLabelText   $csharpLabel

Gotenberg は、マルチパート フォーム データに追加された文字列ベースのパラメータ ("0.5") を使用します。 用紙寸法はインチです。 各パラメータは、型チェックや IntelliSense サポートのない個別の Add() 呼び出しです。

IronPDF は、RenderingOptions で型指定されたプロパティを使用します。 PaperSize は列挙型 (PdfPaperSize.Letter) を受け入れ、余白はミリメートル単位の数値です。 型付きAPIは、コンパイル時のチェックとIDEのサポートを提供します。

レンダリングの設定については、IronPDFチュートリアルをご覧ください。

APIマッピングリファレンス

Gotenbergの移行を評価したり、機能を比較したりする開発者のために、このマッピングは同等の操作を示します：

エンドポイントからメソッドへのマッピング

御殿場ルートIronPDF 同等物
POST /forms/chromium/convert/htmlChromePdfRenderer.RenderHtmlAsPdf()
POST /forms/chromium/convert/urlChromePdfRenderer.RenderUrlAsPdf()
POST /forms/chromium/convert/markdown最初にMarkdownをHTMLとしてレンダリング
POST /forms/pdfengines/mergePdfDocument.Merge()
POST /forms/pdfengines/metadata/readpdf.MetaData
POST /forms/pdfengines/metadata/writepdf.MetaData.Author = "..."
GET /health該当なし

フォーム パラメータと RenderingOptions のマッピング

Gotenberg パラメータIronPDF プロパティ変換に関する注意事項
paperWidth (インチ)RenderingOptions.SetCustomPaperSizeInInches()カスタム
paperHeight (インチ)RenderingOptions.SetCustomPaperSizeInInches()カスタム
marginTop (インチ)RenderingOptions.MarginTopmmは25.4倍
marginBottom (インチ)RenderingOptions.MarginBottommmは25.4倍
marginLeft (インチ)RenderingOptions.MarginLeftmmは25.4倍
marginRight (インチ)RenderingOptions.MarginRightmmは25.4倍
printBackgroundRenderingOptions.PrintHtmlBackgroundsブーリアン
landscapeRenderingOptions.PaperOrientationLandscape 列挙型
scaleRenderingOptions.Zoomパーセンテージ(100 = 1.0)
waitDelayRenderingOptions.RenderDelayミリ秒への変換
emulatedMediaTypeRenderingOptions.CssMediaTypeScreen または Print

単位変換に注意してください。Gotenberg では余白にインチ (例: "0.5" = 0.5 インチ = 12.7 mm) を使用しますが、 IronPDFではミリメートルを使用します。

インフラストラクチャの比較

ゴテンバーグDocker Compose

Gotenberg はコンテナ・インフラを必要とします：

#Gotenbergrequires container management
version: '3.8'
services:
  app:
    depends_on:
      - gotenberg
    environment:
      - GOTENBERG_URL=http://gotenberg:3000

  gotenberg:
    image: gotenberg/gotenberg:8
    ports:
      - "3000:3000"
    deploy:
      resources:
        limits:
          memory: 2G
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 30s
#Gotenbergrequires container management
version: '3.8'
services:
  app:
    depends_on:
      - gotenberg
    environment:
      - GOTENBERG_URL=http://gotenberg:3000

  gotenberg:
    image: gotenberg/gotenberg:8
    ports:
      - "3000:3000"
    deploy:
      resources:
        limits:
          memory: 2G
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 30s
YAML

IronPDFの設定

IronPDFは追加サービスを必要としません：

#IronPDF- No additional services needed
version: '3.8'
services:
  app:
    environment:
      - IRONPDF_LICENSE_KEY=${IRONPDF_LICENSE_KEY}
# NoGotenbergservice. No health checks. No resource limits.
#IronPDF- No additional services needed
version: '3.8'
services:
  app:
    environment:
      - IRONPDF_LICENSE_KEY=${IRONPDF_LICENSE_KEY}
# NoGotenbergservice. No health checks. No resource limits.
YAML

インフラストラクチャの違いも大きい：Gotenberg は、コンテナのデプロイ、ヘルス・モニタリング、リソースの割り当て、サービスの依存関係を必要とします。 IronPdfはアプリケーションのインプロセスで実行されます。

パフォーマンスの特徴

手術Gotenberg（ウォームコンテナ）Gotenberg（コールドスタート）IronPDF (ファーストレンダリング)IronPDF (後続)
シンプルなHTML150-300ms2～5秒1～2秒50-150ms
複雑なHTML500-1500ms3～7秒1.5-3秒200-800ms
URLレンダー1～5秒3～10秒1～5秒500ms-3s
PDFマージ200-500ms2～5秒100-300ms100-300ms

Gotenberg のネットワーク・ラウンドトリップは、リクエストごとに 10～100ms を超えます。コンテナのコールドスタートは 2～5 秒追加されます。 IronPdfの最初のレンダリングではChromiumの初期化(1-2秒)が発生しますが、それ以降のレンダリングではオーバーヘッドは最小限です。

チームがGotenbergからIronPDFへの移行を検討するとき

開発チームがGotenbergからIronPDFへの移行を評価する理由はいくつかあります：

インフラストラクチャ・オーバーヘッド： Gotenbergは、Docker、コンテナ・オーケストレーション（Kubernetes/Docker Compose）、サービス・ディスカバリ、ロード・バランシングを必要とします。 よりシンプルなデプロイメントを求めるチームは、IronPdfのNuGetのみのアプローチにより、このようなインフラの懸念が解消されることに気づきます。

ネットワーク遅延:GotenbergPDFの操作のたびに、別のサービスへのHTTP呼び出しが必要になります。大容量のアプリケーションでは、このオーバーヘッドが蓄積されます。 IronPDFのインプロセスアプローチは初期化後のオーバーヘッドはごくわずかです。

コールドスタートの問題: コンテナのスタートアップは、最初のリクエストに2～5秒を追加する可能性があります。 暖かいコンテナにもネットワーク・オーバーヘッドがあります。 ポッドの再起動、スケールアップイベント、デプロイのたびに、コールドスタートがトリガーされます。 IronPdfのコールドスタートはアプリケーションのライフタイムに一度だけ発生します。

運用の複雑さ: Gotenbergでは、コンテナの健全性、スケーリング、ロギング、およびモニタリングを個別の問題として管理する必要があります。 ネットワークのタイムアウト、サービスの利用不能、コンテナのクラッシュがアプリケーションの懸念事項になります。 IronPDFは標準的な.NETの例外処理を使用します。

マルチパートフォームデータAPI:すべてのGotenbergリクエストは、文字列ベースのパラメータを持つmultipart/form-dataペイロードを構築する必要があります。 IronPDFはインテリセンスをサポートした型付きC#プロパティを提供します。

バージョン管理: Gotenbergのイメージは、アプリケーションとは別に更新されます。 APIの変更は、統合を壊す可能性があります。 IronPDFのバージョンはNuGetを通して標準的な.NET依存関係管理で管理されます。

長所と考慮点

ゴテンベルクの強み

  • ポリグロット・アーキテクチャ：HTTPコールを行うことができるすべての言語で動作します。
  • 言語にとらわれない： .NETエコシステムに縛られない。
  • MITライセンス: フリーおよびオープンソース
  • マイクロサービスパターン：コンテナ化されたアーキテクチャに適合します。

ゴテンベルクの考察

  • インフラストラクチャ・オーバーヘッド： Docker、Kubernetes、ロードバランサーが必要です。
  • ネットワーク遅延: 10-100ms+/リクエスト
  • コールドスタート: 2～5秒のコンテナ初期化
  • 文字列ベースのAPI: 型安全性やインテリセンスはありません。
  • 分散デバッグ: 分散トレースが必要です。
  • ヘルスモニタリング:管理するエンドポイントを追加する。

IronPDFの強み

  • ゼロインフラ: NuGetパッケージのみ。
  • インプロセス パフォーマンス:初期化後のネットワーク遅延がない。
  • タイプセーフAPI:インテリセンスによる強力な型付きプロパティ
  • 標準デバッグ: 通常 for .NETデバッガは動作します。
  • 包括的なリソース: 豊富なチュートリアルとドキュメント。
  • Professionalサポート:商用ライセンスにはサポートが含まれます。

IronPDFについての考察

  • .NET固有: .NETエコシステム向けに設計されています。
  • 商用ライセンス: 本番使用時に必要です。

GotenbergとIronPDFは、.NETアプリケーションでのPDF生成において根本的に異なるアプローチを表しています。 GotenbergのDockerベースのマイクロサービス・アーキテクチャは、コンテナ管理、ネットワーク遅延、運用の複雑さを導入しています。 すべてのPDF操作は、関連する障害モードとコールドスタートのペナルティを伴うHTTP通信を必要とします。

IronPDFは同じChromiumベースのレンダリングをインプロセスライブラリとして提供します。 NuGetパッケージは、Dockerコンテナ、ネットワークコール、インフラストラクチャ管理を排除します。 型付きC# APIは、文字列ベースのマルチパートフォームデータを置き換えます。 .NET標準の例外処理は、HTTPステータスコードとネットワーク障害モードに取って代わります。

組織が.NET 10、C# 14、および2026年までのアプリケーション開発を計画する中で、マイクロサービスのインフラストラクチャオーバーヘッドとインプロセスライブラリのシンプルさのどちらを選択するかは、デプロイと運用の複雑さに大きく影響します。 HTML/CSS/JavaScriptのレンダリングに忠実でありながら、インフラストラクチャの負担を軽減しようとするチームは、IronPdfがこれらの要件に効果的に対応することを発見するでしょう。

無料トライアルでIronPDFの評価を開始し、包括的なドキュメントを参照して、特定の要件への適合性を評価してください。