기업용 애플리케이션이 기업 프록시 뒤에서 PDF 렌더링에 어려움을 겪는 이유는 무엇입니까?

기업용 애플리케이션은 종종 외부 리소스에 직접 접근할 수 없는 잠금된 네트워크 내부에서 실행됩니다. 이는 외부 자산에 접근 불가능할 때 PDF에서 깨진 이미지 및 누락된 글꼴과 같은 문제를 야기합니다.

프록시 뒤에서의 PDF 렌더링 문제를 IronPDF가 어떻게 해결합니까?

IronPDF는 `RenderHtmlAsPdf` 메서드에서 직접 프록시를 지정할 수 있으며, 모든 자산 요청을 프록시를 통하여 라우팅함으로써 외부 리소스에 접근되고 올바르게 렌더링되도록 보장합니다.

IronPDF가 인증된 프록시를 처리하여 PDF를 렌더링할 수 있습니까?

네, IronPDF는 인증된 프록시를 지원합니다. 자격 증명은 프록시 URL에 포함될 수 있으며, 비밀번호의 특수 문자는 퍼센트 인코딩되어야 합니다.

IronPDF를 사용하여 내부 URL을 프록시 뒤에서 렌더링하는 방법은 무엇입니까?

내부 URL의 경우, 프록시로 구성된 `HttpClient`를 사용하여 HTML을 먼저 가져오고, 그 HTML을 IronPDF로 렌더링하여 모든 참조된 자산이 프록시를 통해 라우팅되도록 합니다.

IronPDF와 Docker 배포 시 프록시를 구성할 때 고려해야 할 사항은 무엇입니까?

Docker 배포 및 CI 빌드 에이전트는 일반적으로 출구가 없으므로, 기업 프록시 뒤에 있는 애플리케이션을 위해 사용된 동일한 프록시 구성을 적용하여 자원 접근을 보장해야 합니다.

IronPDF에 의해 가져오는 자원에 프록시 URL의 스킴이 영향을 미칩니까?

프록시 URL의 스킴 (`http://` 또는 `https://`)은 앱과 프록시 사이의 연결에 중요합니다. `http://` 프록시는 여전히 `https://` 자원을 가져올 수 있으므로 스킴 선택은 앱과 프록시 간 연결에 TLS가 필요한지 여부와 관련이 있습니다.

IronPDF에서 프록시 매개변수를 사용하는 영향은 무엇입니까?

프록시 매개변수를 사용함으로써 IronPDF는 기업 프록시 뒤에서 실행되는 경우에도 애플리케이션이 완전한 스타일의 브랜드 PDF를 생성할 수 있도록 합니다.

IronPDF에서 프록시 비밀번호의 특수문자는 어떻게 처리됩니까?

프록시 비밀번호의 특수 문자는 IronPDF가 올바르게 인증되도록 하기 위해 프록시 URL을 형성할 때 퍼센트 인코딩되어야 합니다.

프록시 인증과 페이지 인증의 차이는 무엇입니까?

프록시 인증은 프록시 서버에 접근하기 위한 프록시 URL에 있는 자격 증명과 관련되며, 페이지 인증은 특정 웹사이트 또는 웹 서비스에 로그인하는 것과 관련이 있습니다.

C# PDF 라이브러리

Explore IronPDF 무료 체험 시작하기

HTML을 PDF로 변환

Online Demo 코드 예제 모두 보기

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >

Install-Package IronPdf

제품 비교

Ghostscript GPL vs IronPDF: 기술 비교 가이드

Curtis Chau

Updated: 2026년 7월 5일

HTML에서 PDF를 생성하는 Enterprise 애플리케이션은 종종 인터넷으로의 직접 경로가 없는 제한된 네트워크 내에서 실행됩니다. 문제는 렌더링 시간에 발생합니다: 송장 또는 보고서 템플릿이 외부 CDN에 호스팅된 로고, 웹 글꼴 또는 스타일시트를 참조하며, 회사 네트워크 내부에서는 이러한 요청이 조용히 실패합니다. 문서는 스타일이 지정되지 않은 상태로 나오며, 이미지가 끊기고 글꼴이 누락됩니다. 렌더링 엔진을 회사 프록시를 통해 라우팅하면 이 문제가 해결되며, IronPDF는 프록시를 렌더 호출에 직접 허용합니다.

비즈니스 문제

금융, 의료, 또는 보험 앱은 웹 템플릿에서 클라이언트 문서를 생성합니다. 이러한 템플릿은 외부 자산을 가져오지만 서버는 방화벽과 프록시 뒤에 있습니다. 프록시 구성이 없으면 엔진이 자산에 접근할 수 없어 결과물이 깨져 보입니다. 이러한 환경 중 다수는 인증된 프록시도 실행하며, 이로 인해 자격 증명 요구사항이 추가됩니다.

해결책

프록시는 렌더 옵션의 속성이 아닌, RenderHtmlAsPdf 메소드의 매개변수입니다. 프록시 문자열을 전달하면 엔진으로부터의 모든 자산 요청이 해당 프록시를 통해 라우팅됩니다.

using IronPdf;

var renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(
    htmlContent,
    baseUrlOrPath: @"C:\templates\assets\",
    proxy: "http://proxy.co/rp.local:8080"
);
pdf.SaveAs("report.pdf");

using IronPdf;

var renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(
    htmlContent,
    baseUrlOrPath: @"C:\templates\assets\",
    proxy: "http://proxy.co/rp.local:8080"
);
pdf.SaveAs("report.pdf");

인증된 프록시의 경우, 자격 증명은 프록시 URL에 포함됩니다. 비밀번호의 특수 문자는 퍼센트 인코딩해야 합니다.

string encoded = Uri.EscapeDataString("P@ssw0rd!");
string proxy = $"http://svc-account:{encoded}@proxy.co/rp.local:8080";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath: null, proxy: proxy);

string encoded = Uri.EscapeDataString("P@ssw0rd!");
string proxy = $"http://svc-account:{encoded}@proxy.co/rp.local:8080";

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath: null, proxy: proxy);

프록시 뒤의 내부 URL 렌더링

URL 렌더 메소드는 프록시 매개변수를 허용하지 않습니다. 실질적인 패턴은 프록시에 맞게 구성된 HttpClient으로 HTML을 가져온 다음, 해당 HTML을 렌더링하여 참조된 자산도 프록시를 통해 라우팅되도록 하는 것입니다.

using System.Net;
using System.Net.Http;

var webProxy = new WebProxy("http://proxy.co/rp.local:8080")
{
    Credentials = new NetworkCredential("svc-account", "P@ssw0rd!")
};
var handler = new HttpClientHandler { Proxy = webProxy, UseProxy = true };
using var httpClient = new HttpClient(handler);

string html = await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report");
PdfDocument pdf = renderer.RenderHtmlAsPdf(html, baseUrlOrPath: null, proxy: "http://proxy.co/rp.local:8080");

using System.Net;
using System.Net.Http;

var webProxy = new WebProxy("http://proxy.co/rp.local:8080")
{
    Credentials = new NetworkCredential("svc-account", "P@ssw0rd!")
};
var handler = new HttpClientHandler { Proxy = webProxy, UseProxy = true };
using var httpClient = new HttpClient(handler);

string html = await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report");
PdfDocument pdf = renderer.RenderHtmlAsPdf(html, baseUrlOrPath: null, proxy: "http://proxy.co/rp.local:8080");

계획할 고려 사항

프록시 인증은 페이지 인증이 아닙니다: 프록시 URL의 자격 증명은 프록시와 관련된 인증을 하며, 이는 웹사이트 로그인 자격 증명과 다릅니다.
스킴은 프록시 홉을 나타냅니다: http:// 프록시는 여전히 https:// 리소스를 가져올 수 있어, 스킴 선택은 앱과 프록시 간 연결에 TLS가 필요한지에 대한 것입니다.
컨테이너와 파이프라인: Docker 배포 및 CI 빌드 에이전트는 대개 출구가 없기 때문에 동일한 프록시 구성이 적용됩니다.

결과

하나의 매개변수를 통해 팀은 인증된 환경과 컨테이너를 포함하여 회사 프록시 뒤에서 실행되는 애플리케이션에서 완전한 스타일링과 브랜딩이 된 PDF를 얻습니다. 전체 구성 세부 사항은 프록시 가이드에 있습니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기