在 Linux 上使用 IronPDF

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

Curtis Chau

更新:2026年4月21日

Translated

View the article in English

IronPDF 支援 Linux 上的 .NET 10、9、8、7、6、5 及 .NET Core 應用程式，同時也支援 Docker、Azure、AWS、macOS 以及（當然）Windows。

官方支援的容器化與託管服務

官方支援的 Linux 發行版

關於 Linux 版 IronPDF 的提示

我們建議使用 .NET Core 8.0 以及微軟標示為 LTS 的任何其他執行環境，因為這些版本已獲得長期支援保證，且通常在 Linux 系統上經過充分測試。

在 Linux 上執行 IronPDF 無需進行任何程式碼變更。一般而言，IronPDF 經過工程師的廣泛測試與配置，開箱即用。

支援 Linux 至關重要，因為許多雲端服務（例如 Azure Web Apps、Azure Functions、AWS EC2、AWS Lambda 以及 Azure DevOps Docker）高度依賴 Linux。在 Iron Software，我們經常使用這些雲端工具，並深知我們的許多 Enterprise 及 SAAS 客戶亦是如此。

若需設定協助，請參閱我們關於在 Docker 上使用 IronPDF 的詳盡文件。您亦可透過 WSL 在 Windows 電腦上於 Linux 環境中使用 IronPDF，這也是另一種常見的選擇。

Linux 專用套件

NuGet

IronPdf.Linux

DLL 下載

若需離線使用，您可以下載 DLL 檔案並將其加入專案參考。

IronPdf.Linux.zip

有關 Linux 套件以及其他特定作業系統套件的文件，請參閱我們的 IronPDF 進階 NuGet 安裝指南。

官方支援的 Linux 發行版

我們正式支援並推薦以下最新的 64 位元 Linux 作業系統，以實現 IronPDF 的"零設定"安裝。

Ubuntu 24
Ubuntu 22
Ubuntu 20
Ubuntu 18
Ubuntu 16
Debian 11
Debian 10
CentOS 8
Fedora Linux 33
Amazon AWS Linux 2
Amazon AWS Linux 2023

若要在不受支援的 Linux 版本上安裝 IronPDF，請參閱本文末的"Linux 常見依賴項模式"。

硬體規格

IronPDF 採用 Chromium 引擎將 HTML 轉換為 PDF。 Chromium 引擎能以像素級精準度將 PDF 渲染至 Chrome 的 PRINT 功能中。硬體規格主要針對運行 Chromium 引擎而設計，這需要相當大的運算能力。

最低需求：1 核心處理器及 1.75 GB 記憶體
建議配置：2 核心及 8 GB 記憶體或更高規格

Linux 自動設定

將預設設定 LinuxAndDockerDependenciesAutoConfig 設為 true 後，系統將嘗試自動安裝所有 IronPDF 在 Linux 系統上運行所需的依賴項。這包括處理特定平台的套件差異，例如 Ubuntu 24.04 上的 libasound2t64。首次將 HTML 轉換為 PDF 的操作可能比平常耗時更久。

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

' Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

$vbLabelText $csharpLabel

Ubuntu 相容性

Ubuntu 是我們測試最廣泛的 Linux 作業系統，在 Azure 基礎架構中廣泛用於持續測試與部署。此平台亦提供官方 Microsoft .NET 支援及官方 Docker 映像檔。

Ubuntu 24

我們支援 Ubuntu 24（24.04 LTS），且無需任何設定。

支援基於 Chrome 的 HTML 轉 PDF 渲染引擎
正式支援 .NET 6 (LTS)、7、8、9 及 10 執行環境
每次發布前，須在此平台上執行超過 997 項單元測試

請注意Ubuntu 24.04 已將多個系統函式庫的名稱改為以 t64 為後綴。以下的手動設定反映了這些變更，例如 libasound2 現已變更為 libgtk2.0-0 現已變更為 libcups2 已變更為 libcups2t64，而 libatk-bridge2.0-0 已變更為 libatk-bridge2.0-0t64。）]

Ubuntu 24 手動設定指南

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libcups2t64
apt install -y libgtk2.0-0t64
apt install -y libnss3
apt install -y libatk-bridge2.0-0t64
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2t64
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libcups2t64
apt install -y libgtk2.0-0t64
apt install -y libnss3
apt install -y libatk-bridge2.0-0t64
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2t64
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Ubuntu 20

我們支援 Ubuntu 20，且無需任何設定。

支援基於 Chrome 和 WebKit 的 HTML 轉 PDF 渲染引擎
正式支援 .NET Core 3.1、5、6 (LTS)、7 及 8 執行環境
非官方支援 Ubuntu 20 上的許多其他 .NET Core 執行環境
每次發布前，須在此平台上執行超過 997 項單元測試

微軟官方 Docker 映像檔：

Ubuntu 20 手動設定指南

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Ubuntu 18

我們支援 Ubuntu 18，無需任何設定即可直接使用。

支援基於 Chrome 和 WebKit 的 HTML 轉 PDF 渲染引擎
正式支援 .NET Core 3.1 LTS 及 .NET 5 執行環境
非正式支援 Ubuntu 18 和 16 上的許多其他 .NET Core 執行環境
每次發布前，請在此平台上進行全面的煙霧測試

微軟官方 Docker 映像檔：

適用於 .NET Runtime 3.1 的 64 位元 Ubuntu 18.04 Docker 映像檔（'3.1-bionic'）
雖然 Ubuntu 18 尚未提供 .NET 5 的官方 Docker 映像檔，但其相容性極高。

Ubuntu 18 手動設定指南

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Ubuntu 16

我們對 Ubuntu 16 的支援有限。Microsoft 官方支援 Ubuntu 16 上的 .NET，且據許多使用者回報，其可與 IronPDF 正常運作。開發人員可能需要手動安裝額外的依賴項。

Chrome 和 WebKit 通常需透過手動設定才能運作。
.NET Core 3.1 LTS 和 .NET 5 執行環境已獲得微軟對 Ubuntu 16 的支援。
目前尚無適用於 Ubuntu 16.04 的官方 Microsoft Docker 映像檔。

Ubuntu 16 手動設定指南

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Debian 相容性

Debian 是我們測試次多的 Linux 作業系統。此平台亦提供官方 Microsoft .NET 支援及官方 Docker 映像檔。

Debian 11

我們開箱即用支援 Debian 11，且無需任何設定。

支援基於 Chrome 和 WebKit 的 HTML 轉 PDF 渲染引擎
正式支援 .NET Core 3.1、5、6 (LTS)、7 及 8 執行環境
非官方支援 Debian 11 上的許多其他 .NET Core 執行環境
每次發布前，須在此平台上執行超過 997 項單元測試

微軟官方 Docker 映像檔：

手動設定 Debian 11

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Debian 10

我們支援 Debian 10，且無需任何設定即可直接使用。

支援基於 Chrome 和 WebKit 的 HTML 轉 PDF 渲染引擎
正式支援 .NET Core 3.1、5、6 (LTS)、7 及 8 執行環境
非官方支援 Debian 10 上的許多其他 .NET Core 執行環境
每次發布前，須在此平台上執行超過 997 項單元測試

微軟官方 Docker 映像檔：

手動設定 Debian 10

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Debian 9 及更早版本

Debian 9 尚未經過官方測試，且無法直接與 IronPDF 配合使用。然而，Microsoft 官方支援在 Debian 9 上運行 .NET，只要設定正確，即可與 IronPDF 配合使用。請參閱文件末的《Linux 常見依賴模式》。

Microsoft 並未針對 Debian 9 提供 .NET Core 3.1 或 .NET 5.0 的官方 Docker 映像檔。我們強烈建議遷移至 Debian 10。

CentOS 相容性

我們積極支援 CentOS。

CentOS 8 支援

我們原生支援 CentOS 8，且無需任何設定。

支援基於 Chrome 和 WebKit 的 HTML 轉 PDF 渲染引擎
正式支援 .NET Core 3.1、5、6 (LTS)、7 及 8 執行環境
對 CentOS 上許多其他 .NET Core 執行環境提供非官方支援
每次發布前，請在此平台上進行全面的煙霧測試

遺憾的是，Microsoft 並未針對 CentOS 8 提供 .NET Core 3.1 或 .NET 5.0 的官方 Docker 映像檔。

CentOS 8 手動設定指南

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行：

設定 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

CentOS 7 及更早版本

CentOS 7 尚未經過測試，且無法直接與 IronPDF 配合使用。

然而，Microsoft 官方支援在 CentOS 7 上運行 .NET，若設定正確，應可與 IronPDF 正常運作。請閱讀下方的《Linux 常見依賴模式》。

Microsoft 並未針對 CentOS 7 上的 .NET Core 3.1 或 .NET 5.0 提供官方 Docker 映像檔。

Amazon AWS Linux 2 相容性

我們已支援 Amazon AWS Linux 2，該系統是 Amazon 雲端服務（如 EC2 和 Lambda）的基礎。

目前 Microsoft 尚未針對 Amazon AWS Linux 2 提供 .NET Core 3.1 或 .NET 5.0 的官方 Docker 映像檔。
在開發 IronPDF 的過程中，我們會手動測試其與 Amazon AWS Linux 2 的相容性。

建議您閱讀我們的 IronPDF AWS Lambda 指南，其中包含適用於 AWS Lambda 的 IronPDF 實用 Docker 檔案。

Amazon Linux 2 手動設定

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Update and install necessary libraries
yum update -y
yum install -y pango.x86_64
yum install -y libXcomposite.x86_64
yum install -y libXcursor.x86_64
yum install -y libXdamage.x86_64
yum install -y libXext.x86_64
yum install -y libXi.x86_64
yum install -y libXtst.x86_64
yum install -y cups-libs.x86_64
yum install -y libXScrnSaver.x86_64
yum install -y libXrandr.x86_64
yum install -y GConf2.x86_64
yum install -y alsa-lib.x86_64
yum install -y atk.x86_64
yum install -y gtk3.x86_64
yum install -y ipa-gothic-fonts
yum install -y xorg-x11-fonts-100dpi
yum install -y xorg-x11-fonts-75dpi
yum install -y xorg-x11-utils
yum install -y xorg-x11-fonts-cyrillic
yum install -y xorg-x11-fonts-Type1
yum install -y xorg-x11-fonts-misc
yum install -y glibc-devel.x86_64
yum install -y at-spi2-atk.x86_64
yum install -y mesa-libgbm.x86_64
yum install -y libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
yum update -y
yum install -y pango.x86_64
yum install -y libXcomposite.x86_64
yum install -y libXcursor.x86_64
yum install -y libXdamage.x86_64
yum install -y libXext.x86_64
yum install -y libXi.x86_64
yum install -y libXtst.x86_64
yum install -y cups-libs.x86_64
yum install -y libXScrnSaver.x86_64
yum install -y libXrandr.x86_64
yum install -y GConf2.x86_64
yum install -y alsa-lib.x86_64
yum install -y atk.x86_64
yum install -y gtk3.x86_64
yum install -y ipa-gothic-fonts
yum install -y xorg-x11-fonts-100dpi
yum install -y xorg-x11-fonts-75dpi
yum install -y xorg-x11-utils
yum install -y xorg-x11-fonts-cyrillic
yum install -y xorg-x11-fonts-Type1
yum install -y xorg-x11-fonts-misc
yum install -y glibc-devel.x86_64
yum install -y at-spi2-atk.x86_64
yum install -y mesa-libgbm.x86_64
yum install -y libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

請同時參閱我們關於官方支援 IronPDF for AWS Lambda 的文件，其中包含在 Amazon 雲端平台上的安裝與記錄日誌相關說明。

Amazon Linux 2023

Amazon Linux 2023 基於 Fedora 開發，並支援手動配置。其採用 dnf 作為套件管理器。

支援基於 Chrome 的 HTML 轉 PDF 渲染引擎
需手動安裝 libxkbcommon 及其他與 Fedora 相容的依賴項
我們在開發 IronPDF 時，會手動測試其與 Amazon Linux 2023 的相容性

建議設定

在 Amazon Linux 2023 上部署 IronPDF 時，建議採用以下設定：

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.CustomDeploymentDirectory = "/tmp";

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.CustomDeploymentDirectory = "/tmp";

Imports IronPdf

Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.AutomaticallyDownloadNativeBinaries = True
Installation.ChromeGpuMode = Engines.Chrome.ChromeGpuModes.Disabled
Installation.CustomDeploymentDirectory = "/tmp"

$vbLabelText $csharpLabel

Amazon Linux 2023 手動設定指南

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。依賴項清單遵循《Fedora Linux 手動設定指南》，並新增 libxkbcommon。

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence
dnf -y install libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence
dnf -y install libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Fedora Linux 相容性

Fedora Linux 支援開箱即用，無需任何設定。

支援基於 Chrome 和 WebKit 的 HTML 轉 PDF 渲染引擎
正式支援 .NET Core 3.1、5、6 (LTS)、7 及 8 執行環境
每次發布前，請在此平台上進行全面的煙霧測試

Fedora Linux 手動設定

若需手動安裝，或您的應用程式無法以 sudo 管理員權限執行。將 IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig 屬性設定為 false，並手動安裝依賴項。

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

Alpine Linux 相容性

不支援在 Alpine Linux 上執行 IronPDF。截至 2023 年，Alpine 仍使用過時的"musl"C 語言函式庫，這使得 Chromium 開發人員目前尚無法完全支援此作業系統。

在 .NET 6 中使用 Alpine Docker 與 IronPdfEngine

IronPDF 提供一個包含所有 IronPDF 功能的容器映像檔。這使在 Alpine 上運行的專案能夠透過連接 IronPdfEngine 容器來存取 IronPDF 的功能。

步驟 1：拉取並執行 IronPDF Engine Docker 映像檔

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

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

SHELL

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

建立一個針對 .NET 6 的新控制台應用程式。
使用 NuGet 套件管理員安裝 IronPdf.Slim NuGet 套件。

進一步了解如何使用 IronPdfEngine。

其他 Linux 發行版

您可透過 apt-get、hfs 及 yum 手動安裝 Linux 版的 IronPDF 先決條件。這讓您能夠在許多非官方支援的 Linux 發行版上使用 IronPDF。

首次安裝時，IronPDF 可能會拋出例外狀況，以通知您任何必要的系統依賴項。

文中提及的 IronCefSubprocess 是一個位於應用程式 bin 資料夾內的二進位檔。您可能需要指定確切的路徑，該路徑可能位於 runtimes 的 bin 子目錄中。
您可能需要 sudo 權限。

若您不確定如何處理未列出的 Linux 作業系統，請調查該作業系統上 Chromium 瀏覽器的依賴項。

如需針對其他 Linux 發行版申請官方支援，請聯絡 support@ironsoftware.com。

Linux 的常見依賴項模式

請參閱上文針對其他 Linux 作業系統的依賴套件。

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

SHELL

識別缺失的依賴項

ldd 是一款用於診斷缺少依賴項的強大工具。執行 ldd IronInterop.so 後，即可查看應用程式所需的所有共用函式庫清單。若函式庫旁出現"未找到"訊息（例如 libcef.so => not found），表示存在關鍵的依賴項缺失，將導致程式無法正常執行。 IronInterop.so 檔案位於特定作業系統的原生資料夾中。例如：bin/Debug/net6.0/runtimes/linux-x64/native。

ldd IronInterop.so

ldd IronInterop.so

SHELL

IronCefSubprocess

IronCefSubprocess 是位於應用程式 bin 資料夾內的二進位檔案。該程式碼需能由 .NET 程序執行。

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess

SHELL

常見問題

如何在 Linux 上的 C# 中將 HTML 轉換為 PDF？

您可以在 Linux 上使用 IronPDF 的 RenderHtmlAsPdf 方法在 Linux 上將 HTML 字串轉換為 PDF。這讓您能夠直接從 HTML 內容生成 PDF 文件。

在 Linux 上使用 PDF 函式庫的系統需求為何？

要在 Linux 上使用 IronPDF，最低硬體需求為 1 個核心和 1.75 GB 記憶體。為獲得最佳效能，建議配備 2 個核心和 8 GB 記憶體，並利用 Chromium 引擎進行渲染。

哪些 Linux 發行版與 PDF 生成工具相容？

IronPDF 支援 Ubuntu 24、22、20、18、16、Debian 11、10、CentOS 8、Fedora Linux 33、Amazon AWS Linux 2 及 Amazon AWS Linux 2023 進行 PDF 生成，提供無需配置的設定，實現無縫整合。

我可以在 Linux 上將 PDF 生成功能與 Docker 整合嗎？

是的，IronPDF 可在 Linux 系統上與 Docker 整合。將 LinuxAndDockerDependenciesAutoConfig 為 true，IronPDF 將嘗試自動安裝在 Docker 內執行所需的所有必要依賴項。

如何在 Linux 環境中安裝 PDF 生成工具？

請使用 NuGet 套件 IronPdf.Linux 在 Linux 上安裝 IronPDF，或從 IronPDF 網站下載 DLL 檔案。請確保所有依賴項已正確安裝，且 IronCefSubprocess 已設定為可執行檔。

哪些 .NET 版本適合在 Linux 平台上生成 PDF？

IronPDF 支援在 Linux 系統上使用 .NET 10、9、8、7、6、5 以及 .NET Core 進行 PDF 生成。為確保系統穩定性與效能，建議使用 .NET Core 3.1 等長期支援 (LTS) 版本。

在 Alpine Linux 上執行 PDF 生成是否可行？

由於與 musl C 函式庫的相容性問題，Alpine Linux 不支援直接使用 IronPDF。不過，透過 IronPdfEngine Docker 容器，可在 Alpine 上實現 PDF 功能。

若在 Linux 系統上使用 PDF 工具時遇到依賴項缺失錯誤，該如何處理？

若發生依賴項缺失的錯誤，請根據您所使用的 Linux 發行版要求，透過 apt-get、dnf 或 yum 等套件管理工具手動安裝必要的套件。

不受支援的 Linux 發行版能否使用 PDF 生成工具？

若要在不受支援的 Linux 發行版上使用 IronPDF，可透過手動安裝所需依賴項來實現。建議參考 Chromium 依賴項指南，以獲取手動安裝的相關指引。

如何在 Linux 環境中提升 PDF 生成效能？

若要在 Linux 上最佳化 IronPDF，請確保 LinuxAndDockerDependenciesAutoConfig 已啟用自動依賴項設定。請使用針對 Linux 優化的 NuGet 套件，並建立一個可供寫入的臨時檔案目錄。

是否有關於在 AWS Lambda 上設定 PDF 工具的特定指南？

是的，IronPDF 在其網站上提供了一份《AWS Lambda 設定指南》，其中詳細說明了如何在 AWS Lambda 環境中設定 IronPDF。

Curtis Chau

立即與工程團隊聯繫

技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？

Nuget 下載 19,014,616 | 版本： 2026.5 just released

檢視授權

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例觀看您的 HTML 轉為 PDF。

檢視授權

立即開始 30天試用

本頁內容

在 Linux 上使用 IronPDF

關於 Linux 版 IronPDF 的提示

Linux 專用套件

官方支援的 Linux 發行版

硬體規格

Linux 自動設定

Ubuntu 相容性

Ubuntu 24

Ubuntu 20

Ubuntu 18

Ubuntu 16

Debian 相容性

Debian 11

Debian 10

Debian 9 及更早版本

CentOS 相容性

CentOS 8 支援

CentOS 7 及更早版本

Amazon AWS Linux 2 相容性

Amazon Linux 2023

Fedora Linux 相容性

Alpine Linux 相容性

在 .NET 6 中使用 Alpine Docker 與 IronPdfEngine

其他 Linux 發行版

Linux 的常見依賴項模式

識別缺失的依賴項

IronCefSubprocess

常見問題

如何在 Linux 上的 C# 中將 HTML 轉換為 PDF？

在 Linux 上使用 PDF 函式庫的系統需求為何？

哪些 Linux 發行版與 PDF 生成工具相容？

我可以在 Linux 上將 PDF 生成功能與 Docker 整合嗎？

如何在 Linux 環境中安裝 PDF 生成工具？

哪些 .NET 版本適合在 Linux 平台上生成 PDF？

在 Alpine Linux 上執行 PDF 生成是否可行？

若在 Linux 系統上使用 PDF 工具時遇到依賴項缺失錯誤，該如何處理？

不受支援的 Linux 發行版能否使用 PDF 生成工具？

如何在 Linux 環境中提升 PDF 生成效能？

是否有關於在 AWS Lambda 上設定 PDF 工具的特定指南？

還在往下捲動嗎？

下一步：開始 30天試用

Thank You

下一步：開始 30天試用

Want to deploy IronSuite to a live project for FREE?

What’s included?

獲得全球數百萬工程師的信賴

鋼鐵支援團隊