為什麼企業應用在企業代理後端的PDF渲染上困難重重？

企業應用程式通常運行在鎖定的網路內，無法直接存取外部資源。這導致當外部資源不可及時，PDF中出現圖片無法顯示和字體缺失等問題。

IronPDF如何解決代理後端的PDF渲染問題？

IronPDF允許您直接在`RenderHtmlAsPdf`方法中指定代理，通過代理路由所有資產請求，以確保外部資源被正確存取和呈現。

IronPDF能處理需認證的代理進行PDF渲染嗎？

是的，IronPDF支持需認證的代理。憑據可以包含在代理URL中，密碼中的特殊字元應進行百分比編碼。

使用IronPDF在代理後方渲染內部URL的方法是什麼？

對於內部URL，使用配置代理的`HttpClient`首先獲取HTML，然後使用IronPDF來渲染該HTML，以便所有引用的資產都通過代理路由。

配置適用於IronPDF的Docker部署代理時應考慮什麼？

Docker部署和CI構建代理通常缺乏外出能力，因此應應用與企業代理後面的應用程式相同的代理配置以確保資源存取。

代理URL的方案會影響IronPDF獲取的資源嗎？

代理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通常在封閉的網路中運行，沒有直接的網路連接。問題出現在呈現時：發票或報告範本引用了託管在外部CDN上的logo、網頁字體或樣式表，而在公司網路中，這些請求會默默失敗。文件呈現出沒有樣式，圖像損壞且字體丟失。透過公司代理路由渲染引擎可以解決這個問題，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");