Napraw błędy połączenia Docker z IronPdfEngine na macOS ARM

Curtis Chau

Updated: 10 czerwca 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Napraw błędy połączenia Docker z IronPdfEngine na macOS ARM Podczas łączenia aplikacji .NET z IronPdfEngine przez Docker na urządzeniu macOS ARM (Apple Silicon), aplikacja zgłasza wyjątek: ```txt Unhandled exception. System.IO.FileNotFoundException: Error loading native library. Not found in any of the possible locations ``` `IronPdfConnectionType.Docker` używa starszej implementacji gRPC, która nie obsługuje architektury ARM. Na macOS ARM (Apple Silicon) klient .NET nie może załadować wymaganego natywnego pliku binarnego gRPC, nawet gdy obraz Docker jest zmuszony do uruchomienia jako `--platform linux/amd64`. Platformy Windows i Linux x64 nie są dotknięte. ## Rozwiązanie Zamień `IronPdfConnectionType.Docker` na `IronPdfConnectionType.RemoteServer` w konfiguracji połączenia. `RemoteServer` używa nowszej implementacji gRPC, która jest zgodna z ARM: ```csharp using IronPdf; var config = new IronPdfConnectionConfiguration { ConnectionType = IronPdfConnectionType.RemoteServer, Host = "http://127.0.0.1", Port = 33350 }; IronPdf.Installation.ConnectToIronPdfHost(config); IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY"); var renderer = new ChromePdfRenderer(); var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>"); pdf.SaveAs("output.pdf"); ``` **Wymagania:** - Kontener Docker IronPdfEngine musi być uruchomiony i dostępny na określonym hoście i porcie przed wywołaniem `ConnectToIronPdfHost`. - Użyj `http://`, a nie `https://`; Użycie `https://` bez ważnego certyfikatu SSL powoduje błędy uszkodzenia ramek w kanale gRPC. Zobacz również: [rozwiązywanie błędów inicjalizacji Vulkan/ANGLE w Docker](https://ironpdf.com/troubleshooting/vulkan-angle-initialization-docker/) oraz [naprawa błędów połączenia gRPC w kontenerach Azure](https://ironpdf.com/troubleshooting/azure-grpc-connection-errors/).

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Podczas łączenia aplikacji .NET z IronPdfEngine przez Docker na urządzeniu macOS ARM (Apple Silicon), aplikacja zgłasza wyjątek:

Unhandled exception. System.IO.FileNotFoundException: Error loading native library.
Not found in any of the possible locations

Unhandled exception. System.IO.FileNotFoundException: Error loading native library.
Not found in any of the possible locations

IronPdfConnectionType.Docker używa starszej implementacji gRPC, która nie obsługuje architektury ARM. Na macOS ARM (Apple Silicon) klient .NET nie może załadować wymaganego natywnego pliku binarnego gRPC, nawet gdy obraz Docker jest zmuszony do uruchomienia jako --platform linux/amd64. Platformy Windows i Linux x64 nie są dotknięte.

Rozwiązanie

Zamień IronPdfConnectionType.Docker na IronPdfConnectionType.RemoteServer w konfiguracji połączenia. RemoteServer używa nowszej implementacji gRPC, która jest zgodna z ARM:

using IronPdf;

var config = new IronPdfConnectionConfiguration
{
    ConnectionType = IronPdfConnectionType.RemoteServer,
    Host = "http://127.0.0.1",
    Port = 33350
};

IronPdf.Installation.ConnectToIronPdfHost(config);

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>");
pdf.SaveAs("output.pdf");

using IronPdf;

var config = new IronPdfConnectionConfiguration
{
    ConnectionType = IronPdfConnectionType.RemoteServer,
    Host = "http://127.0.0.1",
    Port = 33350
};

IronPdf.Installation.ConnectToIronPdfHost(config);

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY");

var renderer = new ChromePdfRenderer();
var pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf

Dim config As New IronPdfConnectionConfiguration With {
    .ConnectionType = IronPdfConnectionType.RemoteServer,
    .Host = "http://127.0.0.1",
    .Port = 33350
}

IronPdf.Installation.ConnectToIronPdfHost(config)

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>")
pdf.SaveAs("output.pdf")

Imports IronPdf

Dim config As New IronPdfConnectionConfiguration With {
    .ConnectionType = IronPdfConnectionType.RemoteServer,
    .Host = "http://127.0.0.1",
    .Port = 33350
}

IronPdf.Installation.ConnectToIronPdfHost(config)

IronPdf.License.LicenseKey = Environment.GetEnvironmentVariable("IRONPDF_LICENSE_KEY")

Dim renderer As New ChromePdfRenderer()
Dim pdf = Await renderer.RenderHtmlAsPdfAsync("<h1>Hello from IronPdfEngine</h1>")
pdf.SaveAs("output.pdf")

Wymagania:

• Kontener Docker IronPdfEngine musi być uruchomiony i dostępny na określonym hoście i porcie przed wywołaniem ConnectToIronPdfHost.
• Użyj http://, a nie https://; Użycie https:// bez ważnego certyfikatu SSL powoduje błędy uszkodzenia ramek w kanale gRPC.

Zobacz również: rozwiązywanie błędów inicjalizacji Vulkan/ANGLE w Docker oraz naprawa błędów połączenia gRPC w kontenerach Azure.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej