Use IronPDF with in-Engine Mode
Diferencia entre nativo y motor
IronPDF tiene algunas funciones con gran demanda de rendimiento que puedes elegir ejecutar de manera remota. Aunque IronPDF no requiere IronPdfEngine para funcionar, configurar IronPdfEngine como un servicio remoto es una forma opcional de evitar problemas de compatibilidad con Chrome específicos de la plataforma en sistemas operativos más antiguos y entornos móviles.
Comienza con IronPDF
Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.
Cómo el uso de Engine cambia la forma de codificar con IronPDF
Al usar la configuración de Motor, recomendamos instalar IronPdf.Slim en lugar del paquete completo IronPdf desde NuGet, ya que el Motor gestiona todo el peso adicional incluido en el paquete Nativo.
Install-Package IronPdf.Slim
Después de instalar IronPdf.Slim, configura los ajustes de conexión apuntando IronPDF a tu instancia de IronPdfEngine. Agrega el siguiente código al inicio de tu aplicación (o antes de llamar a cualquier método de IronPDF):
Línea adicional de código de configuración para agregar a su código C
Asumiendo que IronPdfEngine opera remotamente en 123.456.7.8:33350:
// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Additional code for your application// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
// Additional code for your application¿Cómo funciona IronPdfEngine?
IronPdfEngine es un servidor contenedor diseñado para gestionar diversas operaciones de IronPDF, incluyendo crear, escribir, editar y leer PDFs, todo utilizando el protocolo gRPC. Construido como una aplicación autónoma de C# .NET, IronPdfEngine opera de manera independiente, eliminando la necesidad del entorno de ejecución .NET durante la ejecución. ¡Nos encargamos de la conexión gRPC para que puedas concentrarte en la codificación!
Para un tutorial de inicio rápido sobre cómo ejecutar IronPDF como su propio contenedor, por favor consulta este tutorial.
How to Use IronPdfEngine as a Remote Server
- Install the C# library to utilize IronPdfEngine
- Install the IronPdf.slim package from NuGet
- Utilize the IronPdfConnectionConfiguration class to configure the connection settings
- Use the IronPdfEngine to render HTML to PDF with an identical renderer to Chrome
Otras aclaraciones para IronPdfEngine
IronPdf .NET no requiere IronPdfEngine para funcionar. IronPdfEngine es solo una forma opcional de usar IronPdf. Por defecto, IronPdf para .NET no utilizará IronPdfEngine.
IronPdf .NET con IronPdfEngine remoto
El paquete NuGet IronPdf.slim es el único paquete necesario para usar IronPdf para .NET con IronPdfEngine Remoto.
IronPdf o IronPdf.Linux, puedes usar IronPdf.slim en su lugar para reducir el tamaño de tu aplicación.Asumiendo que IronPdfEngine opera remotamente en 123.456.7.8:33350.
Instala IronPdf usando NuGet:
Install-Package IronPdf.Slim
Después de instalar IronPdf.slim, solo necesitas decirle a IronPdf dónde está IronPdfEngine (asegúrate de que esa dirección sea accesible y no esté bloqueada por un firewall). Usa la clase IronPdfConnectionConfiguration para configurar los ajustes de conexión. Agrega el siguiente código a la etapa inicial de tu aplicación (o justo antes de llamar a cualquier método de IronPdf).
// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);¡Simple como eso! ¡Después de esto, tu aplicación estará conectada al IronPdfEngine Remoto!
Limitaciones de IronPdfEngine
- Actualmente, IronPdfEngine aún no admite el escalamiento horizontal (balanceo de carga con múltiples instancias) porque almacenamos los binarios del archivo PDF en proceso dentro de la memoria del servidor y usamos PdfDocumentId para la comunicación entre el servidor y el cliente. Esto también minimiza el uso de ancho de banda y aumenta la velocidad de procesamiento.
- Para ejecutar IronPdfEngine Docker remotamente, necesitas asegurarte de que el puerto de IronPdfEngine sea accesible.
- IronPdfEngine Docker ejecutándose en Linux x64 (Debian) usando imágenes oficiales basadas en ubuntu:22.04 puede producir una salida PDF que es ligeramente diferente de la que obtendrías ejecutando IronPdf localmente debido a un comportamiento diferente del sistema operativo.
- Dado que IronPdfEngine Docker está basado en Linux, requiere un contenedor de Linux (selecciona
Cambiar a Contenedores de Linuxsi estás usando Windows). - Los binarios de IronPdfEngine no son multiplataforma, por lo que los construimos específicamente para cada plataforma.
- No está disponible el soporte entre versiones.
Preguntas Frecuentes
¿Cómo puedo configurar IronPdfEngine para la generación remota de PDF?
Para configurar IronPdfEngine para la generación remota de PDF, instala el paquete IronPdf.Slim desde NuGet y configura las configuraciones de conexión usando la clase IronPdfConnectionConfiguration. Esta configuración te permite conectar tu aplicación a la instancia de IronPdfEngine remotamente.
¿Cuáles son los principales beneficios de usar IronPdfEngine con mi aplicación?
Usar IronPdfEngine con tu aplicación permite la ejecución remota de tareas PDF, ayudando a evitar problemas de compatibilidad específicos de la plataforma, especialmente en sistemas más antiguos y plataformas móviles. También elimina la necesidad del tiempo de ejecución de .NET durante la ejecución.
¿Por qué podría elegir usar IronPdfEngine en lugar de la biblioteca PDF nativa?
Podrías elegir IronPdfEngine para ejecutar funciones PDF intensivas en rendimiento de forma remota, reduciendo problemas de compatibilidad con diferentes sistemas operativos y mejorando el rendimiento al aprovechar un renderizador idéntico a Chrome para la conversión de HTML a PDF.
¿Es compatible el escalado horizontal en IronPdfEngine?
No, IronPdfEngine actualmente no admite el escalado horizontal, lo que significa que no puede ser equilibrado en carga entre múltiples instancias debido a la forma en que se manejan los archivos binarios de PDF en la memoria del servidor.
¿Puede ejecutarse IronPdfEngine en diferentes sistemas operativos?
IronPdfEngine está diseñado para ejecutarse en sistemas Linux usando contenedores Docker. Sin embargo, los archivos binarios son específicos de la plataforma, por lo que necesitas asegurarte de usar la versión correcta para tu sistema operativo.
¿Qué debo hacer si mis salidas de PDF son diferentes al usar IronPdfEngine?
Las salidas de PDF pueden variar ligeramente debido a comportamientos diferentes del sistema operativo. Para minimizar diferencias, asegúrate de estar usando la imagen Docker correcta y verifica cualquier configuración específica del sistema operativo que pueda afectar el renderizado.
¿Cómo aseguro que mi aplicación esté usando la versión correcta de IronPdfEngine?
Para asegurar la compatibilidad, cada versión de IronPDF requiere una versión correspondiente de IronPdfEngine. Asegúrate de actualizar ambos componentes simultáneamente para evitar problemas de versiones cruzadas.
¿Cuáles son las limitaciones al usar IronPdfEngine en Windows?
Al usar IronPdfEngine en Windows, necesitas contenedores de Linux para Docker y debes asegurarte de que el puerto del servidor sea accesible. Los binarios son específicos de la plataforma y se requiere cambiar a contenedores de Linux.
¿Cómo configuro IronPDF para conectar a un servidor remoto de IronPdfEngine?
Para configurar IronPDF para un servidor remoto, usa Installation.ConnectToIronPdfHost con el método IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, especificando los detalles de IP y puerto del servidor.
¿Qué paquete debo usar para minimizar el tamaño de la aplicación al usar IronPdfEngine?
Deberías usar el paquete IronPdf.Slim de NuGet, ya que incluye solo los componentes necesarios para ejecutar IronPDF con IronPdfEngine, reduciendo así el tamaño de la aplicación.






