在Linux上使用IronPDF

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

Curtis Chau

已更新:2026年6月3日

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，我們經常使用這些雲端工具，並且了解到許多我們的企業和SAAS客戶也這樣做。

如果您需要設置幫助，可以閱讀我們如何在Docker上使用IronPDF的詳細文件。您也可以從Windows的WSL運行IronPDF到Linux，這是另一個熱門選擇。

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的列印功能。硬體規格主要是為了運行Chromium引擎，這需要巨大的計算能力。

最低要求：1個核心和1.75 GB的RAM
推薦要求：2個核心和8 GB或更多的RAM

Linux自動設置

預設設置true將嘗試自動安裝Linux上運行IronPDF所需的所有依賴項。這包括處理平台特定的套件差異，例如Ubuntu 24.04上的libasound2t64。第一次的HTML到PDF操作可能會比平時花更長的時間。

:path=/static-assets/pdf/content-code-examples/get-started/linux-1.cs

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

$vbLabelText $csharpLabel

Ubuntu相容性

Ubuntu是我們測試最多的Linux操作系統，在Azure基礎設施中大量使用以進行連續測試和部署。此平台也有微軟.NET支持和官方Docker映像。

Ubuntu 24

我們支持Ubuntu 24 (24.04 LTS)的零配置。

支持Chrome為基礎的HTML到PDF渲染引擎
官方支持.NET 6 (LTS), 7, 8, 9和10運行時
在每次發佈前對此平台進行超過997個單元測試

請注意Ubuntu 24.04重命名了若干系統庫，以強調t64後綴。下述手動設置反映了這些更改，例如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映像：

64位Ubuntu 18.04 Docker映像，用於.NET運行時3.1 ("3.1-bionic")
雖然沒有官方Docker映像用於Ubuntu 18上的.NET 5，但相容性非常高。

手動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的支持有限。微軟官方在Ubuntu 16上支持.NET，並且據報告與IronPDF相容。開發人員可能需要手動安裝額外的依賴項。

Chrome和WebKit通常需要手動配置運行。
.NET Core 3.1 LTS和.NET 5運行時在Ubuntu 16上獲得微軟支持。
目前沒有微軟官方的Ubuntu 16 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操作系統。此平台也有微軟.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。 .NET在Debian 9由微軟官方支持，正確設置後可與IronPDF配合工作。請參閱本文件末尾的Linux的常見依賴模式。

微軟沒有針對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運行時
在每次發佈前對此平台進行全面冒煙測試

遺憾的是，微軟沒有針對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。

.NET在CentOS 7由微軟官方支持，若正確設定，可能與IronPDF配合運行。請閱讀下方的Linux的常見依賴模式。

微軟沒有針對CentOS 7提供官方的.NET Core 3.1或.NET 5.0 Docker映像。

Amazon AWS Linux 2相容性

我們擁有Amazon AWS Linux 2的工作支援，這構成了Amazon的雲端服務如EC2和Lambda的基礎。

微軟沒有針對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

請閱讀我們的官方支持Amazon云平台上的IronPDF for AWS Lambda文件，其中包括安裝和日誌。

Amazon Linux 2023

Amazon Linux 2023基於Fedora, 並支持手動配置。它使用dnf作為其套件管理器。

支持Chrome為基礎的HTML到PDF渲染引擎
需要手動安裝libxkbcommon和其他相容Fedora的依賴
我們手動測試Amazon Linux 2023的相容性，隨著IronPDF的開發

推薦配置

在Amazon Linux 2023上部署IronPDF時推薦以下設置：

:path=/static-assets/pdf/content-code-examples/get-started/linux-10.cs

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開發者尚無法完全支援此OS。

在.NET 6中使用Alpine Docker與IronPdfEngine

IronPDF提供了一個包含所有IronPDF功能的容器鏡像。這使得在Alpine上運行的專案可以通過連接到IronPdfEngine容器來存取IronPDF的功能。

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

在您的終端中執行以下命令來提取並運行IronPDF引擎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手動安裝IronPDF的Linux所需條件。這允許您在許多非官方支持的Linux發行版上使用IronPDF。

在第一次安裝時，IronPDF可能會拋出異常告知您任何必要的系統依賴。

提到的IronCefSubprocess是您應用程式bin資料夾中的一個二進位檔。您可能需要指定確切路徑，這可能在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 =>未找到，表示存在關鍵缺失的依賴項，將阻止程式正確運行。 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？

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

在Linux上使用PDF程式庫的系統要求是什麼？

在Linux上使用IronPDF的最低硬體要求為1個核心和1.75 GB的RAM。為了獲得最佳性能，建議使用2個核心和8 GB的RAM，利用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或從IronPDF網站下載DLL在Linux上安裝IronPDF。確保所有依賴項已正確安裝，並設置IronCefSubprocess為可執行檔。

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

IronPDF支持.NET 10、9、8、7、6、5和.NET Core在Linux平台上生成PDF。建議使用諸如.NET Core 3.1的長期支持版本(LTS)以確保穩定性和性能。

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

由於與musl C庫的相容性問題，IronPDF在Alpine Linux上不直接支持。但是，使用IronPdfEngine Docker容器可以促成在Alpine上的PDF功能。

如果在Linux上使用PDF工具時遇到缺少依賴項的錯誤，我應該怎麼辦？

如果發生缺少依賴項的錯誤，根據您的Linux發行版的需求，使用包管理器如apt-get、dnf或yum手動安裝必要的套件。

不支持的Linux發行版可以使用PDF生成工具嗎？

IronPDF可以通過手動安裝所需的依賴項在不支持的Linux發行版上使用。建議查詢Chromium的依賴項以取得有關手動安裝的指導。

如何提升Linux環境中的PDF生成性能？

為了優化Linux上的IronPDF，啟用LinuxAndDockerDependenciesAutoConfig以進行自動依賴項設置。使用Linux優化的NuGet套件並建立可寫的目錄以存放臨時文件。

是否有專門為AWS Lambda設置PDF工具的指南？

有的，IronPDF在其網站上提供了一份AWS Lambda設置指南，提供有關在AWS Lambda環境中配置IronPDF的詳細說明。

Curtis Chau

立即與工程團隊聊天

技術作家

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

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？

Nuget 下載 19,936,792 | 版本： 2026.7 剛剛發布

查看授權

還在捲動嗎？

想快速獲得證明嗎？ 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?

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

您的演示請求已進入。

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

Iron 支援團隊