將 IronPDF 新增至現有 Docker 容器

Curtis Chau

更新:12月 3, 2025

Translated

View the article in English

IronPDF for .NET Standard 現在完全支援 Docker，包括適用於 Linux 和 Windows 的 Azure Docker 容器。

您是否希望將 IronPDF 部署為單獨的 Docker 容器？了解更多關於IronPdfEngine 教學指南的資訊。

為什麼要在 Azure 上使用 Docker？

除了卓越的企業級可擴充性之外，Azure 上的 Docker 容器也比一般 Web 應用程式擁有更多權限。這使得它們能夠渲染 SVG 字體，因為系統已啟用對 GDI+ 圖形的存取權限。

IronPDF 和 Linux 入門

如果您是第一次接觸 Docker 與 .NET，我們推薦您閱讀這篇關於設定 Docker 偵錯和與 Visual Studio 專案整合的優秀文章。

我們也強烈建議您閱讀我們的IronPDF Linux 安裝和相容性指南。

IronPDF Linux Docker 安裝

使用 Linux 優化的 NuGet 套件

我們建議使用IronPDF.Linux NuGet 套件而不是常規的IronPDF包，以節省磁碟空間並避免在啟動 Docker 實例時下載資源。別擔心，在 Windows 或 macOS 上開發時仍然有效——它只是針對 Linux 進行了最佳化。

Install-Package IronPdf.Linux

另一種解決方案是在常規IronPDF NuGet 套件的基礎上新增IronPDF.Native.Chrome.Linux 。

Install-Package IronPdf.Native.Chrome.Linux

避免自動安裝依賴項

許多使用者反映，當LinuxAndDockerDependenciesAutoConfig設定為 false 時，Linux 和 Docker 的效能會提升。這是因為 Docker 檔案中的apt-get式套件管理器已經安裝了所需的先決條件。

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

禁用GPU加速

Linux Docker 容器通常無法存取 GPU。 GPU加速預設為禁用狀態。如果您已啟用ChromeGpuModes.Enabled ，我們強烈建議您在 Docker 部署中停用它：

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

' Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

$vbLabelText $csharpLabel

Ubuntu Linux Docker 文件

Ubuntu 22 及 .NET 8

Ubuntu 22 及 .NET 7

Ubuntu 20 和 .NET 6

Ubuntu 20 和 .NET 5

Ubuntu 20 搭載 .NET 3.1 LTS

Ubuntu 18 搭載 .NET 3.1 LTS

Debian Linux Docker 文件

Debian 12 和 .NET 8

Debian 11 和 .NET 7

Debian 11 及 .NET 6

Debian 11 及 .NET 5

Debian 11 及 .NET 3.1 LTS

Debian 10 和 .NET 5

Debian 10 及 .NET 3.1 LTS

Alpine Linux Docker 文件

不支援在 Alpine Linux 上執行 IronPDF。我們很想這麼做，但我們做不到。坦白說，我們很喜歡Alpine，希望這個計畫能夠繼續發展壯大。截至 2023 年，Alpine 仍然使用過時的"musl"C 語言庫，這使得 Chromium 開發人員無法完全支援該作業系統。

在 .NET 6 中使用 Alpine Docker 和 IronPdfEngine

IronPDF 提供了一個包含 IronPDF 所有功能的容器映像。這樣，在 Alpine 上運行的專案就可以透過連接到 IronPdfEngine 容器來存取 IronPD 功能。

步驟 1：拉取並執行 IronPDF 引擎 Docker 映像

在終端機中執行以下命令，拉取並執行 IronPDF Engine Docker 映像：

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine

SHELL

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

SHELL

步驟 2：設定控制台應用程式

建立面向 .NET 6 的新控制台應用程式。使用 NuGet 套件管理器安裝 IronPdf.Slim NuGet 套件。

Windows Docker 文件

Windows Docker 容器在 Azure 上越來越受歡迎，因為它們提供了更高的效能和可擴充性，並賦予開發人員更多配置執行個體的權限。

由於對圖形庫和虛擬顯示卡的存取權限更高，IronPDF 實際上可以在 Azure 上的 Docker 容器（Windows 或 Linux）中執行更具吸引力的文字渲染。

文章《 Visual Studio Docker容器工具》是一篇非常棒的入門指南。

這是一個適用於 .NET Core 3.1 的 Windows 容器 Dockerfile 範例。

Windows Server 2019 .NET 6.0

預先配置的 Windows 容器包含執行 IronPDF 所需的所有相依性。

請注意，這些容器並非用於建立 .NET 應用程序，而是用於運行它們。

存取Docker 儲存庫，探索更多用於執行 IronPDF 的預先配置映像。

常見問題解答

如何將 .NET 庫集成到 Docker 容器中進行 PDF 生成？

您可以使用 IronPDF，這是一個 .NET 庫，通過使用微軟的官方 Docker 圖像和適用於 Linux 的 IronPdf.Linux NuGet 套件，或適用於 Windows 環境的預配置 Windows Docker 容器，將其集成到 Docker 容器中。

使用 Docker 容器進行 Azure 上的 PDF 操作有什麼好處？

在 Azure 上使用 Docker 容器進行 PDF 操作提供了增強的企業級擴展性和比常規網絡應用程序更多的許可權。此設置非常適合啟用諸如通過 GDI+ 圖形訪問的 SVG 字體渲染等高級功能。

哪些 Linux 發行版最適合在 Docker 中運行 .NET PDF 庫？

最合適的 Linux 發行版包括 Ubuntu 18/20/22、Debian 10/11、CentOS 8 和 Amazon AWS Linux 2，它們提供了直接的配置和兼容性。

如何優化 .NET PDF 庫在 Linux Docker 容器中的性能？

要優化性能，請使用 IronPdf.Linux 套件，禁用自動依賴安裝，並通過配置 IronPdf.Installation.ChromeGpuMode 為 IronPdf.Engines.Chrome.ChromeGpuModes.Disabled 關閉 GPU 加速。

IronPDF 能夠在 Docker 容器中的 Alpine Linux 上運行嗎？

IronPDF 由於不兼容的 'musl' 庫，無法本地支持 Alpine Linux。若要在 Alpine Linux 上使用 IronPDF，請考慮通過 IronPdfEngine Docker 容器運行它。

使用預配置 Docker 容器的目的是什麼？

預配置 Docker 容器提供運行 IronPDF 所需的所有依賴，確保高性能和高擴展性，這在像 Azure 這樣的平台上部署時特別有益。

如何為 Docker 中的 .NET 應用程序配置 .NET PDF 庫？

通過將它與 Linux 和 Windows Docker 容器集成，可以為 Docker 中的 .NET 應用程序配置 IronPDF，從而在微服務架構中啟用穩健的 PDF 功能。

部署 .NET 庫在 Docker 的推薦設置步驟有哪些？

推薦的步驟包括使用優化的 Linux 套件如 IronPdf.Linux、禁用自動依賴安裝以及預先初始化 IronPDF 以防止 Docker 環境中的運行時延遲。

如何在運行 .NET 6.0 的 Windows Server 2019 Docker 容器中設置 .NET PDF 庫？

通過使用包含所有必要依賴和配置的預配置 Dockerfile，可以在 Windows Server 2019 Docker 容器中設置 .NET PDF 庫以運行 IronPDF 與 .NET 6.0。

為什麼在 Docker 設置中禁用 .NET 庫的 GPU 加速？

為 IronPDF 在 Docker 中禁用 GPU 加速可以通過避免環境中圖形資源有限時可能存在的問題來實現更平滑的部署和性能。