Run IronPDF as a Remote Container

不使用 Docker Compose

使用上一步中的版本運行 docker 容器。

• 必須安裝 Docker。

設置

1. 轉到 https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine
2. 提取最新的 ironsoftwareofficial/ironpdfengine 映像

docker pull ironsoftwareofficial/ironpdfengine

docker pull ironsoftwareofficial/ironpdfengine

或者提取具體版本（推薦）

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

docker pull ironsoftwareofficial/ironpdfengine:2025.3.6

3. 運行 ironsoftwareofficial/ironpdfengine 容器。

此命令將創建一個容器並在背景中運行，端口為 33350

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

docker run -d -p 33350:33350 -e IRONPDF_ENGINE_LICENSE_KEY=MY_LICENSE_KEY ironsoftwareofficial/ironpdfengine:2025.3.6

使用 Docker Compose

關鍵是設置一個允許 IronPdfEngine 和您的應用程序彼此通信的 Docker 網絡。 設置 'depends_on' 以確保 IronPdfEngine 在應用程序啟動之前上線。

設置

1.首先創建一個 docker-compose.yml 文件。使用以下模板設置Docker Compose 文件：

version: '3.6'
services:
  myironpdfengine:
    container_name: ironpdfengine
    image: ironsoftwareofficial/ironpdfengine:latest
    ports:
      - '33350:33350'
    networks:
      - ironpdf-network
  myconsoleapp:
    container_name: myconsoleapp
    build:
      # enter YOUR project directory path here
      context: ./MyConsoleApp/
      # enter YOUR dockerfile name here, relative to project directory
      dockerfile: Dockerfile
    networks:
      - ironpdf-network
    depends_on:
      myironpdfengine:
        condition: service_started
networks:
  ironpdf-network: 
    driver: 'bridge'

1. 將 IronPdfEngine 的地址設置在您的應用 (myconsoleapp) 中為 "myironpdfengine:33350"
2. 運行 docker compose

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

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

您可以根據您想要進行的連接類型指定多個 IronPdfConnectionType。

以下是可用屬性的列表：

本地可執行：要連接到在本地機器上運行可執行文件的 IronPdfEngine“server”，我們使用此選項。 一個簡單的例子是一個 WinForm 發票應用，它在本地生成 PDF，而不依賴於雲服務。

Docker：此選項應該在嘗試本地或雲端連接到 Docker 容器時使用。

遠程服務器：此選項用於雲端的 IronPdfEngine。 這會通過 HTTP 或 HTTPS 協議連接到雲託管 (例如 Docker) IronPdfEngine 實例。 請注意，因為這是連接到遠程服務器，所以需要完整的 URL（包括 HTTP 或 HTTPS 協議）。

自定義：要對連接進行完全控制和自定義，您可以使用此選項。 此選項使用您自定義定義的 Grpc.Core.ChannelBase，而不是上述其他定義選項。 開發人員可以通過創建新的 Grpc.Core.Channel 對象或使用 Grpc.Net.Client.GrpcChannel.ForAddress(System.String) 來創建新的通道以完全控制gRPC 通道。

.NET Framework 與 NetFrameworkChannel

對於 .NET Framework，我們需要不同的設置，因為 gRPC 在 .NET Framework 項目中工作方式不同。 要使該方法生效，請確保安裝了 Grpc.Core NuGet 套件。 我們將使用從 Grpc.Core.ChannelBase 衍生出的客製 gRPC 通道進行此特殊設置。

讓我們來看看這個例子，在這裡我們將實現連接通道以使用 IronPDFEngine 創建和保存 PDF。

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc.cs

using IronPdf;

// This code demonstrates how to use IronPdf with gRPC in a .NET Framework application.

// 1. Configure connection to use local IronPdfEngine executable
var config = IronPdf.GrpcLayer.IronPdfConnectionConfiguration.Executable;

// 2. Connect to the IronPDF host with the executable configuration
IronPdf.Installation.ConnectToIronPdfHost(config);

// 3. Create a PDF renderer instance
ChromePdfRenderer renderer = new ChromePdfRenderer();

// 4. Render HTML string as PDF document
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

IRON VB CONVERTER ERROR developers@ironsoftware.com

使用 WithCustomChannel 的替代方法

一個替代的方法是利用 IronPdf.GrpcLayer 提供的 WithCustomChannel 方法。

WithCustomChannel 方法將接受兩個參數，customChannel 是您自定義的 gRPC 通道，metadata。 metadata 參數是可選的，默認設置為 null。

:path=/static-assets/pdf/content-code-examples/how-to/ironpdfengine-docker-use-grpc-alt.cs

using IronPdf;
using IronPdf.GrpcLayer;
using Grpc.Core;

// 1. Create custom gRPC channel (.NET Framework style)
var channel = new Channel("123.456.7.8:80", ChannelCredentials.SecureSsl);

// 2. (Optional) Add metadata headers if needed
var metadata = new Metadata
{
    { "Authorization", "Bearer your_token_here" }
};

// 3. Configure IronPDF with custom channel
var config = IronPdfConnectionConfiguration.WithCustomChannel(channel, metadata);
IronPdf.Installation.ConnectToIronPdfHost(config);

// 4. Generate PDF
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("Hello world");

// 5. Save the PDF to disk
pdf.SaveAs("output.pdf");

// 6. Clean up , this is needed to work
pdf.Dispose();

IRON VB CONVERTER ERROR developers@ironsoftware.com