在 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 支持 .NET 10、9、8、7、6、5 及 .NET Core 应用程序在 Linux 上的运行，同时也支持 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 基础设施中被广泛用于持续测试和部署。该平台还提供微软官方 .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 现改为 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 手动设置指南

# 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 手动设置指南

# 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 的官方 Microsoft Docker 镜像。

Ubuntu 16 手动设置

# 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 手动安装指南

# 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 手动安装指南

# 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 运行时
在每次发布前，需在此平台上进行全面的烟雾测试

遗憾的是，微软尚未为 CentOS 8 上的 .NET Core 3.1 或 .NET 5.0 提供官方 Docker 镜像。

CentOS 8 手动安装指南

如果需要手动安装，或者您的应用程序无法使用 sudo 管理员权限运行：

Set 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 配合使用。

不过，CentOS 7 上的 .NET 受微软官方支持，若配置正确，应可与 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 手动安装指南

# 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 手动安装指南

# 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？

您可以使用 IronPDF 的 RenderHtmlAsPdf 方法将 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 上与 Docker 集成 PDF 生成吗？

是的，IronPDF 可以与 Linux 上的 Docker 集成。通过将 LinuxAndDockerDependenciesAutoConfig 设置为 true，IronPDF 将尝试自动安装运行所需的所有依赖项以在 Docker 中运行。

如何在 Linux 环境中安装 PDF 生成工具？

使用 NuGet 包 IronPdf.Linux 安装 IronPDF，或者从 IronPDF 网站下载 DLL。确保所有依赖项已正确安装并将 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 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 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 上与 Docker 集成 PDF 生成吗？

如何在 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?

深受全球数百万工程师信赖

钢铁支援团队