為什麼企業應用在企業代理後端的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

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

Imports IronPdf

Dim renderer = New ChromePdfRenderer()

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

Imports IronPdf

Dim renderer = New ChromePdfRenderer()

Dim pdf As PdfDocument = 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);

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

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath:=Nothing, proxy:=proxy)

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

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent, baseUrlOrPath:=Nothing, 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");

Imports System.Net
Imports System.Net.Http

Dim webProxy = New WebProxy("http://proxy.co/rp.local:8080") With {
    .Credentials = New NetworkCredential("svc-account", "P@ssw0rd!")
}
Dim handler = New HttpClientHandler With {
    .Proxy = webProxy,
    .UseProxy = True
}
Using httpClient As New HttpClient(handler)
    Dim html As String = Await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report")
    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html, baseUrlOrPath:=Nothing, proxy:="http://proxy.co/rp.local:8080")
End Using

Imports System.Net
Imports System.Net.Http

Dim webProxy = New WebProxy("http://proxy.co/rp.local:8080") With {
    .Credentials = New NetworkCredential("svc-account", "P@ssw0rd!")
}
Dim handler = New HttpClientHandler With {
    .Proxy = webProxy,
    .UseProxy = True
}
Using httpClient As New HttpClient(handler)
    Dim html As String = Await httpClient.GetStringAsync("https://dashboard.internal.co/rp/report")
    Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html, baseUrlOrPath:=Nothing, proxy:="http://proxy.co/rp.local:8080")
End Using

需要計劃的要點

代理身份驗證不是頁面身份驗證：代理URL中的憑證用於代理身份驗證，這與網站登入憑證不同。
協議指的是代理跳躍：一個https://資源，因此協議選擇是關於應用程式到代理連接是否需要TLS。
容器和管道： Docker部署和CI構建代理通常沒有出口，因此相同的代理配置適用於此。

結果

通過一個參數，團隊就可以從運行在公司代理後面的應用程式中獲得完全風格化和品牌化的PDF，包括需要身份驗證的環境和容器。完整的配置詳情請參見代理指南。

Curtis Chau

立即與工程團隊聊天

技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...

已更新 2026年7月5日

在 ASP.NET MVC 中生成 PDF：iTextSharp vs IronPDF 指南

比較在 ASP.NET MVC 中使用 iTextSharp vs IronPDF 的 PDF 產生方法。發現哪個函式庫能提供更好的 HTML 呈現以及更容易的實作。

已更新 2026年7月5日

ASP PDF 庫：比較 IronPDF、Aspose 和 Syncfusion

發現適用於 ASP.NET Core 應用程式的最佳 PDF 庫。比較 IronPDF 的 Chrome 引擎與 Aspose 和 Syncfusion 的替代方案。

已更新 2026年7月5日

PDF頁眉和頁腳：IronPDF與iTextSharp比較

比較 iTextSharp 和 IronPDF 在 PDF 中加入頁首和頁尾的功能。程式碼範例、頁碼和 HTML 標頭實作。

ASP PDF 庫：比較 IronPDF、Aspose 和 Syncfusion

Install with NuGetnuget.org/packages/IronPdf/

PM > Install-Package IronPdf

Install-Package IronPdf

客戶亮點：

開發者聚焦：

網路研討會：

開始免費30天試用

C# PDF程式庫

Ghostscript GPL vs IronPDF：技術比較指南

商業問題

解決方案

在代理後面渲染內部URL

需要計劃的要點

結果

相關文章

報告問題

產品連結

Iron 支援團隊

想要免費將Iron Suite
部署到實際專案嗎？

包含什麼？

立即免費取得 30 天試用金鑰。

Complete Your Trial Key Signup

您的授權金鑰已經發送到您的收件箱

Book a Free Live Demo

您的演示請求已提交。

受到全球數百萬工程師的信任

您已經使用NuGet安裝

您的瀏覽器正在下載

下一步：開始免費30天試用

Thank You