.NET için Ücretsiz PDF Kütüphaneleri: Gizli Maliyetler ve C# İçin Daha İyi Alternatifler

Ücretsiz, .NET PDF Kütüphanelerinde Gerçekte Ne Anlama Geliyor?

NuGet'te "PDF" arayın ve her biri .NET dağıtımı için farklı kısıtlamalarla beş lisans modeline sahip kütüphaneler bulacaksınız:

MIT/Apache (gerçekten izin verici): PDFSharp. Ticari uygulamalarda, Docker konteynerlarında, Azure Functions, AWS Lambda'da kullanın — kısıtlama yok, gelir eşikleri yok, kaynak kodu ifşası yok. Püf noktası: HTML'yi PDF'ye dönüştüremez.

AGPL (copyleft tuzağı):iText Core(önceki adıyla iText). Bunu herhangi bir ağ erişimli uygulamada — web uygulamaları, REST API'leri, mikroservislerinde — dağıtın ve tüm kaynak kodunuzu AGPL altında yayınlamalısınız. SaaS şirketlerine muafiyet tanınmaz.

Gelirle sınırlı:QuestPDFTopluluk Lisansı. Yıllık brüt geliri 1 milyon $'ın altında ücretsiz. Bu eşiği aşın ve ticari bir lisans almanız gerekir. Geçiş kademeli değil — bir uçurumdur.

Terk edildi:wkhtmltopdfve tüm .NET sarmalayıcılar. 9.8 Kritik puanlı yamalanmamış CVE'lerle arşivlendi. Sıfır güvenlik bakımı. Herhangi bir uyum denetiminde sorumluluk.

Operasyonel olarak pahalı:PuppeteerSharpve Playwright .NET için. Lisans kısıtlamaları yok, tam modern CSS desteği — ancak dış tarayıcı süreçlerini yönetiyorsunuz, Chromium indirmeleri ve üretimde bellek yaşam döngüsü.

Her kategori .NET dağıtımları için farklı riskler yaratır. Bu makalenin geri kalanı, bu riskleri kod, rakamlar ve NuGet ekosistem verileriyle ortaya koyar.

iText'in Fiyatlandırması Neden Gerçek Hikaye?

iText hakkında birçok makale AGPL uygulama açısı üzerine odaklanır. Bu başka yerlerde ele alınmıştır. .NET ekipleri için daha ilgili soru, ticari bir lisansa ihtiyaç duyduğunuzda ne olacağıdır.

.NET Dağıtımları için PDFSharp'ın Sınırlamaları Nelerdir?

PDFSharp, ücretsiz kütüphaneler arasında istisna: MIT lisansı, 34 milyondan fazla NuGet indirmesi, ticari kullanım için gerçekten izin verici. Gelir eşikleri yok. Kaynak kodu ifşası yok.

Kısıtlama mimaridir. PDFSharp, PDF koordinat seviyesinde çalışır. HTML ayrıştırıcısı yok, CSS motoru yok, DOM işleme yok.

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("$2,998", 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("$2,998", 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("$2,998", bodyFont, XBrushes.Black, 400, 185)

document.Save("invoice.pdf")

Bu, stil olmadan, duyarlı düzen olmadan, CSS olmadan tek satırlık bir fatura için 20 satırdır. Şimdi dinamik veri, grafikler ve kurumsal markalama ile 15 sayfalık bir uyumluluk raporu oluşturmayı hayal edin.

QuestPDFÜcretsiz Olmayı Ne Zaman Bırakır?

QuestPDF, PDFSharp'tan farklı bir tasarım yaklaşımı benimsedi: koordinat matematiği yerine bir düzen açıklaması gibi okunan akıcı bir API. API tasarımı gerçekten iyi.

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("$2,998");
            });
        });
    });
}).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("$2,998");
            });
        });
    });
}).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("$2,998")
            End Sub)
        End Sub)
    End Sub)
End Sub).GeneratePdf("invoice.pdf")

Bu, PDFSharp'ın koordinat sisteminden daha ifade edicidir. Ancak temel aynı sınırlamayı paylaşır: HTML işleme yoktur.

wkhtmltopdf'nin Herhangi Bir .NET Dağıtımında Neden Kaçınılması Gerektiği?

Bu makaleyi bir nedenle CVE-2022-35583 ile açtım. Bu SSRF güvenlik açığı teorik değildir — kavram ispatı istismarlar mevcuttur ve aktif olarak kullanılmaktadır.

PuppeteerSharp'un Gerçek Operasyonel Maliyeti Nedir?

Bu, çoğu "ücretsiz PDF kütüphanesi" makalesinin yanlış anladığı bölüm.PuppeteerSharpve Playwright .NET için teknik olarak mükemmel — gerçek bir Chromium üzerinden HTML render ediyor ve her CSS özelliğini ve JavaScript API'sini destekliyor. Lisans sınırlamaları yok. Gelir eşikleri yok.

Maliyet operasyona aittir. İşte üretimdekiPuppeteerSharpPDF oluşturmasının gerçek görünümü:

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

Bu, tek bir PDF oluşturmadan önce 80+ satırdır. Ve hala hata kurtarma, sağlık kontrolleri, ölçümler ve üretim sistemlerinin ihtiyaç duyduğu bellek geri dönüşüm zamanlayıcısı eksik.

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")

.NET Ekosistem Sağlığı: NuGet Paketi Karşılaştırması

Bir kütüphane seçmeden önce NuGet ekosistem sağlığını kontrol edin. Bağımlılık zincirleri, sürüm sıklığı ve sorun çözüm süresi size özellik listelerinden daha fazla bilgi verir:

Yüksek indirme sayıları,DinkToPdfgibi terk edilmiş paketler üzerinde miras olarak kabulü yansıtır, mevcut sağlığı değil. Yanıtsız300+açık sorun, gerçek hikayeyi anlatır.

.NET 8 uygulamaları için net8.0 TFM hedefleniyorsa: PDFSharp, QuestPDF,iText CoreveIronPDFbunu yerel olarak destekler.wkhtmltopdfsarmalayıcıları desteklemez — DllNotFoundException ve NU1202 hedef çerçeve uyumsuzluk hataları bekleyin.

Karar Matrisi

Sadece yapılandırılmış verilerden programatik PDF oluşturma ihtiyacınız varsa:PDFSharp(MIT, kısıtlama yok) veyaQuestPDF(daha iyi API, gelir eşiğini takip edin).

HTML'den PDF'ye modern CSS ile ve tarayıcı altyapısını yönetmek istemiyorsanız: IronPDF. İçselleştirilmiş Chromium, işleme motoru yaşam döngüsünü yönetir. Yayınlanmış fiyatlandırma, iText'in abonelik modelinin bir kısmı kadardır.

HTML'den PDF'ye ihtiyacınız varsa ve tarayıcı süreçlerini yönetmekte rahatsanız:PuppeteerSharpsize tam kontrol verir. Operasyonel yük için bütçe ayırın.

Şu andawkhtmltopdfveya herhangi bir sarıcısını kullanıyorsanız: Geçiş yapın. Tek başına güvenlik açığı, çabayı haklı çıkarır — ve her ay geciktikçe, CVE listesi yamalanmamış kalır.