IRONSOFTWAREHOME

Używanie IronPDF z trybem wewnętrznym

Curtis Chau
Curtis Chau
Updated: 4 czerwca 2026

Różnica między Native a Engine

IronPDF posiada pewne funkcje wymagające intensywnego przetwarzania, które można uruchomić zdalnie. Chociaż IronPDF nie wymaga uruchomienia IronPdfEngine, skonfigurowanie IronPdfEngine jako usługi zdalnej jest opcjonalnym sposobem uniknięcia problemów z kompatybilnością platformową z Chrome na starszych systemach operacyjnych i w środowiskach mobilnych.

Zacznij korzystać z IronPDF

Start using IronPDF in your project today with a free trial.

Pierwszy krok:
arrow pointer

Jak używanie Engine zmienia sposób kodowania z IronPDF

Kiedy używasz konfiguracji Engine, zalecamy zainstalowanie IronPdf.Slim zamiast pełnego pakietu IronPdf z NuGet, ponieważ Engine zarządza całym dodatkowym balastem zawartym w pakiecie Native.

PM > Install-Package IronPdf.Slim

Po zainstalowaniu IronPdf.Slim skonfiguruj ustawienia połączenia, wskazując IronPDF na swoją instancję IronPdfEngine. Dodaj poniższy kod na początku swojego programu (lub przed wywołaniem dowolnej metody IronPDF):

Dodatkowa linia kodu konfiguracyjnego do dodania do kodu C#

Zakładając, że IronPdfEngine działa zdalnie na 123.456.7.8:33350:

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application

Jak działa IronPdfEngine?

IronPdfEngine to konteneryzowany serwer stworzony do zarządzania różnorodnymi operacjami IronPDF, w tym tworzeniem, zapisywaniem, edytowaniem i odczytem plików PDF, wszystko przy użyciu protokołu gRPC. Zbudowany jako samodzielna aplikacja C# .NET, IronPdfEngine działa niezależnie, eliminując potrzebę środowiska wykonawczego .NET podczas wykonywania. My zajmujemy się połączeniem gRPC, abyś mógł skupić się na programowaniu!

Aby szybko rozpocząć korzystanie z samodzielnego kontenera IronPDF, zapoznaj się z tym samouczkiem. Kontener Docker wspiera 16 parametrów konfiguracji czasu wykonania dla portu, logowania, limitów Chrome i więcej — zobacz pełną dokumentację parametrów.

Inne wyjaśnienia dotyczące IronPdfEngine

IronPDF .NET nie wymaga IronPdfEngine do dzialania. IronPdfEngine to tylko opcjonalny sposob na uzycie IronPDF. Domyslnie, IronPDF dla .NET nie bedzie uzywal IronPdfEngine.

Zwróć uwagę: Kazda wersja IronPDF dla .NET wymaga okreslonej wersji IronPdfEngine. Wsparcie miedzywersyjne nie jest dostepne. Dla IronPDF dla .NET wymagana wersja IronPdfEngine bedzie zawsze zgodna. Na przyklad, IronPDF 2024.2.2 bedzie uzywal IronPdfEngine 2024.2.2

IronPDF .NET ze zdalnym IronPdfEngine

Pakiet NuGet IronPdf.slim jest jedynym pakietem potrzebnym do uzywania IronPDF dla .NET ze zdalnym IronPdfEngine.

Zwróć uwagę: Jeśli używasz IronPdf lub IronPdf.Linux, możesz użyć zamiast tego IronPdf.slim, aby zmniejszyć rozmiar swojej aplikacji.

Zakładając, że IronPdfEngine działa zdalnie na 123.456.7.8:33350.

Zainstaluj IronPDF uzywajac NuGet:

PM > Install-Package IronPdf.Slim

Po zainstalowaniu IronPdf.slim, musisz tylko poinformować IronPDF, gdzie znajduje się IronPdfEngine (upewnij się, że adres jest dostępny, a nie blokowany przez zaporę sieciową). Użyj klasy IronPdfConnectionConfiguration do skonfigurowania ustawień połączenia. Dodaj ponizszy kod do poczatkowego etapu aplikacji (lub tuz przed wywolaniem jakiejkolwiek metody IronPDF).

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

To takie proste! Po tym, Twoja aplikacja będzie połączona z zdalnym IronPdfEngine!


Ograniczenia IronPdfEngine

  • Obecnie sam IronPdfEngine nie obsługuje skalowania poziomego (równoważenia obciążenia między wieloma instancjami silnika), ponieważ silnik przechowuje pliki binarne PDF w trakcie przetwarzania w pamięci serwera i wykorzystuje PdfDocumentId do koordynacji między serwerem a klientem. Ten projekt minimalizuje wykorzystanie przepustowości i zwiększa szybkość przetwarzania. Należy pamiętać, że ograniczenie to dotyczy wyłącznie usługi IronPdfEngine; aplikacje korzystające z biblioteki IronPDF (z IronPdfEngine lub bez) nadal mogą skalować się horyzontalnie poprzez wdrażanie wielu instancji aplikacji.
  • Aby uruchomić IronPdfEngine Docker zdalnie, musisz upewnić się, że port IronPdfEngine jest dostępny.
  • Docker dzialajacy na Linux x64 (Debian) uzywajac oficjalnych obrazow opartych na Ubuntu:22.04 moze produkowac wyniki PDF, ktore nieco rozni sie od tego, co uzyskalbys uruchamiajac IronPDF lokalnie ze wzgledu na rozne zachowanie systemu operacyjnego.
  • Ponieważ IronPdfEngine Docker jest oparty na systemie Linux, wymaga demona Linux Containers (wybierz Switch to Linux Containers, jeśli korzystasz z Windows).
  • Pliki binarne IronPdfEngine nie są międzyplatformowe, dlatego budujemy je specjalnie dla każdej platformy.
  • Obsługa różnych wersji nie jest dostępna.

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

Dlaczego 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
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ęczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543Wersja:2026.7właśnie wydany

Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka C# NuGet dla plików PDF
Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
  2. Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
  3. Wybierz pakiet i zainstaluj
DLL PDF dla C#
Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

  1. Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
  2. W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta