ironsoftwareofficial/ironpdfengine

IronPDF Docker容器文档

镜像概述和主要用途

IronPdfEngine是一个gRPC服务，可处理PDF的创建、写入、编辑和读取。IronPDF Docker提供现成可用的Docker服务，兼容IronPDF v2023.2.x及以上版本，帮助开发人员解决IronPDF部署过程中可能遇到的问题。目前支持Java和.NET开发平台。

注意：仅适用于IronPDF v2023.2.x及以上版本

核心功能和特性

减少客户端体积

IronPDF需依赖Chrome和Pdfium二进制文件（数百MB）及多个系统依赖。使用Docker容器后，客户端体积仅占MB级空间，大幅减小应用体积。

避免部署问题

手动配置环境以包含所有依赖项十分困难。Docker容器中IronPDF已预安装并验证可用，彻底消除部署和依赖配置难题。

避免严重段错误

完全缓解部分用户在Linux容器中运行IronPdf时遇到的严重段错误问题，提升运行稳定性。

版本说明

Docker镜像标签基于IronPdfEngine版本，与IronPDF产品版本需严格匹配。每个IronPDF版本对应特定IronPdfEngine版本，版本号不允许 mismatch。

示例：IronPDF for Java 2023.2.1需匹配IronPdfEngine 2023.2.1，不可混用不同版本。

使用场景和适用范围

适用于Java/.NET项目中需使用IronPDF处理PDF，但希望避免依赖管理和部署问题的场景，特别适合Linux容器环境或对应用体积有严格要求的项目。

使用方法和配置说明

Java项目使用指南

步骤1：安装IronPDF

通过Maven添加依赖：

xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

更多信息：IronPDF Java文档

步骤2：确定容器版本

默认与项目中IronPDF版本匹配，也可通过代码获取：

java
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();

步骤3：部署Docker容器

拉取并运行对应版本镜像：

bash
docker pull ironsoftwareofficial/ironpdfengine
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

容器默认内部端口：33350

步骤4：配置客户端

添加以下代码指定引擎：

java
Settings.useIronPdfEngineDocker(33350);

移除项目中com.ironsoftware:ironpdf-engine-xxxx-xx依赖包

步骤5：使用

运行IronPDF代码，应用将通过Docker容器处理PDF任务。

.NET项目使用指南

步骤1：安装IronPDF

安装NuGet包IronPdf.Slim： NuGet包地址

注意：IronPdf、IronPdf.Linux和IronPdf.MacOs包已包含IronPdf.Slim。建议仅安装IronPdf.Slim以减小体积，并移除IronPdf.Native.Chrome.xxx依赖包。

更多信息：IronPDF文档

步骤2：确定容器版本

默认与NuGet包版本匹配，也可通过代码获取：

csharp
string ironPdfEngineVersion = Installation.IronPdfEngineVersion();

步骤3：部署Docker容器

3.1 无Docker Compose

bash
docker pull ironsoftwareofficial/ironpdfengine
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

3.2 有Docker Compose

1. 创建专用网络：

bash
docker network create -d bridge --attachable --subnet=172.19.0.0/16 --gateway=172.19.0.1 ironpdf-network

2. 启动容器（含许可证配置）：

bash
docker run -d -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY --network=ironpdf-network --ip=172.19.0.2 --name=ironpdfengine --hostname=ironpdfengine -p 33350:33350 ironsoftwareofficial/ironpdfengine:2023.2.1

3. Docker Compose配置示例：

yaml
version: "3.3"

services:
  ironpdfengine:
    container_name: ironpdfengine
    image: ironsoftwareofficial/ironpdfengine:latest
    networks:
      ironpdf-network:
        ipv4_address: 172.19.0.2
  myconsoleapp:
    container_name: myconsoleapp
    build:
      context: ./MyConsoleApp/  # 替换为项目目录
      dockerfile: Dockerfile    # 替换为Dockerfile名称
    networks:
      ironpdf-network:
        ipv4_address: 172.19.0.3
    depends_on:
      ironpdfengine:
        condition: service_started

networks:
  ironpdf-network:
    driver: bridge
    ipam:
      config:
        - subnet: 172.19.0.0/16
          gateway: 172.19.0.1

4. 启动服务：

bash
docker compose up --detach --force-recreate --remove-orphans --timestamps

步骤4：配置客户端

添加以下代码启用Docker引擎：

csharp
Installation.UseIronPdfEngineDocker();

步骤5：使用

应用将通过Docker容器处理PDF任务，测试代码示例：

csharp
Installation.UseIronPdfEngineDocker();
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF Docker!</h1>");
pdf.SaveAs("ironpdf.pdf");

更多资源

访问IronPDF Docker文档获取详细使用指南。