1. IronPDF
  2. Comece agora
  3. Visão geral da instalação

Visão geral da instalação

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

Guia completo para instalar e configurar o IronPDF em todas as plataformas.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

  2. Copie e execute este trecho de código.

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

  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

    arrow pointer

1. Requisitos da plataforma

Plataforma Versão .NET Hardware Requisitos adicionais, compatibilidade
Logo Table Windows related to 1. Requisitos da plataforma
Windows 		.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard e .NET Framework.
  • Requisitos mínimos: 1 núcleo e 1,75 GB de RAM
  • Recomendado: 2 núcleos e 8 GB de RAM ou superior
  • Windows 10, 11 e Windows Server
  • Visual C++ Redistributable (x86 e x64)
Logo Table Linux related to 1. Requisitos da plataforma
Linux
  • Sistemas operacionais Linux de 64 bits: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11m CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2
  • Subprocesso IronCef
  • Dependências do Chrome
Logo Table Mac related to 1. Requisitos da plataforma
macOS 		Todas as versões do macOS desde 2020

2. Métodos de Instalação

Existem duas maneiras de instalar o IronPDF: modo nativo e mecanismo remoto. Por padrão, o modo nativo é recomendado. Para implantação em servidores de produção usando Docker/Kubernetes, utilize o modo de mecanismo remoto.

Modo de mecanismo remoto: Processamento separado de PDFs via protocolo gRPC.
  • **Ideal para:** Implantações em nuvem e conteinerizadas, suporte a sistemas operacionais legados.
  • **Pacote:** IronPdf.Slim
  • **Tamanho:** Mais leve, ocupando alguns MB.
  • **Requisitos:** Requer a configuração da conexão com o host.
Modo nativo (padrão) Tudo é executado localmente em sua aplicação.
Float Recommended related to 2. Métodos de Instalação
  • **Ideal para:** Implementações modernas em Windows, macOS e Linux.
  • **Pacote:** Pacote NuGet completo do IronPdf.
  • **Tamanho:** Arquivo de tamanho considerável (centenas de MB), incluindo os binários do Chrome e do Pdfium.
  • **Requisitos:** Funciona em sistemas operacionais modernos.

3. Opções de Instalação

A instalação da biblioteca C# PDF leva menos de 5 minutos. Obtenha-o gratuitamente via NuGet ou faça o download direto e comece a usá-lo no Visual Studio imediatamente.

Pacote NuGet
Download do manual
Motor IronPdfRemoto

Acesse a biblioteca NuGet do IronPDF (ou o Console do Gerenciador de Pacotes no Visual Studio).

  1. No Explorador de Soluções, clique com o botão direito do mouse em Referências.
  2. Selecione 'Gerenciar Pacotes NuGet' > 'Procurar' > Pesquisar IronPdf
  3. Selecione o pacote e instale.
Install-Package IronPdf

**RELACIONADO:** Mais pacotes NuGet avançados do IronPDF

  1. Baixe o pacote DLL do IronPDF para sua plataforma: Windows, Linux, macOS
  2. Descompacte o arquivo ZIP correspondente ao seu sistema operacional em um local dentro do diretório da sua solução.
  3. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em 'Dependências'.
  4. 'Adicionar Referência de Projeto' > Selecione 'Procurar' para incluir todas as DLLs extraídas do arquivo zip.

ObserveObservação: Cada versão do IronPDF requer a versão correspondente do IronPdfEngine. Não há suporte entre versões. Por exemplo, o IronPDF 2024.2.2 deve usar o IronPdfEngine 2024.2.2.

Instale o IronPdf usando o NuGet.

Install-Package IronPdf.Slim

4. Configurações adicionais

Gerenciar licença
Path & Permission
Motor remoto

Após adquirir ou se inscrever para um período de avaliação de 30 dias do IronPDF, localize a chave de licença enviada para o seu e-mail.

Adicione sua chave de licença no início da sua inscrição.

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
Imports IronPdf

IronPdf.License.LicenseKey = "KEY"
$vbLabelText   $csharpLabel

Verifique o status da licença.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
Imports IronPdf

Dim valid As Boolean = IronPdf.License.IsLicensed
$vbLabelText   $csharpLabel

Defina a propriedade TempFolderPath do 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

Certifique-se de limpar todas as pastas temporárias e de cache em seus servidores de desenvolvimento e, em seguida, reimplemente uma versão limpa do seu aplicativo após atualizar o caminho.

Definindo a variável de ambiente da pasta temporária no escopo do aplicativo.

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");
Imports IronPdf
Imports System.IO

' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
    Doc.SaveAs("example.pdf")
End Using
$vbLabelText   $csharpLabel

Em um servidor com segurança reforçada, conceda ao usuário do IIS (IUSER) permissões de leitura e gravação para a pasta de instalação, bem como para as pastas do Windows e Temp.

[IronPdfEngine remoto] Após instalar o pacote IronPdf.Slim, conecte-se ao contêiner do mecanismo e configure a conexão na inicialização do aplicativo ou antes de chamar qualquer método do IronPDF.

Supondo que o IronPdfEngine esteja sendo executado remotamente em 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")
);
Installation.ConnectToIronPdfHost( _
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350") _
)
$vbLabelText   $csharpLabel

**RELACIONADO:** Limitações do IronPdfEngine

[Linux] Ative o IronPDF para instalar automaticamente todas as dependências necessárias do Linux. A primeira conversão de HTML para PDF pode demorar mais do que o normal.

Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = True
$vbLabelText   $csharpLabel

[Docker] Pré-inicializar o mecanismo do Chrome para pré-carregar os pré-requisitos e acelerar o primeiro uso no Docker.

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

**RELACIONADO:** Compatibilidade e configuração do IronPDF com Docker no Linux

5. Cenários de Implantação

Logo Azure related to 5. Cenários de Implantação

Execute e implemente o IronPDF .NET em

Função do Azure
Logo Aws related to 5. Cenários de Implantação

Execute e implemente o IronPDF .NET em

AWS Lambda
Logo Linux related to 5. Cenários de Implantação

Execute o IronPDF em

Contêiner Docker Linux
Logo Remote related to 5. Cenários de Implantação

Execute o IronPDF como um

Contêiner remoto

Próximos passos

Guia completo de HTML para PDF em C#

Veja o tutorial
Registro de alterações: atualizações, marcos importantes, roteiro de desenvolvimento

Veja as atualizações do produto
Solicitar suporte de engenharia

Consulte a seção Solução de Problemas.
Quickstart Guide Native vs Remote Engine

Perguntas frequentes

Como posso configurar o IronPDFEngine para geração remota de PDFs?

Para configurar o IronPDFEngine para geração remota de PDFs, instale o pacote IronPdf.Slim do NuGet e configure as definições de conexão usando a classe IronPDFConnectionConfiguration . Essa configuração permite que você conecte seu aplicativo à instância do IronPDFEngine remotamente.

Quais são os principais benefícios de usar o IronPDFEngine com minha aplicação?

Utilizar o IronPDFEngine com sua aplicação permite a execução remota de tarefas em PDF, ajudando a evitar problemas de compatibilidade específicos da plataforma, especialmente em sistemas mais antigos e plataformas móveis. Também elimina a necessidade do runtime do .NET durante a execução.

Por que eu optaria por usar o IronPDFEngine em vez da biblioteca PDF nativa?

Você pode optar pelo IronPDFEngine para executar remotamente funções de PDF que exigem alto desempenho, reduzindo problemas de compatibilidade com diferentes sistemas operacionais e melhorando o desempenho ao utilizar um renderizador idêntico ao do Chrome para conversão de HTML em PDF.

O IronPDFEngine suporta escalonamento horizontal?

Não, o IronPDFEngine atualmente não suporta escalonamento horizontal, o que significa que não pode ser balanceado em várias instâncias devido à forma como os binários de arquivos PDF são gerenciados na memória do servidor.

O IronPDFEngine pode ser executado em diferentes sistemas operacionais?

O IronPDFEngine foi projetado para ser executado em sistemas Linux usando contêineres Docker. No entanto, os binários são específicos da plataforma, portanto, você precisa garantir que está usando a versão correta para o seu sistema operacional.

O que devo fazer se meus PDFs gerados estiverem diferentes ao usar o IronPDFEngine?

Os resultados em PDF podem variar ligeiramente devido a diferentes comportamentos do sistema operacional. Para minimizar essas diferenças, certifique-se de estar usando a imagem Docker correta e verifique se há alguma configuração específica do sistema operacional que possa afetar a renderização.

Como posso garantir que meu aplicativo esteja usando a versão correta do IronPDFEngine?

Para garantir a compatibilidade, cada versão do IronPDF requer uma versão correspondente do IronPDFEngine. Certifique-se de atualizar ambos os componentes simultaneamente para evitar problemas de compatibilidade entre versões.

Quais são as limitações ao usar o IronPDFEngine no Windows?

Ao usar o IronPDFEngine no Windows, você precisa de contêineres Linux para Docker e deve garantir que a porta do servidor esteja acessível. Os binários são específicos da plataforma e a migração para contêineres Linux é necessária.

Como configuro o IronPDF para conectar-se a um servidor IronPDFEngine remoto?

Para configurar o IronPDF para um servidor remoto, use Installation.ConnectToIronPDFHost com o método IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer , especificando o endereço IP e a porta do servidor.

Qual pacote devo usar para minimizar o tamanho do aplicativo ao usar o IronPDFEngine?

Você deve usar o pacote IronPdf.Slim do NuGet, pois ele inclui apenas os componentes necessários para executar o IronPDF com o IronPDFEngine, reduzindo assim o tamanho do aplicativo.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.