.NET을 위한 무료 PDF 라이브러리: 숨겨진 비용과 더 나은 C# 대안들

.NET PDF 라이브러리에서 "무료" 실제로 무엇을 의미합니까?

NuGet에서 "PDF"를 검색하면 .NET 배포에 각기 다른 제한 조건이 있는 다섯 가지 라이선스 모델의 라이브러리를 찾을 수 있습니다:

MIT/Apache (실제로 허가형): PdfSharp. 상업적 애플리케이션, Docker 컨테이너, Azure Functions, AWS Lambda에서 사용 가능 — 제한 없음, 매출 한계 없음, 소스 코드 공개 없음. 단점: HTML을 PDF로 변환할 수 없습니다.

AGPL (카피레프트 함정):iText Core(이전의 iTextSharp). 네트워크에 접근 가능한 어떤 애플리케이션 — 웹 앱, REST API, 마이크로서비스 — 에든 배포하면 전체 소스 코드를 AGPL로 공개해야 합니다. SaaS 회사에는 면제가 없습니다.

매출 제한:QuestPDF커뮤니티 라이선스. 연매출 $100만 미만은 무료. 그 한계를 넘으면 상업 라이선스가 필요합니다. 변경은 점진적이지 않습니다 — 절벽입니다.

버림받음:wkhtmltopdf및 모든 .NET 래퍼. 패치되지 않은 CVE가 9.8의 치명적 점수를 기록하며 아카이브됨. 보안 유지보수 전무. 어떤 규정 준수 감사에서도 위험 요소.

운영 비용이 큼:PuppeteerSharp및 Playwright for .NET. 라이선스 제한 없음, 최신 CSS 지원 완전 — 그러나 외부 브라우저 프로세스, Chromium 다운로드, 프로덕션에서의 메모리 라이프사이클을 관리해야 합니다.

각 카테고리는 .NET 배포에 대해 다른 위험을 만듭니다. 이 기사 나머지는 코드, 숫자, NuGet 생태계 데이터로 이러한 위험을 분해합니다.

왜 iText의 가격이 진짜 이야기입니까?

iText에 대한 대부분의 기사는 AGPL 집행 각도에 중점을 둡니다. 그것은 다른 곳에서도 다루어집니다. .NET 팀이 PDF 라이브러리를 평가할 때 더 관련 있는 질문은 상업 라이선스가 필요할 때 무슨 일이 발생하는가 하는 것입니다.

.NET 배포용 PdfSharp의 제한 사항은 무엇입니까?

PdfSharp은 무료 라이브러리 중 예외로: MIT 라이선스, 3400만 이상의 NuGet 다운로드, 상업적 사용에 대해 진정으로 관대함. 수익 임계값 없음. 소스 코드 공개 없음.

제한은 아키텍처상입니다. PdfSharp는 PDF 좌표 수준에서 작동합니다. HTML 파서, CSS 엔진, 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");

스타일링 없이, 반응형 레이아웃 없이, CSS 없이 단일 행 청구서에 대해 이게 20줄입니다. 이제 동적 데이터, 차트 및 기업 브랜딩이 있는 15페이지의 규정 준수 보고서를 구축하는 것을 상상해보세요.

QuestPDF는 언제부터 무료가 아닙니까?

QuestPDF는 PdfSharp과 다른 설계 접근을 취했습니다: 레이아웃 설명을 읽는 Fluent API, 좌표 계산보다는. API 설계는 진정으로 훌륭합니다.

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

이는 PdfSharp의 좌표 시스템보다 표현력이 큽니다. 그러나 동일한 근본적인 제한을 공유합니다: HTML 렌더링 없음.

어떤 .NET 배포에서든 wkhtmltopdf를 피해야 하는 이유는 무엇입니까?

이 기사를 CVE-2022-35583으로 시작한 이유가 있습니다. 그 SSRF 취약성은 이론적이지 않습니다 - 개념 증명 익스플로잇이 공개적으로 제공되며 적극적으로 사용되고 있습니다.

PuppeteerSharp의 진정한 운영 비용은 무엇입니까?

이것은 대부분의 '무료 PDF 라이브러리' 기사들이 틀린 섹션입니다.PuppeteerSharp및 Playwright for .NET은 기술적으로 우수합니다 — 실제 Chromium을 통해 HTML을 렌더링하고 모든 CSS 기능 및 JavaScript API를 지원합니다. 라이센스 제한 없음. 수익 임계값 없음.

비용은 운영적입니다. 여기서 실제로PuppeteerSharpPDF 생성이 어떻게 보이는지를 보여드립니다:

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();
    }
}

단 하나의 PDF를 생성하기 전에 80줄 이상의 코드가 필요합니다. 운영 시스템에 필요한 오류 복구, 상태 검사, 메트릭, 메모리 재순환 타이머는 여전히 포함되지 않았습니다.

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

.NET 에코시스템 건강: NuGet 패키지 비교

도서관을 선택하기 전에 NuGet 에코시스템 건강을 확인하십시오. 종속성 체인, 릴리스 빈도, 문제 해결 시간은 기능 목록보다 더 많은 정보를 제공합니다:

DinkToPdf와 같은 버려진 패키지에서의 높은 다운로드 수는 폐기된 채택을 반영하며, 현재의 건강 상태를 나타내지 않습니다. 응답이 없는 300개 이상의 열린 문제들이 실제 이야기를 말해줍니다.

.NET 8 애플리케이션이 net8.0 TFM을 대상으로 하는 경우: PdfSharp, QuestPDF, iText Core, 그리고 IronPDF는 모두 네이티브로 지원합니다.wkhtmltopdf래퍼는 지원하지 않습니다 — DllNotFoundException 및 NU1202 대상 프레임워크 호환성 오류를 예상하십시오.

결정 메트릭스

구조화된 데이터에서 프로그래밍 방식의 PDF 생성만 필요한 경우:PdfSharp(MIT, 제한 없음) 또는QuestPDF(더 나은 API, 수익 임계값 확인).

최신 CSS로 HTML을 PDF로 변환 및 브라우저 인프라 관리를 원하지 않는 경우: IronPDF. 임베디드 Chromium이 렌더링 엔진의 라이프사이클을 처리합니다. iText의 구독 모델의 일부분에 해당하는 공시 가격.

HTML을 PDF로 변환하고 브라우저 프로세스를 관리하는 데 자신 있는 경우: PuppeteerSharp는 완전한 제어를 제공합니다. 운영 오버헤드를 위한 예산 마련.

현재wkhtmltopdf또는 그 래퍼를 사용하는 경우: 마이그레이션하십시오. 보안 노출 자체가 노력의 정당성을 증명합니다 — 그리고 모든 달을 지연할 때마다, CVE 리스트는 패치되지 않은 상태로 남아 있습니다.