Aperçu de l'installation

Curtis Chau

Mis à jour:21 avril 2026

Translated

View the article in English

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

Installez IronPDF avec le Gestionnaire de Packages NuGet
PM > Install-Package IronPdf

Copiez et exécutez cet extrait de code.

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

Déployez pour tester sur votre environnement de production.

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit

1. Exigences de la plateforme

Plate-forme	Version .NET	Matériel	Exigences supplémentaires, compatibilité
Windows	.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard et .NET Framework.	Configuration minimale : 1 cœur et 1,75 Go de RAM Configuration recommandée : 2 cœurs et 8 Go de RAM ou plus	Windows 10, 11 et Windows Server Visual C++ Redistributable (x86 et x64)
Linux			OS Linux 64 bits : Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11, CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2 IronCefSubprocess Dépendances de Chrome
macOS			Toutes les versions de macOS depuis 2020

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.

Idéal pour : les déploiements dans le cloud et les conteneurs, la prise en charge des systèmes d'exploitation anciens.
Paquet : IronPdf.Slim
Taille : Plus léger, occupant quelques mégaoctets.
Exigences : Nécessite la configuration de la connexion à l'hôte.

Idéal pour : les déploiements modernes sous Windows, macOS et Linux.
Paquet : Paquet NuGet IronPDF complet.
Taille : Plus grande (plusieurs centaines de Mo), incluant 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.

Package NuGet

Téléchargement manuel

Moteur IronPDF à distance

Allez à la bibliothèque NuGet IronPDF (ou console de gestion de paquets dans Visual Studio)

Dans l'Explorateur de solutions, faites un clic droit sur Références
Sélectionnez 'Gérer les paquets NuGet' > 'Parcourir' > Rechercher IronPDF
Sélectionnez le paquet et installez-le.

Install-Package IronPdf

Téléchargez le package DLL IronPDF pour votre plateforme : Windows, Linux, macOS
Décompressez le fichier ZIP correspondant à votre système d'exploitation dans un emplacement situé dans votre répertoire de solution.
Dans l'explorateur de solutions de Visual Studio, cliquez avec le bouton droit sur " Dépendances ".
ajouter une référence de projet" > Sélectionnez "Parcourir" pour inclure toutes les DLL extraites du fichier zip.

Veuillez noterVeuillez noter : chaque version IronPDF nécessite la version correspondante d'IronPDFEngine. La compatibilité entre les 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

4. Configurations supplémentaires

Gérer les licences

Path & Permission

Moteur à distance

Après avoir acheté ou vous être inscrit à une version d'essai de 30 jours d'IronPDF, retrouvez la clé de licence envoyée à votre email.

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

IronPdf.License.LicenseKey = "KEY";

IronPdf.License.LicenseKey = "KEY";

Imports IronPdf

IronPdf.License.LicenseKey = "KEY"

$vbLabelText $csharpLabel

Vérifiez l'état de la licence.

bool valid = IronPdf.License.IsLicensed;

bool valid = IronPdf.License.IsLicensed;

Imports IronPdf

Dim valid As Boolean = IronPdf.License.IsLicensed

$vbLabelText $csharpLabel

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 supprimer tous les dossiers temporaires et de cache sur vos environnements de développement et serveurs, puis redéployez une version propre de votre application après avoir mis à jour le chemin d'accès.

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");

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

Sur un serveur sécurisé, accordez à l'utilisateur IIS (IUSER) les autorisations de lecture et d'écriture sur le dossier d'installation, ainsi que sur les dossiers Windows et Temp.

[IronPDFEngine à distance] Après avoir installé le package IronPdf.Slim, connectez-vous au conteneur du moteur et configurez la connexion au démarrage de l'application ou avant d'appeler n'importe quelle 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")
);

Installation.ConnectToIronPdfHost( _
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350") _
)

$vbLabelText $csharpLabel

[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;

Installation.LinuxAndDockerDependenciesAutoConfig = True

$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

5. Scénarios de déploiement

Exécuter et déployer IronPDF .NET sur

Fonction Azure

Exécuter et déployer IronPDF .NET sur

AWS Lambda

Exécutez IronPDF dans

Conteneur Docker Linux

Exécutez IronPDF en tant que

Conteneur distant

Prochaines étapes

Guide complet sur la conversion HTML en PDF avec C#

Voir le tutoriel

Journal des modifications : mises à jour, étapes clés, feuille de route

Consultez les mises à jour du produit

Demande d'assistance technique

Consultez la section 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

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 ...

Prêt à commencer?

Nuget Téléchargements 18,918,602 | Version : 2026.5 just released

Voir Licences

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronPdf
exécuter un échantillon Regardez votre code HTML se transformer en PDF.

Voir Licences

Mise en avant du client :

Projecteur sur les Développeurs:

Webinaires:

Essai gratuit de 30 jours

Sur cette page

Aperçu de l'installation

Installez IronPDF avec le Gestionnaire de Packages NuGet

Copiez et exécutez cet extrait de code.

Déployez pour tester sur votre environnement de production.

1. Exigences de la plateforme

2. Méthodes d'installation

3. Options d'installation

4. Configurations supplémentaires

5. Scénarios de déploiement

Prochaines étapes

Questions Fréquemment Posées

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

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

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

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

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

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

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

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

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

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

Vous faites encore défiler ?

Équipe de soutien Iron

Essai gratuit de 30 jours

Sur cette page

Aperçu de l'installation

Installez IronPDF avec le Gestionnaire de Packages NuGet

Copiez et exécutez cet extrait de code.

Déployez pour tester sur votre environnement de production.

1. Exigences de la plateforme

2. Méthodes d'installation

3. Options d'installation

4. Configurations supplémentaires

5. Scénarios de déploiement

Prochaines étapes

Questions Fréquemment Posées

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

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

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

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

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

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

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

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

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

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

Vous faites encore défiler ?

Étape suivante : Commencer l'essai gratuit de 30 jours

Thank You

Étape suivante : Commencer l'essai gratuit de 30 jours

Want to deploy IronSuite to a live project for FREE?

What’s included?

De confiance par des millions d'ingénieurs dans le monde entier

Équipe de soutien Iron