IRONSOFTWAREHOME

在 Linux 上运行 IronPDF:设置指南

Curtis Chau
Curtis Chau
Updated: 2026年4月22日

Linux版IronPDF约为280MB(包括IronPDF代码和整个Chrome浏览器)。 Docker 镜像大约 500MB。

Chrome 还需要一些基本软件包,具体取决于您的 Linux 发行版。 大多数 Linux 发行版已经安装了这些软件包,因为它们被 Linux 中的各种应用程序和库使用。

但是,如果您使用的是精简发行版,则需要安装在 Linux 上运行 Chrome 所需的 Linux 软件包。

注意:为了简化调试,您可以设置以下内容:

// Enable detailed debugging for IronPdf
IronPdf.Logging.Logger.EnableDebugging = true;

// Specify the log file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to capture all log data
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

如何制作更小的 Docker 镜像

1. 在运行时安装软件包

一种减少大小的方法是在运行时而不是构建docker镜像时运行apt-get命令:

  1. 从您的Dockerfile中删除apt-get命令。
  2. 在初始化IronPDF或渲染文档之前设置Installation.LinuxAndDockerDependenciesAutoConfig = true;。
  3. 确保您的应用程序以足够的权限执行以运行apt-get命令。

注意:您的第一次初始化会较慢,因为在渲染第一个文档之前,apt-get命令必须完成,并且每次重新部署镜像时,此过程都会重复。

注意:您应看到控制台/日志条目指示成功的软件包安装:

Executing command 'apt install -y libnss3' in '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Reading package lists...
Building dependency tree...
Reading state information...
The following additional packages will be installed:
  libnspr4
The following NEW packages will be installed:
  libnspr4 libnss3
0 upgraded, 2 newly installed, 0 to remove and 9 not upgraded.
SHELL

2. 使用 IronPdf.Slim

您还可以选择_仅_包含 IronPDF.dll,并在运行时下载必要的文件。

  1. 从您的项目中删除IronPdf.Linux(及任何其他IronPDF)NuGet包,然后添加IronPdf.Slim。
  2. 在初始化IronPDF或渲染文档之前设置Installation.AutomaticallyDownloadNativeBinaries = true;。
  3. 确保您的Dockerfile授予您的应用程序整个工作目录的读取和写入权限(例如,将RUN chmod +rwx /app/)。

注意:由于 NuGet 包在渲染第一个文档之前需要下载并提取,您的首次初始化会较慢,并且每次必须重新部署镜像时,这个过程都会重复。

注意:您应看到控制台/日志条目指示成功下载和提取:

Downloading NuGet package from 'https://www.nuget.org/api/v2/package/IronPdf.Native.Chrome.Linux/2023.1.11387'
Extracting package contents '/app/bin/Debug/netcoreapp3.1/IronPdf.Native.Chrome.Linux.2023.1.11387.nupkg/runtimes/linux-x64/native' to '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Successfully deployed NuGet package 'IronPdf.Native.Chrome.Linux' to '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
Successfully located 'IronInterop' at '/app/bin/Debug/netcoreapp3.1/runtimes/linux-x64/native'
SHELL

3. 结论

总之,为减少_初始容器大小_:

  • 使用 IronPdf.Slim NuGet 包。
  • 配置IronPDF:
// Set installation options for Linux and Docker environments
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.AutomaticallyDownloadNativeBinaries = true;
  • 确保应用程序目录可写/可执行:
RUN chmod +rwx /app/
Text

结合使用第 1 点和第 2 点的一个非常精简的 Docker 镜像应将大小从约 500MB 减少到约 200MB。

如果可能,您将看到更好的性能,如果您不选择精简部署。

一些容器化和云环境是非持久的,因此可能需要偶尔重新下载依赖项或再次运行apt-get命令,这可能需要几分钟!

然而,我们理解某些开发人员可能面临其部署的严格大小要求。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

准备开始了吗?

Nuget Downloads 21,105,021版本:2026.9刚刚发布

立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

OR
bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
预约您的免费现场演示
Booking Badge

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

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起