1. IronPDF
  2. Inicio
  3. Guía de Instalación

Descripción general de la instalación

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Guía completa para instalar y configurar IronPDF en todas las plataformas.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronPDF con el gestor de paquetes NuGet

    PM > Install-Package IronPdf

  2. Copie y ejecute este fragmento de código.

    IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronPDF en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

1. Requisitos de la plataforma

Plataforma Versión .NET Hardware Requisitos adicionales, compatibilidad
Logo Table Windows related to 1. Requisitos de la plataforma
Windows 		.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard y .NET Framework.
  • Mínimo: 1 Core y 1,75 GB de RAM
  • Recomendado: 2 núcleos y 8 GB de RAM o superior
  • Windows 10, 11 y Windows Server
  • Visual C++ Redistributable (x86 y x64)
Logo Table Linux related to 1. Requisitos de la plataforma
Linux
  • sistemas operativos Linux de 64 bits: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11m CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2
  • IronCefSubprocess
  • Dependencias de Chrome
Logo Table Mac related to 1. Requisitos de la plataforma
macOS 		Todas las versiones de macOS desde 2020

2. Métodos de instalación

Hay dos formas de instalar IronPDF: modo nativo y motor remoto. Por defecto, se recomienda el modo nativo. Para el despliegue en servidores de producción mediante Docker/Kubernetes, utilice el modo de motor remoto.

Modo Motor Remoto Procesamiento de PDF independiente mediante protocolo gRPC.
  • Mejor para: Despliegues en la nube y en contenedores, compatibilidad con sistemas operativos heredados.
  • Paquete: IronPdf.Slim
  • Tamaño: Más ligero, ocupando unos pocos MB.
  • Requisitos: Requiere configurar la conexión al host.
Modo nativo (predeterminado) Todo se ejecuta localmente en su aplicación
Float Recommended related to 2. Métodos de instalación
  • Mejor para: Implementaciones modernas de Windows, macOS y Linux.
  • Paquete: Paquete completo IronPdf NuGet.
  • Tamaño: De gran tamaño (cientos de MBs), incluyendo los binarios de Chrome y Pdfium.
  • Requisitos: Funciona en sistemas operativos modernos.

3. Opciones de instalación

La instalación de la biblioteca PDF de C# lleva menos de 5 minutos. Consíguelo gratis a través de NuGet o de descarga directa y empieza a utilizarlo en Visual Studio de inmediato.

Paquete NuGet
Descarga del manual
Remoto IronPdfEngine

Vaya a IronPDF NuGet library (o a la consola del gestor de paquetes en Visual Studio)

  1. En el Explorador de soluciones, haga clic con el botón derecho en Referencias
  2. Seleccione 'Gestionar paquetes NuGet' > 'Examinar' > Buscar IronPdf
  3. Seleccione el paquete e instálelo.
Install-Package IronPdf

RELACIÓN: Más paquetes avanzados IronPDF Nuget

  1. Descargue el paquete IronPDF DLL para su plataforma: Windows, Linux, macOS
  2. Descomprima el archivo ZIP para su sistema operativo en una ubicación dentro de su directorio de soluciones.
  3. En el Explorador de soluciones de Visual Studio, haga clic con el botón derecho en "Dependencias"
  4. añadir referencia de proyecto' > Seleccione 'Examinar' para incluir todas las DLL extraídas del zip.

Por favor notaPlease note: Each IronPDF release requires the matching version of IronPdfEngine. Cross-version support isn’t available. For example, IronPDF 2024.2.2 must use IronPdfEngine 2024.2.2.

Install IronPdf using NuGet.

Install-Package IronPdf.Slim

4. Configuraciones adicionales

Administrar licencia
Path & Permission
Motor remoto

Una vez que haya adquirido IronPDF o se haya suscrito a una versión de prueba de 30 días, encontrará la clave de licencia enviada a su correo electrónico.

Añada su clave de licencia al inicio de su aplicación.

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Compruebe el estado de la licencia.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Establezca la propiedad TempFolderPath del objeto IronPdf.Installation.

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"
$vbLabelText   $csharpLabel

{t:(Asegúrese de borrar todas las carpetas temporales y de caché en sus servidores de desarrollo y, a continuación, vuelva a implementar una versión limpia de su aplicación después de actualizar una ruta)}]

Configuración de la variable de entorno de la carpeta temp en el ámbito de la aplicación.

using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

{t:(En un servidor bloqueado, otorgue al usuario IIS (IUSER) permisos de lectura y escritura en su carpeta de ruta de instalación, así como en su carpeta Windows y Temp.)}]

[Remote IronPdfEngine] Después de instalar el paquete IronPdf.Slim, conéctese al contenedor del motor y configure la conexión al iniciar la aplicación o antes de llamar a cualquier método IronPDF.

Suponiendo que IronPdfEngine se ejecuta de forma remota en 123.456.7.8:33350:

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

RELACIÓN: Limitaciones de IronPdfEngine

[Linux] Active IronPDF para que instale automáticamente todas las dependencias de Linux necesarias. La primera operación de conversión de HTML a PDF puede llevar más tiempo de lo habitual.

Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

[Docker] Preinicia el motor de Chrome para cargar previamente los requisitos previos y acelerar el primer uso en Docker.

IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize()
$vbLabelText   $csharpLabel

RELACIÓN: Compatibilidad y configuración de IronPDF Linux Docker

5. Escenarios de implementación

Logo Azure related to 5. Escenarios de implementación

Ejecutar e implementar IronPDF .NET en

Función Azure
Logo Aws related to 5. Escenarios de implementación

Ejecutar e implementar IronPDF .NET en

AWS Lambda
Logo Linux related to 5. Escenarios de implementación

Ejecute IronPDF en

Contenedor Linux Docker
Logo Remote related to 5. Escenarios de implementación

Ejecutar IronPDF como una aplicación

Contenedor remoto

Siguientes pasos

Guía completa de HTML a PDF C#

Ver tutorial

Registro de cambios: Actualizaciones, hitos, hoja de ruta

Ver actualizaciones de productos

Solicitar asistencia técnica

Ver Solución de problemas

Guía de inicio rápido Motor nativo frente a motor remoto

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.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
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 ...

Leer más
¿Listo para empezar?
Nuget Descargas 16,493,056 | Version: 2025.11 recién lanzado