在 Linux 上运行 IronPDF:设置指南

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

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

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

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

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

// 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/
Dockerfile

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

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

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

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

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

阅读更多

准备开始了吗?

Nuget Downloads 21,916,531版本:2026.11刚刚发布