Using IronPDF on Linux

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

IronPDF 支持适用于 .NET 10, 9, 8, 7, 6, 5.NET Core 的 Linux 应用程序,还支持 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

IronPDF 在 Linux 上的使用技巧

我们推荐使用 .NET Core 8.0 和其他任何被 微软标记为 LTS 的运行时 ,因为它们具有保证的长期支持,并且通常在 Linux 上经过良好测试。

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

Linux 支持很重要,因为许多云服务如 Azure Web 应用、Azure Functions、AWS EC2、AWS Lambda 和 Azure DevOps Docker 严重依赖 Linux。 在 Iron Software,我们定期使用这些云工具,并且了解很多企业和 SaaS 客户也这样做。

如果您在设置时需要帮助,请阅读我们的 IronPDF on Docker 使用广泛文档。您也可以在 Windows 机器的 WSL 上使用 IronPDF 运行 Linux,这是另一个流行的选项。

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 引擎以与 Chrome 打印功能完全一致的精度渲染 PDF。 硬件规格主要是为了运行 Chromium 引擎,它需要相当多的计算能力。

  • 最低:1 核 & 1.75 GB 内存
  • 推荐:2 核 & 8 GB 内存或更高

Linux 自动设置

将默认设置 LinuxAndDockerDependenciesAutoConfig 设置为 true,将尝试自动安装所有依赖项,以便 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 的支持有限。Ubuntu 16 上的 .NET 得到微软的正式支持,并且许多用户报告 IronPdf 可以正常工作。 开发者可能需要手动安装其他依赖项。

  • ChromeWebKit 通常需要手动配置才能正常工作。
  • .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 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 运行时提供非官方支持
  • 在每次发布之前在该平台上进行全面的冒烟测试

不幸的是,没有用于 .NET Core 3.1 或 .NET 5.0 在 CentOS 8 上的官方 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 一起工作。

不过,如果设置正确,CentOS 7 上的 .NET 得到微软的正式支持,并且可能可以与 IronPdf 搭配工作。 请阅读下面的 Linux 的常见依赖模式

没有用于 .NET Core 3.1 或 .NET 5.0 在 CentOS 7 上的官方 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 的基础。

  • 没有用于 .NET Core 3.1 或 .NET 5.0 在 Amazon AWS Linux 2 上的官方 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

请阅读我们有关在 Amazon 云平台上安装和记录的官方支持 IronPdf for AWS Lambda 的文档。

Fedora Linux 兼容性

Fedora Linux 开箱即用 "零配置" 支持。

  • 支持 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 中使用 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-gethfsyum 手动安装 Linux 的 IronPDF 先决条件。 这允许您在许多非官方支持的 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,您可以查看应用程序所需的所有共享库的列表。 在库旁边显示 "not found" 信息,如 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方法將 HTML 字串轉換為 PDF 檔案。這樣,您就可以直接從 HTML 內容產生 PDF 文件。

在Linux系統上使用PDF庫有哪些系統需求?

在 Linux 系統上使用 IronPDF 的最低硬體需求是 1 個 CPU 核心和 1.75 GB 記憶體。為了獲得最佳效能,建議使用 2 個 CPU 核心和 8 GB 內存,並利用 Chromium 引擎進行渲染。

哪些Linux發行版與PDF產生工具相容?

IronPDF 支援 Ubuntu 22、20、18、16、Debian 11、10、CentOS 8、Fedora Linux 33 和 Amazon AWS Linux 2 產生 PDF 文件,提供零配置設定以實現無縫整合。

我可以在Linux系統上將PDF產生功能與Docker整合嗎?

是的,IronPDF 可以與 Linux 上的 Docker 整合。透過將LinuxAndDockerDependenciesAutoConfig設為 true,IronPDF 將嘗試自動安裝所有在 Docker 中執行所需的依賴項。

如何在Linux環境下安裝PDF產生工具?

在 Linux 系統上安裝 IronPDF 時,可以使用 NuGet 套件 IronPdf.Linux,或從 IronPDF 網站下載 DLL 檔案。確保所有相依性都已正確安裝,並且IronCefSubprocess已設定為執行檔。

哪些 .NET 版本適合在 Linux 平台上產生 PDF 檔案?

IronPDF 支援在 Linux 系統上使用 .NET 10、9、8、7、6、5 和 .NET Core 來產生 PDF 檔案。為了獲得更好的穩定性和效能,建議使用長期支援 (LTS) 版本,例如 .NET Core 3.1。

在 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生成效能?

為了優化 IronPDF 在 Linux 上的運行,請確保啟用LinuxAndDockerDependenciesAutoConfig以自動設定依賴項。使用針對 Linux 最佳化的 NuGet 套件,並建立一個可寫入目錄用於存放臨時檔案。

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

是的,IronPDF 在其網站上提供了 AWS Lambda 設定指南,其中詳細說明如何配置 IronPDF 以便在 AWS Lambda 環境中使用。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 16,154,058 | 版本: 2025.11 剛剛發布