1. IronPDF
  2. Rozpocznij
  3. Przegląd instalacji

Przegląd instalacji

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

Kompletny przewodnik po instalacji i konfiguracji IronPDF na wszystkich platformach.

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

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

  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

1. Wymagania platformowe

Platforma Wersja .NET Sprzęt Dodatkowe wymagania, kompatybilność
Logo Table Windows related to 1. Wymagania platformowe
Windows 		.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard i .NET Framework.
  • Minimalne: 1 rdzeń i 1,75 GB RAM
  • Zalecane: 2 rdzenie i 8 GB RAM lub więcej
  • Windows 10, 11 oraz Windows Server
  • Redistributable Visual C++ (x86 i x64)
Logo Table Linux related to 1. Wymagania platformowe
Linux
  • 64-bitowe systemy Linux OS: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11, CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2
  • IronCefSubprocess
  • Zależności Chrome
Logo Table Mac related to 1. Wymagania platformowe
macOS 		Wszystkie wersje macOS od 2020

2. Metody instalacji

Istnieją dwa sposoby instalacji IronPDF: tryb natywny i zdalny silnik. Domyślnie zaleca się tryb natywny. Do wdrażania na serwerach produkcyjnych używając Docker/Kubernetes, użyj trybu zdalnego silnika.

Tryb zdalnego silnika Oddzielne przetwarzanie PDF za pośrednictwem protokołu gRPC.
  • Najlepsze dla: Wdrożenia w chmurze i konteneryzowane, wsparcie dla starszych systemów operacyjnych.
  • Paczka: IronPdf.Slim
  • Rozmiar: Bardziej lekki, zajmuje tylko kilka MB.
  • Wymagania: Wymaga skonfigurowania połączenia z hostem.
Tryb natywny (domyślny) Wszystko działa lokalnie w Twojej aplikacji
Float Recommended related to 2. Metody instalacji
  • Najlepsze dla: Nowoczesne wdrożenia na Windows, macOS i Linux.
  • Pakiet: Pelny pakiet NuGet IronPDF.
  • Rozmiar: Większy rozmiar (setki MB), zawiera Chrome i biblioteki Pdfium.
  • Wymagania: Działa na nowoczesnych systemach operacyjnych.

3. Opcje instalacji

Zainstalowanie biblioteki C# PDF zajmuje mniej niż 5 minut. Pobierz bezpłatnie przez NuGet lub bezpośrednie pobieranie i zacznij używać w Visual Studio natychmiast.

Paczka NuGet
Pobieranie ręczne
Zdalny IronPdfEngine

Przejdz do biblioteki NuGet IronPDF (lub konsoli Package Manager w Visual Studio)

  1. W Eksploratorze Rozwiązań kliknij prawym przyciskiem na Odwołania
  2. Wybierz 'Manage NuGet Packages' > 'Browse' > Wyszukaj IronPDF
  3. Wybierz pakiet i zainstaluj.
Install-Package IronPdf

**POWIĄZANE:** Bardziej zaawansowane pakiety IronPDF NuGet

  1. Pobierz paczkę DLL IronPDF dla Twojej platformy: Windows, Linux, macOS
  2. Rozpakuj plik ZIP dla Twojego systemu operacyjnego do lokalizacji w Twoim katalogu rozwiązań.
  3. W Eksploratorze Rozwiązań Visual Studio kliknij prawym przyciskiem na 'Dependencies'.
  4. 'Dodaj odwołanie projektu' > Wybierz 'Przeglądaj', aby dołączyć wszystkie pliki DLL wyodrębnione z ZIP.

Zwróć uwagęUwaga: Każde wydanie IronPDF wymaga pasującej wersji IronPdfEngine. Nie ma wsparcia dla wersji krzyżowych. Na przykład, IronPDF 2024.2.2 musi używać IronPdfEngine 2024.2.2.

Zainstaluj IronPDF za pomoca NuGet.

Install-Package IronPdf.Slim

4. Dodatkowe konfiguracje

Zarządzaj licencją
Path & Permission
Zdalny silnik

Po zakupieniu lub zapisaniu się na 30-dniowy okres próbny IronPDF, znajdź klucz licencyjny wysłany na Twój email.

Dodaj klucz licencyjny na początku swojej aplikacji.

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

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

Sprawdź status licencji.

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

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

Ustaw właściwość TempFolderPath obiektu 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

PoradyUsuń wszystkie foldery tymczasowe i cache na swoim rozwoju i serwerach, a następnie ponownie wdroż czystą wersję aplikacji po zaktualizowaniu ścieżki.

Ustawienie zmiennej środowiskowej folderu tymczasowego w zakresie aplikacji.

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

PoradyNa zablokowanym serwerze, przyznaj użytkownikowi IIS (IUSER) uprawnienia do odczytu i zapisu do folderu ścieżki instalacyjnej, a także do folderu Windows i Temp.

[Remote IronPdfEngine] Po zainstalowaniu pakietu IronPdf.Slim, podłącz do kontenera silnika i skonfiguruj połączenie przy uruchomieniu aplikacji lub przed wywołaniem dowolnej metody IronPDF.

Zakładając, że IronPdfEngine działa zdalnie na 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

**POWIĄZANE:** Ograniczenia IronPdfEngine

[Linux] Włącz IronPDF do automatycznej instalacji wszystkich wymagań dla Linux. Pierwsza operacja HTML-to-PDF może potrwać dłużej niż zwykle.

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

[Docker] Wstępnie zainicjuj silnik Chrome, aby załadować wymagania wstępne i przyspieszyć pierwsze użycie w Docker.

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

**POWIĄZANE:** Zgodność i konfiguracja IronPDF dla Linux Docker

5. Scenariusze wdrożenia

Logo Azure related to 5. Scenariusze wdrożenia

Uruchom i wdrażaj IronPDF .NET na

Funkcja Azure
Logo Aws related to 5. Scenariusze wdrożenia

Uruchom i wdrażaj IronPDF .NET na

AWS Lambda
Logo Linux related to 5. Scenariusze wdrożenia

Uruchom IronPDF w

Kontenerze Linux Docker
Logo Remote related to 5. Scenariusze wdrożenia

Uruchom IronPDF jako

Zdalny kontener

Kolejne kroki

Kompletny przewodnik po HTML do PDF w C#

Zobacz Poradnik

Changelog: aktualizacje, kamienie milowe, plan działania

Zobacz Aktualizacje Produktu

Poproś o wsparcie inżynierskie

Zobacz Rozwiązywanie problemów

Quickstart Guide Native vs Remote Engine

Często Zadawane Pytania

Jak skonfigurować IronPdfEngine do zdalnego generowania plików PDF?

Aby skonfigurować IronPdfEngine do zdalnego generowania plików PDF, zainstaluj pakiet IronPdf.Slim z NuGet i skonfiguruj ustawienia połączenia za pomocą klasy IronPdfConnectionConfiguration. Ta konfiguracja pozwala na zdalne połączenie aplikacji z instancją IronPdfEngine.

Jakie są główne zalety korzystania z IronPdfEngine w mojej aplikacji?

Wykorzystanie IronPdfEngine w aplikacji pozwala na zdalne wykonywanie zadań związanych z plikami PDF, co pomaga uniknąć problemów z kompatybilnością na konkretnych platformach, zwłaszcza na starszych systemach i platformach mobilnych. Eliminuje to również potrzebę korzystania ze środowiska uruchomieniowego .NET podczas wykonywania zadań.

Dłączego warto wybrać IronPdfEngine zamiast natywnej biblioteki PDF?

Możesz wybrać IronPdfEngine do zdalnego uruchamiania funkcji PDF wymagających dużej wydajności, co zmniejsza problemy z kompatybilnością z różnymi systemami operacyjnymi i poprawia wydajność dzięki wykorzystaniu renderera identycznego z Chrome do konwersji HTML na PDF.

Czy IronPdfEngine obsługuje skalowanie horyzontalne?

Nie, IronPdfEngine obecnie nie obsługuje skalowania poziomego, co oznacza, że nie można rozłożyć obciążenia na wiele instancji ze względu na sposób obsługi plików PDF w pamięci serwera.

Czy IronPdfEngine może działać na różnych systemach operacyjnych?

IronPdfEngine jest przeznaczony do działania w systemach Linux przy użyciu kontenerów Docker. Pliki binarne są jednak specyficzne dla danej platformy, dlatego należy upewnić się, że używana jest wersja odpowiednia dla danego systemu operacyjnego.

Co mam zrobić, jeśli moje pliki PDF wyglądają inaczej po użyciu IronPdfEngine?

Wyniki w formacie PDF mogą się nieznacznie różnić ze względu na różne zachowania systemów operacyjnych. Aby zminimalizować różnice, upewnij się, że używasz właściwego obrazu Docker i sprawdź, czy nie ma żadnych ustawień specyficznych dla systemu operacyjnego, które mogłyby wpłynąć na renderowanie.

Jak upewnić się, że moja aplikacja korzysta z właściwej wersji IronPdfEngine?

Aby zapewnić kompatybilność, każda wersja IronPDF wymaga odpowiedniej wersji IronPdfEngine. Należy pamiętać o jednoczesnej aktualizacji obu komponentów, aby uniknąć problemów związanych z różnicami między wersjami.

Jakie są ograniczenia związane z używaniem IronPdfEngine w systemie Windows?

Podczas korzystania z IronPdfEngine w systemie Windows potrzebne są kontenery Linux dla Docker i należy upewnić się, że port serwera jest dostępny. Pliki binarne są specyficzne dla platformy i wymagane jest przejście na kontenery Linux.

Jak skonfigurować IronPDF, aby połączyć się ze zdalnym serwerem IronPdfEngine?

Aby skonfigurować IronPDF dla serwera zdalnego, należy użyć metody Installation.ConnectToIronPdfHost z IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, podając adres IP serwera i szczegóły dotyczące portu.

Jakiego pakietu powinienem użyć, aby zminimalizować rozmiar aplikacji podczas korzystania z IronPdfEngine?

Należy użyć pakietu IronPdf.Slim z NuGet, ponieważ zawiera on tylko komponenty niezbędne do uruchomienia IronPDF z IronPdfEngine, co zmniejsza rozmiar aplikacji.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,926,724 | Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.