比較

TuesPechkin vs IronPDF：技術比較指南

更新:

星期二vs IronPDF：.NET PDF 生成的技術比較

當 .NET 開發人員需要將 HTML 轉換成 PDF 時，有幾個圍繞傳統渲染引擎所建立的包裝函式庫可供选择。星期二就是這樣一個解決方案，它包覆了 wkhtmltopdf 函式庫以提供 PDF 產生功能。 本技術比較將研究星期二與 IronPDF，以協助架構人員與開發人員瞭解傳統封裝程式與現代 PDF 函式庫之間的取捨。

瞭解 TuesPechkin

TuesPechkin 是 wkhtmltopdf 函式庫的線程安全封裝程式，旨在協助開發人員從 HTML 內容產生 PDF 文件。 該函式庫嘗試透過提供 ThreadSafeConverter 實作來解決 wkhtmltopdf 所固有的並發挑戰。

但星期二繼承了其基礎技術的基本限制：

  • 已廢棄的基金會：T星期二包覆 wkhtmltopdf，該基金會最後一次更新是在 2015 年，並於 2022 年 12 月正式廢棄。
  • 過時的渲染引擎：使用 Qt WebKit 4.8，Chrome 時代以前的渲染引擎
  • 複雜的線程管理：需要開發人員透過 RemotingToolset 和部署模式來手動設定線程安全
  • 負載下的穩定性：即使使用線程安全組態，程式庫仍可能在高併發下因 AccessViolationException 或程序擱置而當機。
  • 有限的 CSS 支援：不支援 Flexbox 或 CSS Grid 等現代 CSS 功能。
  • JavaScript 的限制：不支援 ES6+ 的 JavaScript 執行不可靠

安全性考量

TuesPechkin 繼承了 wkhtmltopdf 的所有安全漏洞。 CVE-2022-35583 評等為 Critical (9.8/10)，代表伺服器端請求偽造漏洞，影響所有星期二版本。 由於 wkhtmltopdf 已被棄用，此漏洞將永遠無法修補，這意味著使用星期二的應用程式將永遠暴露於漏洞中。

了解 IronPDF

IronPDF 採取了一種根本不同的方法，它提供了一個現代化的商用 PDF 函式庫，具有原生線程安全和基於 Chromium 的渲染引擎。IronPDF 並非包裝傳統工具，而是以 PDF 生成為主要重點。

IronPDF的主要特性包括：

  • 現代 Chromium 引擎：完全支援 HTML5、CSS3、Flexbox、CSS Grid 和 ES6+ JavaScript
  • 原生線程安全：無需手動線程管理 - 並行作業自動運作
  • 主動開發：每週更新並持續改進
  • 全面的 PDF 功能：除生成功能外，還包括操作、數位簽署、PDF/A 合規性和表格填寫。
  • 簡易整合：直接安裝 NuGet，無需本機二進位部署

功能比較

下表強調了星期二和IronPDF的技術差異：

特點星期二IronPDF
執照免費 (MIT 授權)商業的
線程安全需要手動管理本地支援
貨幣功能有限，可能會在負載下當機穩健、可處理高並發性
開發狀態未激活，最近更新日期為 2015 年積極、持續的改進
易用性複雜的設定使用指南方便使用者
說明文件基本的包含大量範例
渲染引擎Qt WebKit 4.8 (過時)現代 Chromium
CSS3 支援。部分的全面支援
Flexbox/網格不支援全面支援
JavaScript。不可靠完整的 ES6+
PDF 操作無法提供全面支援
數位簽名無法提供全面支援
PDF/A合規性無法提供全面支援
表格填寫無法提供全面支援
水印。無法提供全面支援
合併/分割無法提供全面支援
頁首/頁腳僅提供基本文字完整的 HTML 支援
安全修補程式永不（已放棄）定期更新

API 架構差異

當檢視初始化模式和基本用法時，就能立即看出星期二和IronPDF在架構上的差異。

星期二初始化複雜性

TuesPechkin 需要複雜的初始化程序，涉及轉換器、工具集和部署組態：

// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Hello World</h1></body></html>";
        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = { new ObjectSettings { HtmlText = html } }
        });

        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}
// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Hello World</h1></body></html>";
        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = { new ObjectSettings { HtmlText = html } }
        });

        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此模式需要瞭解多個巢狀的類別：StandardConverter, RemotingToolset, Win64EmbeddedDeployment, 和 TempFolderDeployment. 部署配置也必須符合目標平台架構 (x86/x64)。

IronPDF簡化方法

IronPDF 透過直接的 API 完全消除了部署的複雜性：

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

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

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

        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

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

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

        pdf.SaveAs("output.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ChromePdfRenderer 類可立即存取 PDF 生成，而無需特定平台的設定。 如需全面的 HTML 轉換指南，請參閱 HTML to PDF 教學。

URL 至 PDF 轉換

將網頁轉換成 PDF 文件展示了兩個函式庫的 API 可用性差異。

星期二實作

TuesPechkin 使用 ObjectSettings 內的 PageUrl 屬性來指定 URL：

// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = {
                new ObjectSettings {
                    PageUrl = "https://www.example.com"
                }
            }
        });

        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}
// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = {
                new ObjectSettings {
                    PageUrl = "https://www.example.com"
                }
            }
        });

        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

同樣的初始化複雜度也適用，過時的 WebKit 引擎可能會因為缺少 CSS3 和 JavaScript 支援而導致現代網站的呈現不正確。

IronPDF實作。

IronPDF 利用其現代化的 Chromium 引擎提供專用的 URL 演算法：

// 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");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

RenderUrlAsPdf 方法在無頭 Chromium 瀏覽器中載入網頁，執行 JavaScript 並準確套用所有現代 CSS 樣式。 這對於使用 React、Angular 或 Vue.js 等框架建立的 Web 應用程式來說非常重要，因為星期二無法正確呈現這些應用程式。

自訂渲染設定

配置頁面尺寸、邊緣和方向揭示了文件設定的不同方法。

星期二配置

TuesPechkin 使用具有嵌套配置的 GlobalSettings 和 ObjectSettings 類別：

// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Custom PDF</h1></body></html>";

        var document = new HtmlToPdfDocument
        {
            GlobalSettings = {
                Orientation = GlobalSettings.PdfOrientation.Landscape,
                PaperSize = GlobalSettings.PdfPaperSize.A4,
                Margins = new MarginSettings { Unit = Unit.Millimeters, Top = 10, Bottom = 10 }
            },
            Objects = {
                new ObjectSettings { HtmlText = html }
            }
        };

        byte[] pdfBytes = converter.Convert(document);
        File.WriteAllBytes("custom.pdf", pdfBytes);
    }
}
// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Custom PDF</h1></body></html>";

        var document = new HtmlToPdfDocument
        {
            GlobalSettings = {
                Orientation = GlobalSettings.PdfOrientation.Landscape,
                PaperSize = GlobalSettings.PdfPaperSize.A4,
                Margins = new MarginSettings { Unit = Unit.Millimeters, Top = 10, Bottom = 10 }
            },
            Objects = {
                new ObjectSettings { HtmlText = html }
            }
        };

        byte[] pdfBytes = converter.Convert(document);
        File.WriteAllBytes("custom.pdf", pdfBytes);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDF配置

IronPdf 將設定集中在 RenderingOptions 屬性中，並提供直覺的屬性名稱：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;
using System;

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

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;

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

        pdf.SaveAs("custom.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;
using System;

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

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;

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

        pdf.SaveAs("custom.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

RenderingOptions 類別提供了統一的設定方法，在此方法中，邊界值可直接以毫米為單位指定，而不需要包裝物件。

線程安全與並發

線程安全是伺服器端 PDF 產生的關鍵考量，而這兩個函式庫採取了根本不同的方法。

星期二線程管理

TuesPechkin 透過其 ThreadSafeConverter 宣傳線程穩定性操作，但其實作有記錄的限制：

//星期二- Even with ThreadSafeConverter, crashes under load
var converter = new TuesPechkin.ThreadSafeConverter(
    new TuesPechkin.RemotingToolset<PechkinBindings>());

// Under high load, applications may experience:
// - System.AccessViolationException
// - StackOverflowException
// - Process hangs indefinitely
// - Memory corruption
//星期二- Even with ThreadSafeConverter, crashes under load
var converter = new TuesPechkin.ThreadSafeConverter(
    new TuesPechkin.RemotingToolset<PechkinBindings>());

// Under high load, applications may experience:
// - System.AccessViolationException
// - StackOverflowException
// - Process hangs indefinitely
// - Memory corruption
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

底層的 wkhtmltopdf 函式庫並非針對高併發情況而設計，即使有 wrapper-level 的線程管理，在大量負載下仍會有穩定性的問題。

IronPDF原生並發

IronPdf 提供原生線程安全，無需任何設定：

//IronPDF- Native thread safety
var renderer = new ChromePdfRenderer();

// Safe for concurrent use across multiple threads
// No AccessViolationException
// No process hangs
// Stable under high load
//IronPDF- Native thread safety
var renderer = new ChromePdfRenderer();

// Safe for concurrent use across multiple threads
// No AccessViolationException
// No process hangs
// Stable under high load
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ChromePdfRenderer可在內部處理並發性，讓開發人員專注於應用程式邏輯而非線程同步。

支援現代 CSS 與 JavaScript

TuesPechkin 和IronPDF的渲染引擎差異在使用現代網路技術時最為明顯。

星期二渲染限制

TuesPechkin 的 Qt WebKit 4.8 引擎早於現代的 CSS 排版系統：

<!-- This modern CSS doesn't work in星期二-->
<div style="display: flex; justify-content: space-between; gap: 20px;">
    <div style="flex: 1;">Column 1</div>
    <div style="flex: 1;">Column 2</div>
</div>

<div style="display: grid; grid-template-columns: repeat(3, 1fr);">
    <div>Grid Item 1</div>
    <div>Grid Item 2</div>
    <div>Grid Item 3</div>
</div>
<!-- This modern CSS doesn't work in星期二-->
<div style="display: flex; justify-content: space-between; gap: 20px;">
    <div style="flex: 1;">Column 1</div>
    <div style="flex: 1;">Column 2</div>
</div>

<div style="display: grid; grid-template-columns: repeat(3, 1fr);">
    <div>Grid Item 1</div>
    <div>Grid Item 2</div>
    <div>Grid Item 3</div>
</div>
HTML

使用星期二的應用程式必須依賴表格式版面或其他 CSS2.1 變通方式來實現多欄設計。

IronPDF現代渲染

IronPdf 的 Chromium 引擎支援所有現代 CSS 和 JavaScript：

// Modern CSS works correctly with IronPDF
var html = @"
    <div style='display: flex; justify-content: space-between;'>
        <div>Left</div>
        <div>Right</div>
    </div>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// Renders correctly with full Flexbox support
// Modern CSS works correctly with IronPDF
var html = @"
    <div style='display: flex; justify-content: space-between;'>
        <div>Left</div>
        <div>Right</div>
    </div>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// Renders correctly with full Flexbox support
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

這可讓開發人員使用相同的 HTML/CSS 進行網頁顯示和 PDF 生成，而無需維護獨立的範本。

當團隊考慮替代星期二時。

有幾種情況通常會促使開發團隊評估星期二的替代方案：

安全性要求

由於 CVE-2022-35583 評等為 Critical (9.8/10)，且底層的 wkhtmltopdf 函式庫已正式廢棄，因此有安全合規要求的組織無法繼續使用 TuesPechkin。 SSRF 漏洞允許攻擊者存取內部網路、竊取憑證，並透過惡意的 HTML 內容外洩資料。

現代網路技術的採用

採用現代前端框架 (React、Angular、Vue.js) 或 CSS 排版系統 (Flexbox、Grid) 的團隊會發現星期二無法準確呈現他們的內容。 過時的 WebKit 4.8 引擎缺乏對近十年來標準技術的支援。

負載下的穩定性

伺服器端應用程式在並發 PDF 生成負載下遇到當機、擱置或 AccessViolationException 錯誤時，通常會將這些問題歸咎於星期二的線程限制。 即使使用 ThreadSafeConverter 設定，底層 wkhtmltopdf 函式庫也不是為高併發環境而設計。

PDF 功能需求

TuesPechkin 僅提供 HTML 至 PDF 的轉換。 需要 PDF 操作（合併、分割）、數位簽署、PDF/A 合規性、表格填寫或水印的團隊，必須新增額外的函式庫，或考慮IronPDF等原生提供這些功能的替代方案。

簡化部署

TuesPechkin 初始化模式與 RemotingToolset, Win64EmbeddedDeployment, 和 TempFolderDeployment 增加了部署的複雜性。 特定平台的原生二進位檔必須針對每個目標環境正確設定。IronPDF透過標準的 NuGet 安裝消除了這種複雜性。

API 對應參考。

評估從星期二轉換到IronPDF的團隊會發現此對應圖有助於瞭解概念等效：

星期二IronPDF筆記
StandardConverter / ThreadSafeConverter<代碼>ChromePdfRenderer</代碼不需要線程管理
<編碼>HtmlToPdfDocument</編碼方法參數直接輸入 HTML 字串
GlobalSettings.PaperSizeRenderingOptions.PaperSize提供相同的紙張尺寸
GlobalSettings.Orientation<編碼>RenderingOptions.PaperOrientation</編碼肖像/風景
GlobalSettings.邊界RenderingOptions.MarginTop/Bottom/Left/Right渲染選項。直接毫米值
<編碼>ObjectSettings.HtmlText</編碼RenderHtmlAsPdf(html)HTML 內容參數
ObjectSettings.PageUrl 物件設定。<代碼>RenderUrlAsPdf(url)</代碼URL 呈現方法
RemotingToolset + Deployment不需要自動部署
[page]占位符{page} 占位符頁碼語法
[toPage]占位符{total-pages} 占位符總頁數 語法

額外的 PDF 功能

除了 HTML 到 PDF 的轉換之外，IronPDF 還提供星期二無法提供的文件操作功能：

.NET相容性與未來準備

TuesPechkin 的非活躍開發狀態意味著不會更新較新的 .NET 版本。IronPDFfor .NET 維持積極的開發與定期的更新，確保與 .NET 8、.NET 9 以及未來的版本相容，包括預計在 2026 年推出的 .NET 10。該函式庫在整個 API 中的 async/await 支援符合現代 C# 開發實務，包括 C# 13 中可用的功能以及預期的 C# 14 功能。

結論

TuesPechkin 和IronPDF代表了 .NET PDF 生成的不同時代。星期二提供了一個免費、經 MIT 授權的 wkhtmltopdf 封裝程式，但卻繼承了嚴重的安全漏洞、過時的渲染引擎、複雜的線程管理需求，以及負載下的穩定性問題。 底層技術已於 2022 年被棄用，而且沒有任何安全修補程式即將推出。

IronPDF 提供了一個現代化、積極維護的替代方案，其基於 Chromium 的渲染引擎支援當前的網路技術。 它的原生線程安全、全面的 PDF 功能以及直接的 API 設計解決了 wkhtmltopdf wrappers 的固有限制。

對於目前使用星期二的團隊而言，遷移的決定通常來自於安全性需求、呈現品質需求、穩定性考量，或對基本 HTML 轉換以外 PDF 功能的需求。 這兩個函式庫之間的 API 對應很直接，IronPDF 由於簡化了初始化和配置模式，一般需要較少的程式碼。

如需其他實施指導，請參閱 IronPDF 文件和涵蓋特定用例和進階功能的 教學。