Using IronPDF on Linux

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF 支持 Linux 上的 .NET 10, 9, 8, 7, 6, 5.NET Core 应用程序,以及 Docker、Azure、AWS、macOS,以及(当然)Windows。

正式支持的容器化和托管

Linux V1 related to Using IronPDF on LinuxDocker related to Using IronPDF on LinuxAzure 1 related to Using IronPDF on LinuxAmazon Web Services related to Using IronPDF on Linux

正式支持的 Linux 发行版

Ubuntu V1 related to Using IronPDF on LinuxDebian V1 related to Using IronPDF on LinuxCentos V1 related to Using IronPDF on Linux

Linux 上 IronPDF 的技巧

我们推荐使用 .NET Core 8.0 和其他由 微软认证为 LTS 的版本,因为它们在 Linux 上有长期支持,并且经过了良好的测试。

在 Linux 上运行 IronPDF 不需要代码更改。 通常情况下,由于我们工程师的广泛测试和配置,IronPDF 开箱即用。

Linux 支持很重要,因为许多云服务,如 Azure Web 应用程序、Azure 函数、AWS EC2、AWS Lambda 和 Azure DevOps Docker,都严重依赖于 Linux。 在 Iron Software,我们定期使用这些云工具,并理解我们的许多企业客户和 SAAS 客户也会使用这些工具。

阅读我们的 使用 IronPDF 的 Docker 上的广泛文档,如果您需要帮助设置。您还可以在 Windows 机器上通过 WSL 在 Linux 上使用 IronPDF,这是另一个受欢迎的选项。

Linux 特定包

NuGet

DLL 下载

对于离线使用,可以下载 DLL 并将其添加为项目的引用。

关于 Linux 包和许多其他特定操作系统的包的文档可以在我们的 IronPDF 高级 NuGet 安装指南 中找到。

正式支持的 Linux 发行版

我们正式支持并推荐使用以下最新的64 位 Linux 操作系统,以便 "零配置 "设置 IronPDF。

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

如果在不支持的 Linux 版本上安装 IronPDF,请参阅本文档末尾的 Linux 的常见依赖模式

硬件规格

IronPDF 使用 Chromium 来将 HTML 渲染为 PDF。 Chromium 引擎以像素完美的精度将 PDF 渲染为 Chrome 的打印功能。 硬件规格主要是为运行 Chromium 引擎提供计算能力。

  • 最低:1 个内核和 1.75 GB 内存
  • 推荐:2 个内核和 8 GB 内存或以上

Linux 自动设置

默认设置 LinuxAndDockerDependenciesAutoConfigtrue,将尝试自动安装所有 IronPDF 在 Linux 上运行所需的依赖项。 第一次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 20

Microsoft related to Ubuntu 20Ubuntu V1 related to Ubuntu 20Chrome V1 related to Ubuntu 20Safari V1 related to Ubuntu 20Docker related to Ubuntu 20Azure 1 related to Ubuntu 20

我们支持 Ubuntu 20 的 零配置

  • 支持 ChromeWebKit 基于 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

Microsoft related to Ubuntu 18Ubuntu V1 related to Ubuntu 18Chrome V1 related to Ubuntu 18Safari V1 related to Ubuntu 18Docker related to Ubuntu 18Azure 1 related to Ubuntu 18

我们的 Ubuntu 18 出厂即用,无需配置。

  • 支持 ChromeWebKit 基于 HTML 的 PDF 渲染引擎
  • 官方支持 .NET Core 3.1 LTS.NET 5 运行时
  • 非官方支持 Ubuntu 18 和 16 上的许多其他 .NET Core 运行时
  • 在发布前对该平台进行综合冒烟测试

官方微软 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 V1 related to Ubuntu 16Test related to Ubuntu 16

我们对 Ubuntu 16 的支持有限。即便如此,微软官方支持 .NET 在 Ubuntu 16 上的运行,而许多用户报告称其可以与 IronPdf 一同工作。 开发者可能需要手动安装其他依赖项。

  • ChromeWebKit 通常可以通过手动配置来工作。
  • 微软已为 Ubuntu 16 提供 .NET Core 3.1 LTS.NET 5 运行时 的支持。
  • 目前没有用于 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 related to Debian 11Microsoft related to Debian 11Chrome V1 related to Debian 11Safari V1 related to Debian 11Docker related to Debian 11Azure 1 related to Debian 11

我们的 Debian 11 出厂即用,无需配置。

  • 支持 ChromeWebKit 基于 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 related to Debian 10Microsoft related to Debian 10Chrome V1 related to Debian 10Safari V1 related to Debian 10Docker related to Debian 10Azure 1 related to Debian 10

我们的 Debian 10 出厂即用,无需配置。

  • 支持 ChromeWebKit 基于 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 related to Debian 9 和更低版本Test related to Debian 9 和更低版本

Debian 9 未经过官方测试,不会与 IronPdf 开箱即用。 然而,微软官方支持 Debian 9 上的 .NET,如果正确设置,可能与 IronPdf 一起使用。 请参阅本文档结尾处的 Linux 的常见依赖模式

没有用于 Debian 9 的 .NET Core 3.1 或 .NET 5.0 的官方微软 Docker 镜像。我们强烈建议迁移到 Debian 10。

CentOS 兼容性

Centos related to CentOS 兼容性Chrome V1 related to CentOS 兼容性Safari V1 related to CentOS 兼容性Test related to CentOS 兼容性

我们积极支持 CentOS。

CentOS 8 支持

我们的 CentOS 8 出厂即用,无需配置。

  • 支持 ChromeWebKit 基于 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 Web Services related to Amazon AWS Linux 2 兼容性Chrome V1 related to Amazon AWS Linux 2 兼容性Safari V1 related to Amazon AWS Linux 2 兼容性Test related to 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 指南,其中包含 IronPdf 在 AWS Lambda 上的工作 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 云平台上的安装和日志记录。

Fedora Linux 兼容性

Fedora Linux 与 IronPDF 兼容,无需配置。

  • 支持 ChromeWebKit 基于 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 中使用 IronPdfEngine 的 Alpine Docker

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-gethfsyum 手动安装 IronPDF 的 Linux 先决条件。 这允许您在许多非官方支持的 Linux 发行版上使用 IronPDF。

在初次安装过程中,IronPDF 可能会抛出异常以通知您任何必要的系统依赖项。

  • 提到的 IronCefSubprocess 是您应用程序的 bin 文件夹内的一个二进制文件。 您可能需要指定一个确切的路径,该路径可能位于 binruntimes 子目录中。
  • 您可能需要 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 22、20、18、16,Debian 11、10,CentOS 8,Fedora Linux 33 和 Amazon AWS Linux 2 用于 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 下载 16,154,058 | 版本: 2025.11 刚刚发布