IRONSOFTWAREHOME

Solucionar Fallos de Conexión de Docker de IronPdfEngine en macOS ARM

Curtis Chau
Curtis Chau
Updated: 10 de junio de 2026

Al conectar una aplicación .NET a IronPdfEngine vía Docker en un dispositivo ARM de macOS (Apple Silicon), la aplicación lanza:

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

IronPdfConnectionType.Docker utiliza una implementación gRPC más antigua que no soporta arquitectura ARM. En macOS ARM (Apple Silicon), el cliente .NET no puede cargar el binario nativo requerido de gRPC, incluso cuando se fuerza a la imagen de Docker a ejecutar como --platform linux/amd64. Las plataformas Windows y Linux x64 no se ven afectadas.

Solución

Reemplaza IronPdfConnectionType.Docker con IronPdfConnectionType.RemoteServer en la configuración de conexión. RemoteServer utiliza una implementación gRPC más nueva que es compatible con 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");

Requirements:

  • El contenedor Docker de IronPdfEngine debe estar en funcionamiento y accesible en el host y puerto especificados antes de llamar a ConnectToIronPdfHost.
  • Use http://, no https://; usar https:// sin un certificado SSL válido causa errores de corrupción de tramas en el canal gRPC.

Consulta también: solución de problemas de inicialización Vulkan/ANGLE en Docker y solución de errores de conexión gRPC en Azure Containers.

Curtis Chau
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...
Leer más

¿Listo para empezar?

Nuget Downloads 20,878,335Versión:2026.9recién publicada

Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta
Biblioteca C# NuGet para PDF
Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
  2. Seleccione Examinar y busque "IronPDF"
  3. Seleccione el paquete e instale
C# PDF DLL
Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

  1. Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
  2. En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999

Key in blue circle

Obtenga su clave de prueba gratuita de 30 días al instante.

Your trial license will be sent to your email address

Sin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.

bullet_checkedNo se requiere tarjeta de crédito ni creación de cuentaSin limitaciones. 100 % desbloqueado. Sin tarjeta de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Reserve su Demostración en Vivo gratuita
Booking Badge

Confiado por millones de ingenieros en todo el mundo

Logos de clientes de Iron Software
Obtén tu Consulta Sin Compromiso
Completa el formulario a continuación o envía un correo a sales@ironsoftware.com
Tus detalles siempre serán mantenidos confidenciales.
Confiado por millones de ingenieros en todo el mundo
Logos de clientes de Iron Software
Obtenga su Clave de Prueba de 30 días gratis al instante.
No se requiere tarjeta de crédito ni creación de cuenta