1. IronPDF
  2. Commencer
  3. Vue d'ensemble de l'installation

Installation Overview

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

Guide complet pour l'installation et la configuration d'IronPDF sur toutes les plateformes.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

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

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

1. Exigences de la plateforme

<table class=« classic-table hover-cell »>

Plateforme Version .NET Matériel Exigences supplémentaires, Compatibilité 
<tbody>
    <tr>
        <td>
            <div class=« d-flex align-items-center> justify-content-center »>
                <img src=« /static-assets/svgs/logo-table_windows.svg » width=« 64 » height=« 64 » alt=«  » />
            </div>
            <a href=« /get-started/windows/ »>Windows</a>
        </td>
        <td rowspan=« 3 »><span>.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard et .NET Framework.</span></td>
        <td rowspan=« 3 »>
            <ul>
                <li>Minimum: 1 Core & 1.75 Go de RAM</li>
                <li>Recommandé: 2 Cores & 8 Go de RAM ou plus</li>
            </ul>
        </td>
        <td>
            <ul>
                <li>Windows 10, 11 et Windows Server</li>
                <li>Redistribuable Visual C++ (x86 & x64)</li>
            </ul>
        </td>
    </tr>
    <tr>
        <td>
            <div class=« d-flex align-items-center> justify-content-center »>
                <img src=« /static-assets/svgs/logo-table_linux.svg » width=« 64 » height=« 64 » alt=«  » />
            </div>    
            <a href=« /get-started/linux/ »>Linux</a>
        </td>
        <td>
            <ul>
                <li>Systèmes d'exploitation Linux 64 bits: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11m CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2</li>
                <li>IronCefSubprocess</li>
                <li>Dépendances Chrome</li>
            </ul>
        </td>
    </tr>
    <tr>
        <td>
            <div class=« d-flex align-items-center> justify-content-center »>
                <img src=« /static-assets/svgs/logo-table_mac.svg » width=« 64 » height=« 64 » alt=«  » />
            </div>
            <a href=« /get-started/macos/ »>macOS</a>
        </td>
        <td><span>Toutes les versions de macOS depuis 2020</span></td>
    </tr>
</tbody>

2. Méthodes d'installation

Il y a deux façons d'installer IronPDF : mode natif et moteur distant. Par défaut, le mode natif est recommandé. Pour le déploiement sur des serveurs de production utilisant Docker/Kubernetes, utilisez le mode moteur distant.

g-3 »>
class=« col-6 »>
class=« install-mode »>
class=« install-mode__header »> class=« install-mode__title »>Mode moteur distant class=« install-mode__subtitle »>Traitement PDF séparé via le protocole gRPC.
class=« install-mode__body »>
  • Idéal pour : Déploiements en cloud et conteneurisés, support OS legacy.
  • Paquet : IronPdf.Slim
  • Taille : Plus léger, ne prend que quelques Mo.
  • Exigences : Nécessite de configurer la connexion à l'hôte.
class=« col-6 »>
install-mode--recommended »>
class=« install-mode__header »> class=« install-mode__title »>Mode natif (par défaut) class=« install-mode__subtitle »>Tout s'exécute localement dans votre application
class=« recommended-float »> «  »
class=« install-mode__body »>
  • Idéal pour : Déploiements modernes sur Windows, macOS et Linux.
  • Paquet : Paquet complet IronPdf NuGet.
  • Taille : Plus volumineux (centaines de Mo), inclus les binaires Chrome et Pdfium.
  • Exigences : Fonctionne sur les systèmes d'exploitation modernes.

3. Options d'installation

L'installation de la bibliothèque C# PDF prend moins de 5 minutes. Obtenez-le gratuitement via NuGet ou téléchargement direct et commencez à l'utiliser dans Visual Studio immédiatement.

data-active-tab=« 1 »>
class=« installation-options__tabs »>
data-tab=« 1 »> Paquet NuGet
data-tab=« 2 »> Téléchargement manuel
data-tab=« 3 »> Remote IronPdfEngine
data-tab=« 1 »>
data-tab=« 2 »>
data-tab=« 3 »>

Début du Package NuGet -->

id=« nuget-package-start »>

Allez à la bibliothèque NuGet IronPDF (ou Console du gestionnaire de paquets dans Visual Studio)

  1. Dans l'Explorateur de solutions, faites un clic droit sur Références
  2. Sélectionnez 'Gérer les paquets NuGet' > 'Parcourir' > Recherchez IronPdf
  3. Sélectionnez le paquet et installez-le.
Install-Package IronPdf

class=« related-link »>RELATED: Paquets IronPDF NuGet avancés

id=« nuget-package-end »>

Fin du Package NuGet -->

Début du Téléchargement manuel -->

id=« manual-download-start »>
  1. Téléchargez le paquet DLL IronPDF pour votre plateforme : Windows, Linux, macOS
  2. Décompressez le fichier ZIP pour votre OS à un emplacement dans votre répertoire Solution.
  3. Dans Explorateur de Solutions Visual Studio, faites un clic droit sur 'Dépendances.'
  4. 'Ajouter Référence Projet' > Sélectionnez 'Parcourir' pour inclure tous les DLL extraits du zip.
id=« manual-download-end »>

Fin du Téléchargement manuel -->

Début du Remote IronPdfEngine -->

id=« remote-ironpdfengine-start »>

Veuillez noterVeuillez noter : Chaque version d'IronPDF nécessite la version correspondante de IronPdfEngine. La compatibilité entre versions n'est pas disponible. Par exemple, IronPDF 2024.2.2 doit utiliser IronPdfEngine 2024.2.2.

Installez IronPdf en utilisant NuGet.

Install-Package IronPdf.Slim
id=« remote-ironpdfengine-end »>

Fin du Remote IronPdfEngine -->

4. Configurations supplémentaires

data-active-tab=« 1 »>
class=« installation-options__tabs »>
data-tab=« 1 »> Gérer la licence
data-tab=« 2 »> Chemin & Permission
data-tab=« 3 »> Moteur à distance
data-tab=« 1 »>
data-tab=« 2 »>
data-tab=« 3 »>

Début de la gestion de la licence -->

id=« manage-license-start »>

Après avoir acheté ou enregistré pour un essai gratuit de 30 jours d'IronPDF, trouvez la clé de licence envoyée à votre courriel.

Ajoutez votre clé de licence au début de votre application.

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

Vérifiez le statut de la licence.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
id=« manage-license-end »>

Fin de la gestion de la licence -->

Début des Chemins & Permissions -->

id=« path-permission-start »>

Définissez la propriété TempFolderPath de l'objet 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

ConseilsAssurez-vous de vider tous les dossiers temp et cache sur votre développement et serveurs, puis redeployez une version propre de votre application après avoir mis à jour un chemin.

Définir la variable d'environnement du dossier temporaire au niveau de l'application.

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

ConseilsSur un serveur verrouillé, donnez à l'utilisateur IIS (IUSER) les permissions de lecture et d'écriture pour votre dossier de chemin d'installation, ainsi que pour votre dossier Windows et Temp.

id=« path-permission-end »>

Fin des Chemins & Permissions -->

Début du Moteur à distance -->

id=« remote-engine-start »>

[Remote IronPdfEngine] Après avoir installé le package IronPdf.Slim, connectez-vous au conteneur d'engines et configurez la connexion au démarrage de l'application ou avant d'appeler toute méthode IronPDF.

En supposant que l'IronPdfEngine fonctionne à distance à 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

class=« related-link »>RELATED: Limitations de IronPdfEngine

[Linux] Activer IronPDF pour installer automatiquement toutes les dépendances Linux requises. La première opération HTML-PDF peut prendre plus de temps que d'habitude.

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

[Docker] Pré-initialiser le moteur Chrome pour précharger les prérequis et accélérer la première utilisation dans Docker.

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

class=« related-link »>RELATED: Compatibilité et Configuration IronPDF Linux Docker

id=« remote-engine-end »>

Fin du Moteur à distance -->

5. Scénarios de déploiement

g-4 »>
class=« col-6 »>
class=« deployment-card »>
class=« deployment-card__icon »> «  »
class=« deployment-card__info »>

class=« deployment-card__title »>Exécutez et déployez IronPDF .NET sur

Azure Function
class=« col-6 »>
class=« deployment-card »>
class=« deployment-card__icon »> «  »
class=« deployment-card__info »>

class=« deployment-card__title »>Exécutez et déployez IronPDF .NET sur

AWS Lambda
class=« col-6 »>
class=« deployment-card »>
class=« deployment-card__icon »> «  »
class=« deployment-card__info »>

class=« deployment-card__title »>Exécutez IronPDF dans

Conteneur Docker Linux
class=« col-6 »>
class=« deployment-card »>
class=« deployment-card__icon »> «  »
class=« deployment-card__info »>

class=« deployment-card__title »>Exécutez IronPDF comme

Conteneur distant

Étapes suivantes

g-3 »>
col-xxl-4 »>
class=« next-step__card-info »>
class=« next-step__card-icon »>
class=« next-step__card-text »>Guide complet sur la conversion HTML en PDF en C#

class=« next-step__card-cta »>Voir le tutoriel

col-xxl-4 »>
class=« next-step__card-info »>
class=« next-step__card-icon »>
class=« next-step__card-text »>Changelog : Mises à jour, jalons, feuille de route

class=« next-step__card-cta »>Voir les mises à jour des produits

col-xxl-4 »>
class=« next-step__card-info »>
class=« next-step__card-icon »>
class=« next-step__card-text »>Demande de support technique

class=« next-step__card-cta »>Voir le dépannage

Questions Fréquemment Posées

Comment puis-je configurer IronPdfEngine pour la génération de PDF à distance ?

Pour configurer IronPdfEngine pour la génération de PDF à distance, installez le package IronPdf.Slim depuis NuGet et configurez les paramètres de connexion en utilisant la classe IronPdfConnectionConfiguration. Cette configuration vous permet de connecter votre application à l'instance IronPdfEngine à distance.

Quels sont les principaux avantages de l'utilisation d'IronPdfEngine avec mon application ?

L'utilisation d'IronPdfEngine avec votre application permet l'exécution à distance de tâches PDF, aidant à éviter les problèmes de compatibilité spécifiques à la plateforme, surtout sur d'anciens systèmes et plateformes mobiles. Elle élimine également le besoin du runtime .NET pendant l'exécution.

Pourquoi pourrais-je choisir d'utiliser IronPdfEngine au lieu de la bibliothèque PDF native ?

Vous pourriez choisir IronPdfEngine pour exécuter des fonctions PDF intensives en performance à distance, réduisant les problèmes de compatibilité avec différents systèmes d'exploitation et améliorant les performances en utilisant un moteur identique à Chrome pour la conversion HTML en PDF.

Le scaling horizontal est-il pris en charge par IronPdfEngine ?

Non, IronPdfEngine ne prend actuellement pas en charge le scaling horizontal, ce qui signifie qu'il ne peut pas être équilibré en charge sur plusieurs instances en raison de la façon dont les binaires de fichiers PDF sont gérés en mémoire serveur.

IronPdfEngine peut-il fonctionner sur différents systèmes d'exploitation ?

IronPdfEngine est conçu pour fonctionner sur des systèmes Linux en utilisant des conteneurs Docker. Cependant, les binaires sont spécifiques à chaque plateforme, vous devez donc vous assurer d'utiliser la version correcte pour votre système d'exploitation.

Que dois-je faire si mes sorties PDF sont différentes lorsque j'utilise IronPdfEngine ?

Les sorties PDF peuvent varier légèrement en raison des comportements différents du système d'exploitation. Pour minimiser les différences, assurez-vous d'utiliser l'image Docker correcte et vérifiez les configurations spécifiques à l'OS pouvant affecter le rendu.

Comment puis-je m'assurer que mon application utilise la bonne version d'IronPdfEngine ?

Pour assurer la compatibilité, chaque version de IronPDF nécessite une version correspondante d'IronPdfEngine. Assurez-vous de mettre à jour les deux composants simultanément pour éviter les problèmes de version croisée.

Quelles sont les limitations de l'utilisation d'IronPdfEngine sur Windows ?

Lors de l'utilisation d'IronPdfEngine sur Windows, vous avez besoin des conteneurs Linux pour Docker et devez vous assurer que le port serveur est accessible. Les binaires sont spécifiques à la plateforme, et passer aux conteneurs Linux est requis.

Comment puis-je configurer IronPDF pour se connecter à un serveur IronPdfEngine distant ?

Pour configurer IronPDF pour un serveur distant, utilisez Installation.ConnectToIronPdfHost avec la méthode IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, en spécifiant l'IP et les détails du port du serveur.

Quel package devrais-je utiliser pour minimiser la taille de l'application lors de l'utilisation d'IronPdfEngine ?

Vous devriez utiliser le package IronPdf.Slim depuis NuGet, car il inclut seulement les composants nécessaires pour exécuter IronPDF avec IronPdfEngine, réduisant ainsi la taille de l'application.

Curtis Chau
Curtis Chau
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,133,208 | Version : 2025.11 vient de sortir