Darmowe biblioteki PDF dla .NET: Ukryte koszty i lepsze alternatywy w C#

Co właściwie oznacza "bezpłatny" w przypadku bibliotek PDF dla platformy .NET?

Wyszukaj w NuGet hasło "PDF", a znajdziesz biblioteki w pięciu modelach licencyjnych, z których każdy ma inne ograniczenia dotyczące wdrażania w środowisku .NET:

MIT/Apache (naprawdę liberalne): PdfSharp. Używaj go w aplikacjach komercyjnych, kontenerach Docker, Azure Functions, AWS Lambda — bez ograniczeń, bez progów przychodów, bez ujawniania kodu źródłowego. Haczyk: nie można konwertować HTML na PDF.

AGPL (pułapka copyleft):iText Core(dawniej iTextSharp). Wdroż to w dowolnej aplikacji dostępnej w sieci — aplikacjach internetowych, interfejsach API REST, mikrousługach — i musisz udostępnić cały swój kod źródłowy na licencji AGPL. Firmy SaaS nie są wyłączone z tego wymogu.

Ograniczone do wersji komercyjnej: Licencja społecznościowa QuestPDF. Bezpłatnie przy rocznych przychodach brutto poniżej 1 mln USD. Jeśli przekroczysz ten próg, potrzebujesz licencji komercyjnej. Przejście nie jest płynne — to przepaść.

Porzucone:wkhtmltopdfi wszystkie opakowania .NET. Zarchiwizowane z niezałatanymi lukami CVE o ocenie 9,8 (krytyczne). Zero nakładów na utrzymanie bezpieczeństwa. Odpowiedzialność w przypadku każdego audytu zgodności.

Kosztowne w eksploatacji:PuppeteerSharpi Playwright dla .NET. Brak ograniczeń licencyjnych, pełna obsługa nowoczesnego CSS — ale w środowisku produkcyjnym zarządzasz zewnętrznymi procesami przeglądarki, pobieraniem Chromium i cyklem życia pamięci.

Każda kategoria wiąże się z innym ryzykiem dla wdrożeń .NET. W dalszej części artykułu omówiono te zagrożenia, posługując się kodem, liczbami i danymi dotyczącymi ekosystemu NuGet.

Dłączego ceny iText są tak istotne?

Większość artykułów na temat iText skupia się na kwestii egzekwowania licencji AGPL. To zostało omówione gdzie indziej. Bardziej istotnym pytaniem dla zespołów .NET oceniających biblioteki PDF jest to, co się dzieje, gdy potrzebna jest licencja komercyjna.

Jakie są ograniczeniaPdfSharpw przypadku wdrożeń .NET?

PdfSharp stanowi wyjątek wśród bezpłatnych bibliotek: licencja MIT, ponad 34 miliony pobrań z NuGet, prawdziwie liberalne warunki użytkowania komercyjnego. Brak progów przychodów. Nie ujawniać kodu źródłowego.

Ograniczenie ma charakter architektoniczny.PdfSharpdziała na poziomie współrzędnych PDF. Nie ma parsera HTML, silnika CSS ani renderowania DOM.

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

var document = new PdfDocument();
var page = document.AddPage();
var gfx = XGraphics.FromPdfPage(page);

// Every element needs manual coordinates
var titleFont = new XFont("Arial", 18, XFontStyleEx.Bold);
var bodyFont = new XFont("Arial", 10);

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72);
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100);

// Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140);
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155);
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155);
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155);
gfx.DrawLine(XPens.Black, 72, 170, 540, 170);

// Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185);
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185);
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185);

document.Save("invoice.pdf");

Imports PdfSharp.Pdf
Imports PdfSharp.Drawing

Dim document As New PdfDocument()
Dim page As PdfPage = document.AddPage()
Dim gfx As XGraphics = XGraphics.FromPdfPage(page)

' Every element needs manual coordinates
Dim titleFont As New XFont("Arial", 18, XFontStyleEx.Bold)
Dim bodyFont As New XFont("Arial", 10)

gfx.DrawString("INVOICE #2024-0847", titleFont, XBrushes.Black, 72, 72)
gfx.DrawString("Date: 2024-12-15", bodyFont, XBrushes.Gray, 72, 100)

' Table header - manual line drawing
gfx.DrawLine(XPens.Black, 72, 140, 540, 140)
gfx.DrawString("Item", bodyFont, XBrushes.Black, 72, 155)
gfx.DrawString("Qty", bodyFont, XBrushes.Black, 300, 155)
gfx.DrawString("Price", bodyFont, XBrushes.Black, 400, 155)
gfx.DrawLine(XPens.Black, 72, 170, 540, 170)

' Row data - every cell is a manual coordinate
gfx.DrawString("Annual License", bodyFont, XBrushes.Black, 72, 185)
gfx.DrawString("1", bodyFont, XBrushes.Black, 300, 185)
gfx.DrawString("$749.00", bodyFont, XBrushes.Black, 400, 185)

document.Save("invoice.pdf")

To 20 wierszy dla faktury z jednym wierszem, bez stylizacji, bez responsywnego układu i bez CSS. Wyobraź sobie teraz tworzenie 15-stronicowego raportu zgodności zawierającego dynamiczne dane, wykresy i elementy identyfikacji wizualnej firmy.

KiedyQuestPDFprzestaje być darmowy?

QuestPDF przyjął inne podejście projektowe niż PdfSharp: płynny interfejs API, który czyta się jak opis układu, a nie jak matematykę współrzędnych. Projekt API jest naprawdę dobry.

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);

        page.Content().Column(column =>
        {
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold();
            column.Item().Table(table =>
            {
                table.ColumnsDefinition(columns =>
                {
                    columns.RelativeColumn(3);
                    columns.RelativeColumn(1);
                    columns.RelativeColumn(1);
                });

                table.Cell().Text("Item").Bold();
                table.Cell().Text("Qty").Bold();
                table.Cell().Text("Price").Bold();

                table.Cell().Text("Annual License");
                table.Cell().Text("1");
                table.Cell().Text("$749.00");
            });
        });
    });
}).GeneratePdf("invoice.pdf");

Document.Create(Sub(container)
    container.Page(Sub(page)
        page.Size(PageSizes.A4)
        page.Margin(2, Unit.Centimetre)

        page.Content().Column(Sub(column)
            column.Item().Text("Invoice #2024-0847").FontSize(18).Bold()
            column.Item().Table(Sub(table)
                table.ColumnsDefinition(Sub(columns)
                    columns.RelativeColumn(3)
                    columns.RelativeColumn(1)
                    columns.RelativeColumn(1)
                End Sub)

                table.Cell().Text("Item").Bold()
                table.Cell().Text("Qty").Bold()
                table.Cell().Text("Price").Bold()

                table.Cell().Text("Annual License")
                table.Cell().Text("1")
                table.Cell().Text("$749.00")
            End Sub)
        End Sub)
    End Sub)
End Sub).GeneratePdf("invoice.pdf")

Jest to bardziej wyraziste niż układ współrzędnych PdfSharp. Ma jednak tę samą podstawową wadę: brak renderowania HTML.

Dłączego należy unikaćwkhtmltopdfwe wdrożeniach .NET?

Nie bez powodu rozpocząłem ten artykuł od CVE-2022-35583. Ta luka SSRF nie jest teoretyczna — exploity typu proof-of-concept są publicznie dostępne i aktywnie wykorzystywane.

Jaki jest rzeczywisty koszt operacyjny PuppeteerSharp?

To właśnie w tej sekcji większość artykułów na temat "bezpłatnych bibliotek PDF" popełnia błędy.PuppeteerSharpi Playwright dla .NET są doskonałe pod względem technicznym — renderują HTML za pomocą prawdziwego Chromium, obsługując wszystkie funkcje CSS i API JavaScript. Brak ograniczeń licencyjnych. Brak progów przychodów.

Koszt jest operacyjny. Oto jak w rzeczywistości wygląda generowanie plików PDF za pomocą PuppeteerSharp:

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

using PuppeteerSharp;

public class PuppeteerPdfService : IDisposable
{
    private IBrowser _browser;
    private readonly SemaphoreSlim _semaphore;
    private long _pdfCount = 0;

    public PuppeteerPdfService()
    {
        // Limit concurrent pages to prevent memory exhaustion
        _semaphore = new SemaphoreSlim(3, 3);
    }

    public async Task InitializeAsync()
    {
        // Step 1: Download Chromium binary (~280MB)
        var fetcher = new BrowserFetcher();
        await fetcher.DownloadAsync();

        // Step 2: Launch with production-hardened flags
        _browser = await Puppeteer.LaunchAsync(new LaunchOptions
        {
            Headless = true,
            Args = new[]
            {
                "--no-sandbox",              // Required in Docker
                "--disable-setuid-sandbox",  // Required in Docker
                "--disable-dev-shm-usage",   // Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            Timeout = 30000
        });
    }

    public async Task<byte[]> GeneratePdfAsync(string html)
    {
        await _semaphore.WaitAsync();
        IPage page = null;

        try
        {
            Interlocked.Increment(ref _pdfCount);
            page = await _browser.NewPageAsync();

            await page.SetContentAsync(html, new NavigationOptions
            {
                WaitUntil = new[] { WaitUntilNavigation.Networkidle0 },
                Timeout = 20000
            });

            var pdfBytes = await page.PdfAsync(new PdfOptions
            {
                Format = PaperFormat.A4,
                PrintBackground = true,
                MarginOptions = new MarginOptions
                {
                    Top = "20mm", Bottom = "20mm",
                    Left = "15mm", Right = "15mm"
                }
            });

            return pdfBytes;
        }
        finally
        {
            if (page != null)
            {
                try { await page.CloseAsync(); }
                catch { /* Disposal can hang — GitHub issue #1489 */ }
            }
            _semaphore.Release();
        }
    }

    // Restart browser periodically to reclaim leaked memory
    public async Task RecycleBrowserAsync()
    {
        var oldBrowser = _browser;
        await InitializeAsync();
        try { oldBrowser?.Dispose(); } catch { }
    }

    public void Dispose()
    {
        _browser?.Dispose();
        _semaphore?.Dispose();
    }
}

Imports PuppeteerSharp
Imports System.Threading

Public Class PuppeteerPdfService
    Implements IDisposable

    Private _browser As IBrowser
    Private ReadOnly _semaphore As SemaphoreSlim
    Private _pdfCount As Long = 0

    Public Sub New()
        ' Limit concurrent pages to prevent memory exhaustion
        _semaphore = New SemaphoreSlim(3, 3)
    End Sub

    Public Async Function InitializeAsync() As Task
        ' Step 1: Download Chromium binary (~280MB)
        Dim fetcher = New BrowserFetcher()
        Await fetcher.DownloadAsync()

        ' Step 2: Launch with production-hardened flags
        _browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {
            .Headless = True,
            .Args = {
                "--no-sandbox",              ' Required in Docker
                "--disable-setuid-sandbox",  ' Required in Docker
                "--disable-dev-shm-usage",   ' Prevent /dev/shm exhaustion
                "--disable-gpu",
                "--no-zygote",
                "--single-process",
                "--disable-extensions",
                "--max_old_space_size=4096"
            },
            .Timeout = 30000
        })
    End Function

    Public Async Function GeneratePdfAsync(html As String) As Task(Of Byte())
        Await _semaphore.WaitAsync()
        Dim page As IPage = Nothing

        Try
            Interlocked.Increment(_pdfCount)
            page = Await _browser.NewPageAsync()

            Await page.SetContentAsync(html, New NavigationOptions With {
                .WaitUntil = {WaitUntilNavigation.Networkidle0},
                .Timeout = 20000
            })

            Dim pdfBytes = Await page.PdfAsync(New PdfOptions With {
                .Format = PaperFormat.A4,
                .PrintBackground = True,
                .MarginOptions = New MarginOptions With {
                    .Top = "20mm", .Bottom = "20mm",
                    .Left = "15mm", .Right = "15mm"
                }
            })

            Return pdfBytes
        Finally
            If page IsNot Nothing Then
                Try
                    Await page.CloseAsync()
                Catch
                    ' Disposal can hang — GitHub issue #1489
                End Try
            End If
            _semaphore.Release()
        End Try
    End Function

    ' Restart browser periodically to reclaim leaked memory
    Public Async Function RecycleBrowserAsync() As Task
        Dim oldBrowser = _browser
        Await InitializeAsync()
        Try
            oldBrowser?.Dispose()
        Catch
        End Try
    End Function

    Public Sub Dispose() Implements IDisposable.Dispose
        _browser?.Dispose()
        _semaphore?.Dispose()
    End Sub
End Class

To ponad 80 wierszy, zanim wygenerujesz choćby jeden plik PDF. Wciąż brakuje funkcji odzyskiwania po błędach, kontroli stanu, wskaźników oraz timera recyklingu pamięci, które są niezbędne w systemach produkcyjnych.

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20

Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")

Stan ekosystemu .NET: Porównanie pakietów NuGet

Przed wyborem biblioteki sprawdź kondycję jej ekosystemu NuGet. Łańcuchy zależności, częstotliwość wydawania nowych wersji i czas rozwiązywania problemów mówią więcej niż listy funkcji:

Duża liczba pobrań porzuconych pakietów, takich jak DinkToPdf, odzwierciedla ich dawną popularność, a nie aktualny stan. Ponad 300 otwartych zgłoszeń bez odpowiedzi mówi same za siebie.

Dla aplikacji .NET 8 celujacych w net8.0 TFM: PdfSharp, QuestPDF,iText CoreorazIronPDFwspierają to natywnie.wkhtmltopdfwrappers tego nie robia — oczekuj błędów niezgodnośći DllNotFoundException i NU1202 dla docelowych platform.

Macierz decyzyjna

Jeśli potrzebujesz jedynie programowego tworzenia plików PDF na podstawie danych ustrukturyzowanych:PdfSharp(MIT, bez ograniczeń) lubQuestPDF(lepsze API, zwróć uwagę na próg przychodów).

Jeśli potrzebujesz konwersji HTML do PDF z nowoczesnym CSS i nie chcesz zajmować się infrastrukturą przeglądarki: IronPDF. Wbudowany Chromium obsługuje cykl życia silnika renderującego. Opublikowane ceny stanowią ułamek kosztów modelu subskrypcyjnego iText.

Jeśli potrzebujesz konwersji HTML do PDF i nie masz problemów z zarządzaniem procesami przeglądarki:PuppeteerSharpzapewnia pełną kontrolę. Budżet na koszty operacyjne.

Jeśli obecnie korzystasz zwkhtmltopdflub którejkolwiek z jego nakładek: Przejdź na nową wersję. Już samo zagrożenie bezpieczeństwa uzasadnia ten wysiłek — a z każdym miesiącem opóźnienia lista CVE pozostaje bez poprawek.