wkhtmltopdf vs IronPDF：技術比較指南

CVE-2022-35583 安全危機

wkhtmltopdf 的伺服器端請求偽造 (SSRF) 漏洞可讓攻擊者

-存取內部服務：存取防火牆後的內部 API、資料庫和服務 -竊取憑證：存取雲端元資料端點（AWS、GCP、Azure）以竊取 IAM 憑證 -連接埠掃描：從基礎設施內部掃描內部網絡 資料外洩：透過精心設計的 HTML/CSS 程式碼提取敏感資料

攻擊媒介很直接-惡意 HTML 提交給 PDF 產生器：

<!-- Malicious HTML submitted to your PDF generator -->
<iframe src="http://169.254.169.254/latest/meta-data/iam/security-credentials/"></iframe>
<img src="http://internal-database:5432/admin"/>

<!-- Malicious HTML submitted to your PDF generator -->
<iframe src="http://169.254.169.254/latest/meta-data/iam/security-credentials/"></iframe>
<img src="http://internal-database:5432/admin"/>

當wkhtmltopdf渲染此 HTML 時，它會從伺服器的網路上下文擷取這些 URL，繞過防火牆和安全控制。 此漏洞永遠不會被修補，因為該專案已被正式放棄。

受影響的套用程式庫

wkhtmltopdf 的所有 .NET wrapper 都繼承了相同的漏洞：

如果您的應用程式使用任何這些函式庫，就有可能受到 CVE-2022-35583 的攻擊。

wkhtmltopdf配置模式

wkhtmltopdf wrappers 需要使用嵌套的設定配置來建立文件物件：

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientation = Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    HtmlContent = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientation = Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    HtmlContent = "<h1>Hello World</h1><p>This is a PDF from HTML.</p>"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("output.pdf", pdf);
    }
}

此模式需要使用 PdfTools 建立同步轉換器、使用 GlobalSettings 和 Objects 集合建構<編碼>HtmlToPdfDocument</編碼以及手動寫入 byte array 到檔案。

IronPDF簡化模式

IronPDF 使用<代碼>ChromePdfRenderer</代碼類簡化方法：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML.</p>");
        pdf.SaveAs("output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1><p>This is a PDF from HTML.</p>");
        pdf.SaveAs("output.pdf");
    }
}

ChromePdfRenderer類取消了巢狀配置物件，返回一個內建儲存方法的 PdfDocument 。 如需全面的 HTML 轉換指南，請參閱 HTML to PDF 教學。

wkhtmltopdf實作

wkhtmltopdf 使用 ObjectSettings 內的 Page 屬性來指定 URL：

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientation = Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "https://www.example.com"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientation = Orientation.Portrait,
                PaperSize = PaperKind.A4
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "https://www.example.com"
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("webpage.pdf", pdf);
    }
}

IronPDF實作。

IronPDF 提供了專用的 RenderUrlAsPdf 方法：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");
        pdf.SaveAs("webpage.pdf");
    }
}

RenderUrlAsPdf 方法利用 Chromium 引擎來呈現具有完整 JavaScript 執行和現代 CSS 支援的頁面 - 這些功能受限於wkhtmltopdf的 2015 WebKit 引擎。

wkhtmltopdf自訂設定

wkhtmltopdf 需要嵌套 GlobalSettings 與 MarginSettings 物件：

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientation = Orientation.Landscape,
                PaperSize = PaperKind.A4,
                Margins = new MarginSettings() { Top = 10, Bottom = 10, Left = 10, Right = 10 }
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "input.html",
                    WebSettings = { DefaultEncoding = "utf-8" }
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("custom-output.pdf", pdf);
    }
}

// NuGet: Install-Package WkHtmlToPdf-DotNet
using WkHtmlToPdfDotNet;
using WkHtmlToPdfDotNet.Contracts;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new SynchronizedConverter(new PdfTools());
        var doc = new HtmlToPdfDocument()
        {
            GlobalSettings = {
                ColorMode = ColorMode.Color,
                Orientation = Orientation.Landscape,
                PaperSize = PaperKind.A4,
                Margins = new MarginSettings() { Top = 10, Bottom = 10, Left = 10, Right = 10 }
            },
            Objects = {
                new ObjectSettings()
                {
                    Page = "input.html",
                    WebSettings = { DefaultEncoding = "utf-8" }
                }
            }
        };
        byte[] pdf = converter.Convert(doc);
        File.WriteAllBytes("custom-output.pdf", pdf);
    }
}

IronPDF自訂設定

IronPDF 使用渲染選項屬性來直接設定：

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("custom-output.pdf");
    }
}

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

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;
        renderer.RenderingOptions.MarginLeft = 10;
        renderer.RenderingOptions.MarginRight = 10;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

        var pdf = renderer.RenderHtmlFileAsPdf("input.html");
        pdf.SaveAs("custom-output.pdf");
    }
}

CLI 至 C# API 對應。

C# Wrapper API 對應。

占位符語法對應

安全合規要求

有安全合規要求（SOC 2、PCI DSS、HIPAA）的機構不能接受有已知關鍵漏洞的應用程式。 CVE-2022-35583 的 9.8 嚴重性等級會在大多數安全框架中觸發立即修復的要求。

現代 CSS 架構的採用

採用 Bootstrap 5、Tailwind CSS 或自訂 CSS 網格佈局的團隊會發現wkhtmltopdf無法正確呈現這些佈局。 2015 WebKit 引擎完全不支援 CSS Grid，且已破解 Flexbox 實作。

JavaScript 應用程式需求

使用現代 JavaScript 功能的應用程式 -ES6+ 語法，包括箭頭函數、async/await、類別和範本字面意義 - 會在wkhtmltopdf中遇到故障。IronPDF的 Chromium 引擎提供完整的 JavaScript 支援。

雲端與容器部署

使用 Docker、Kubernetes 或雲端平台的現代部署策略可從 IronPdf 的容器友善架構中獲益。 容器中wkhtmltopdf二進位檔的安全掃描會標示 CVE 漏洞。

長期維護的顧慮

由於wkhtmltopdf未來預計不會更新，因此隨著網路標準的演進，團隊面臨越來越多的技術債務。IronPDF的積極開發可確保與未來的 .NET 版本持續相容，包括預計在 2026 年推出的 .NET 10。

同步支援

IronPdf 為網路應用程式效能提供 async/await 支援：

public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

public async Task<byte[]> GeneratePdfAsync(string html)
{
    var renderer = new ChromePdfRenderer();
    var pdf = await renderer.RenderHtmlAsPdfAsync(html);
    return pdf.BinaryData;
}

此功能可防止高負載 Web 應用程式中的線程阻塞 - 這是wkhtmltopdf僅同步封裝程式所不具備的功能。