Używanie IronPDF na Linuksie

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

IronPDF obsługuje Linuksa dla .NET 10, 9, 8, 7, 6, 5 i aplikacji .NET Core, a także Docker, Azure, AWS, macOS i (naturalnie) Windows.

Oficjalnie wspierane konteneryzacja i hosting

Linux V1 related to Używanie IronPDF na Linuksie Docker related to Używanie IronPDF na Linuksie Azure 1 related to Używanie IronPDF na Linuksie Amazon Web Services related to Używanie IronPDF na Linuksie

Oficjalnie wspierane dystrybucje Linuksa

Ubuntu V1 related to Używanie IronPDF na Linuksie Debian V1 related to Używanie IronPDF na Linuksie Centos V1 related to Używanie IronPDF na Linuksie

Wskazówki dotyczące IronPDF na Linuksie

Zalecamy użycie .NET Core 8.0 i innych środowisk oznaczonych jako LTS przez Microsoft, ponieważ mają one gwarantowane długoterminowe wsparcie i są ogólnie dobrze testowane na Linuksie.

Do uruchomienia IronPDF na Linuksie nie są wymagane zmiany w kodzie. Ogólnie IronPDF działa od razu, dzięki rozległym testom i konfiguracji przez naszych inżynierów.

Wsparcie dla Linuksa jest ważne, ponieważ wiele usług w chmurze, takich jak Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda i Azure DevOps Docker, mocno opiera się na Linuksie. W Iron Software regularnie używamy tych narzędzi chmurowych i rozumiemy, że wielu naszych klientom z sektora Enterprise i SAAS także z nich korzysta.

Przeczytaj naszą obszerną dokumentację na temat korzystania z IronPDF na Dockerze, jeśli potrzebujesz pomocy przy konfiguracji. Możesz także użyć IronPDF na Linuksie z Windowsa dzięki WSL, co jest inną popularną opcją.

Pakiety specyficzne dla Linuksa

NuGet

Pobieranie DLL

W celu korzystania w trybie offline można pobrać bibliotekę DLL i dodać odwołanie do swojego projektu.

Dokumentację dotyczącą pakietów Linuksowych i wielu innych pakietów dla systemów operacyjnych można znaleźć w naszym przewodniku zaawansowanej instalacji NuGet dla IronPDF.

Oficjalnie wspierane dystrybucje Linuksa

Oficjalnie wspieramy i zalecamy najnowsze systemy operacyjne Linuksowe 64-bitowe poniżej dla instalacji IronPDF bez jakiejkolwiek konfiguracji.

  • Ubuntu 24
  • Ubuntu 22
  • Ubuntu 20
  • Ubuntu 18
  • Ubuntu 16
  • Debian 11
  • Debian 10
  • CentOS 8
  • Fedora Linux 33
  • Amazon AWS Linux 2
  • Amazon AWS Linux 2023

Jeśli instalujesz IronPDF na niewspieranej wersji Linuksa, zobacz Wzorce zależności dla Linuksa na końcu tego dokumentu.

Specyfikacja sprzętowa

IronPDF używa Chromium do renderowania HTML do PDF. Silnik Chromium renderuje PDF-y z dokładnością do pikseli z funkcją druku Chrome. Specyfikacje sprzętowe głównie dotyczą uruchamiania silnika Chromium, który wymaga znacznej mocy obliczeniowej.

  • Minimalne: 1 rdzeń i 1,75 GB pamięci RAM
  • Zalecane: 2 rdzenie i 8 GB pamięci RAM lub więcej

Automatyczna konfiguracja Linuksa

Domyślne ustawienie LinuxAndDockerDependenciesAutoConfig ustawione na true będzie próbowało automatycznie zainstalować wszystkie zależności dla uruchomienia IronPDF na Linuksie. Obejmuje to obsługę różnic w pakietach specyficznych dla platform, takich jak libasound2t64 na Ubuntu 24.04. Pierwsza operacja HTML do PDF może zająć dłużej niż zwykle.

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
' Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
$vbLabelText   $csharpLabel

Zgodność z Ubuntu

Ubuntu jest naszym najczęściej testowanym systemem operacyjnym Linuksa, mocno używanym w infrastrukturze Azure do ciągłego testowania i wdrażania. Ta platforma ma również oficjalne wsparcie Microsoft dla .NET i oficjalne obrazy Docker.

Ubuntu 24

Microsoft related to Ubuntu 24 Ubuntu V1 related to Ubuntu 24 Chrome V1 related to Ubuntu 24 Docker related to Ubuntu 24 Azure 1 related to Ubuntu 24

Wspieramy Ubuntu 24 (24.04 LTS) bez potrzeby konfiguracji.

  • Obsługuje silnik renderowania HTML do PDF oparty na Chrome
  • Oficjalnie wspiera środowiska uruchomieniowe .NET 6 (LTS), 7, 8, 9 i 10
  • Przed każdą wersją przeprowadzamy ponad 997 testów jednostkowych na tej platformie

Zwróć uwagęUbuntu 24.04 zmienił nazwy kilku bibliotek systemowych z przyrostkiem t64. Poniższa ręczna konfiguracja odzwierciedla te zmiany, na przykład libasound2 jest teraz libasound2t64, libgtk2.0-0 jest teraz libgtk2.0-0t64, libcups2 jest teraz libcups2t64, a libatk-bridge2.0-0 jest teraz libatk-bridge2.0-0t64.

Ręczna konfiguracja Ubuntu 24

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libcups2t64
apt install -y libgtk2.0-0t64
apt install -y libnss3
apt install -y libatk-bridge2.0-0t64
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2t64
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libcups2t64
apt install -y libgtk2.0-0t64
apt install -y libnss3
apt install -y libatk-bridge2.0-0t64
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2t64
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Ubuntu 20

Microsoft related to Ubuntu 20 Ubuntu V1 related to Ubuntu 20 Chrome V1 related to Ubuntu 20 Safari V1 related to Ubuntu 20 Docker related to Ubuntu 20 Azure 1 related to Ubuntu 20

Wspieramy Ubuntu 20 bez potrzeby konfiguracji.

  • Obsługuje silniki renderowania HTML do PDF oparte na Chrome i WebKit
  • Oficjalnie wspiera środowiska uruchomieniowe .NET Core 3.1, 5, 6 (LTS), 7 i 8
  • Nieoficjalnie wspiera wiele innych środowisk .NET Core na Ubuntu 20
  • Przed każdą wersją przeprowadzamy ponad 997 testów jednostkowych na tej platformie

Oficjalne obrazy Docker od Microsoft:

Ręczna konfiguracja Ubuntu 20

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Ubuntu 18

Microsoft related to Ubuntu 18 Ubuntu V1 related to Ubuntu 18 Chrome V1 related to Ubuntu 18 Safari V1 related to Ubuntu 18 Docker related to Ubuntu 18 Azure 1 related to Ubuntu 18

Wspieramy Ubuntu 18 od razu, bez potrzeby konfiguracji.

  • Obsługuje silniki renderowania HTML do PDF oparte na Chrome i WebKit
  • Oficjalne wsparcie dla .NET Core 3.1 LTS i środowisk .NET 5
  • Nieoficjalnie wspiera wiele innych środowisk .NET Core na Ubuntu 18 i 16
  • Przeprowadzamy kompleksowe testy na tej platformie przed każdą wersją

Oficjalne obrazy Docker od Microsoft:

Ręczna konfiguracja Ubuntu 18

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Ubuntu 16

Ubuntu V1 related to Ubuntu 16 Test related to Ubuntu 16

Mamy ograniczone wsparcie dla Ubuntu 16. Środowisko .NET na Ubuntu 16 jest oficjalnie wspierane przez Microsoft i według wielu użytkowników działa z IronPdf. Programiści mogą potrzebować zainstalować dodatkowezależności ręcznie.

  • Chrome i WebKit działają zazwyczaj z manualną konfiguracją.
  • Środowiska .NET Core 3.1 LTS i .NET 5 są wspierane przez Microsoft na Ubuntu 16.
  • Aktualnie nie ma oficjalnych obrazów Docker od Microsoft dla Ubuntu 16.

Ręczna konfiguracja Ubuntu 16

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Zgodność z Debianem

Debian jest naszym drugim najczęściej testowanym systemem operacyjnym Linuksa. Ta platforma ma również oficjalne wsparcie Microsoft dla .NET i oficjalne obrazy Docker.

Debian 11

Debian related to Debian 11 Microsoft related to Debian 11 Chrome V1 related to Debian 11 Safari V1 related to Debian 11 Docker related to Debian 11 Azure 1 related to Debian 11

Wspieramy Debian 11 od razu, bez potrzeby konfiguracji.

  • Obsługuje silniki renderowania HTML do PDF oparte na Chrome i WebKit
  • Oficjalnie wspiera środowiska uruchomieniowe .NET Core 3.1, 5, 6 (LTS), 7 i 8
  • Nieoficjalnie wspiera wiele innych środowisk .NET Core na Debianie 11
  • Przed każdą wersją przeprowadzamy ponad 997 testów jednostkowych na tej platformie

Oficjalne obrazy Docker od Microsoft:

Ręczna konfiguracja Debian 11

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Debian 10

Debian related to Debian 10 Microsoft related to Debian 10 Chrome V1 related to Debian 10 Safari V1 related to Debian 10 Docker related to Debian 10 Azure 1 related to Debian 10

Wspieramy Debian 10 od razu, bez potrzeby konfiguracji.

  • Obsługuje silniki renderowania HTML do PDF oparte na Chrome i WebKit
  • Oficjalnie wspiera środowiska uruchomieniowe .NET Core 3.1, 5, 6 (LTS), 7 i 8
  • Nieoficjalnie wspiera wiele innych środowisk .NET Core na Debianie 10
  • Przed każdą wersją przeprowadzamy ponad 997 testów jednostkowych na tej platformie

Oficjalne obrazy Docker od Microsoft:

Ręczna konfiguracja Debian 10

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Debian 9 i niższe

Debian related to Debian 9 i niższe Test related to Debian 9 i niższe

Debian 9 nie jest oficjalnie testowany i nie będzie działał od razu z IronPdf. Jednak .NET na Debianie 9 jest oficjalnie wspierany przez Microsoft i może działać z IronPdf, jeśli zostanie prawidłowo skonfigurowany. Zapoznaj się z Wzorcami zależności dla Linuksa na końcu tego dokumentu.

Nie ma oficjalnych obrazów Docker od Microsoft dla .NET Core 3.1 lub .NET 5.0 na Debian 9. Zalecamy silnie przejście na Debian 10.

Zgodność z CentOS

Centos related to Zgodność z CentOS Chrome V1 related to Zgodność z CentOS Safari V1 related to Zgodność z CentOS Test related to Zgodność z CentOS

Aktywnie wspieramy CentOS.

Wsparcie dla CentOS 8

Wspieramy CentOS 8 od razu, bez potrzeby konfiguracji.

  • Obsługuje silniki renderowania HTML do PDF oparte na Chrome i WebKit
  • Oficjalnie wspiera środowiska uruchomieniowe .NET Core 3.1, 5, 6 (LTS), 7 i 8
  • Nieoficjalnie wspiera wiele innych środowisk .NET Core na CentOS
  • Przeprowadzamy kompleksowe testy na tej platformie przed każdą wersją

Niestety, nie ma oficjalnych obrazów Docker od Microsoft dla .NET Core 3.1 lub .NET 5.0 na CentOS 8.

Ręczna konfiguracja CentOS 8

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo:

Ustaw IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

CentOS 7 i starsze

CentOS 7 nie był testowany i nie będzie działać od razu z IronPdf.

Jednak .NET na CentOS 7 jest oficjalnie wspierany przez Microsoft i prawdopodobnie zadziała z IronPdf, jeśli zostanie prawidłowo skonfigurowany. Przeczytaj poniżej Wzorce zależności dla Linuksa.

Nie ma oficjalnych obrazów Docker od Microsoft dla .NET Core 3.1 lub .NET 5.0 na CentOS 7.

Zgodność z Amazon AWS Linux 2

Amazon Web Services related to Zgodność z Amazon AWS Linux 2 Chrome V1 related to Zgodność z Amazon AWS Linux 2 Safari V1 related to Zgodność z Amazon AWS Linux 2 Test related to Zgodność z Amazon AWS Linux 2

Mamy działające wsparcie dla Amazon AWS Linux 2, które stanowi podstawę usług chmurowych Amazon, takich jak EC2 i Lambda.

  • Nie ma oficjalnych obrazów Docker od Microsoft dla .NET Core 3.1 lub .NET 5.0 na Amazon AWS Linux 2.
  • Ręcznie testujemy zgodność z Amazon AWS Linux 2 podczas tworzenia IronPDF.

Zalecamy, aby zapoznać się z naszym przewodnikiem IronPDF AWS Lambda, który zawiera działający plik Docker dla IronPdf na AWS Lambda.

Ręczna konfiguracja Amazon Linux 2

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Update and install necessary libraries
yum update -y
yum install -y pango.x86_64
yum install -y libXcomposite.x86_64
yum install -y libXcursor.x86_64
yum install -y libXdamage.x86_64
yum install -y libXext.x86_64
yum install -y libXi.x86_64
yum install -y libXtst.x86_64
yum install -y cups-libs.x86_64
yum install -y libXScrnSaver.x86_64
yum install -y libXrandr.x86_64
yum install -y GConf2.x86_64
yum install -y alsa-lib.x86_64
yum install -y atk.x86_64
yum install -y gtk3.x86_64
yum install -y ipa-gothic-fonts
yum install -y xorg-x11-fonts-100dpi
yum install -y xorg-x11-fonts-75dpi
yum install -y xorg-x11-utils
yum install -y xorg-x11-fonts-cyrillic
yum install -y xorg-x11-fonts-Type1
yum install -y xorg-x11-fonts-misc
yum install -y glibc-devel.x86_64
yum install -y at-spi2-atk.x86_64
yum install -y mesa-libgbm.x86_64
yum install -y libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
yum update -y
yum install -y pango.x86_64
yum install -y libXcomposite.x86_64
yum install -y libXcursor.x86_64
yum install -y libXdamage.x86_64
yum install -y libXext.x86_64
yum install -y libXi.x86_64
yum install -y libXtst.x86_64
yum install -y cups-libs.x86_64
yum install -y libXScrnSaver.x86_64
yum install -y libXrandr.x86_64
yum install -y GConf2.x86_64
yum install -y alsa-lib.x86_64
yum install -y atk.x86_64
yum install -y gtk3.x86_64
yum install -y ipa-gothic-fonts
yum install -y xorg-x11-fonts-100dpi
yum install -y xorg-x11-fonts-75dpi
yum install -y xorg-x11-utils
yum install -y xorg-x11-fonts-cyrillic
yum install -y xorg-x11-fonts-Type1
yum install -y xorg-x11-fonts-misc
yum install -y glibc-devel.x86_64
yum install -y at-spi2-atk.x86_64
yum install -y mesa-libgbm.x86_64
yum install -y libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Przeczytaj również naszą dokumentację dotyczącą naszego oficjalnego wsparcia IronPdf dla AWS Lambda, która obejmuje instalację i logowanie na platformie chmurowej Amazon.

Amazon Linux 2023

Amazon Web Services related to Amazon Linux 2023 Chrome V1 related to Amazon Linux 2023 Test related to Amazon Linux 2023

Amazon Linux 2023 jest oparty na Fedora i wspierany z ręczną konfiguracją. Używa dnf jako swojego menedżera pakietów.

  • Obsługuje silnik renderowania HTML do PDF oparty na Chrome
  • Wymaga ręcznej instalacji libxkbcommon i innych zależności kompatybilnych z Fedora
  • Ręcznie testujemy zgodność z Amazon Linux 2023 podczas tworzenia IronPDF

Zalecana konfiguracja

Zalecane są następujące ustawienia podczas wdrażania IronPDF na Amazon Linux 2023:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.CustomDeploymentDirectory = "/tmp";
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
IronPdf.Installation.AutomaticallyDownloadNativeBinaries = true;
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
IronPdf.Installation.CustomDeploymentDirectory = "/tmp";
Imports IronPdf

Installation.LinuxAndDockerDependenciesAutoConfig = True
Installation.AutomaticallyDownloadNativeBinaries = True
Installation.ChromeGpuMode = Engines.Chrome.ChromeGpuModes.Disabled
Installation.CustomDeploymentDirectory = "/tmp"
$vbLabelText   $csharpLabel

Ręczna konfiguracja Amazon Linux 2023

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie. Lista zależności jest zgodna z Ręczną konfiguracją Fedora Linux z dodatkiem libxkbcommon.

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence
dnf -y install libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence
dnf -y install libxkbcommon

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Zgodność z Fedora Linux

Fedora Linux jest wspierany od razu, bez potrzeby konfiguracji.

  • Obsługuje silniki renderowania HTML do PDF oparte na Chrome i WebKit
  • Oficjalnie wspiera środowiska uruchomieniowe .NET Core 3.1, 5, 6 (LTS), 7 i 8
  • Przeprowadzamy kompleksowe testy na tej platformie przed każdą wersją

Ręczna konfiguracja Fedora Linux

Jeśli konieczna jest ręczna instalacja lub twoja aplikacja nie może być uruchomiona z uprawnieniami administratora sudo. Ustaw właściwość IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig na fałsz i zainstaluj zależności ręcznie.

# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Install necessary libraries
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Zgodność z Alpine Linux

Uruchamianie IronPDF na Alpine Linux nie jest wspierane. Na 2023 rok Alpine wciąż używa przestarzałych bibliotek języka C 'musl', które nie pozwalają deweloperom Chromium w pełni wspierać tego systemu.

Użycie Docker Alpine z IronPdfEngine w .NET 6

IronPdf dostarcza obraz kontenera zawierający wszystkie funkcjonalności IronPdf. Pozwala to na dostęp do funkcjonalności IronPdf przez projekty uruchamiane na Alpine, łącząc się z kontenerem IronPdfEngine.

Krok 1: Pobierz i uruchom obraz Docker IronPdf Engine

Wykonaj poniższe polecenia w terminalu, aby pobrać i uruchomić obraz Docker IronPdf Engine:

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
SHELL

Krok 2: Skonfiguruj aplikację konsolową

  • Utwórz nową aplikację konsolową, która celuje w .NET 6.
  • Zainstaluj pakiet NuGet IronPdf.Slim za pomocą menedżera pakietów NuGet.

Dowiedz się więcej o korzystaniu z IronPdfEngine.

Inne dystrybucje Linuksa

Możesz ręcznie zainstalować wymagania wstępne IronPDF dla Linuksa, używając apt-get, hfs i yum. Pozwala to na korzystanie z IronPDF na wielu nieoficjalnie wspieranych dystrybucjach Linuksa.

Podczas pierwszej instalacji IronPDF może zgłaszać wyjątki, aby poinformować o żadnych zależnościach systemowych.

  • IronCefSubprocess wspomniany jest plikiem binarnym w folderze bin twojej aplikacji. Może być potrzeba określenia dokładnej ścieżki, która może znajdować się w podkatalogu runtimes katalogu bin.
  • Może być potrzebna sudo uprawnienie.

Jeśli nie jesteś pewny, jak postępować z nieopisaną dystrybucją Linuksa, zbadaj zależności dla przeglądarki Chromium na tym systemie.

Aby poprosić o oficjalne wsparcie dla innej dystrybucji Linuksa, proszę skontaktować się z support@ironsoftware.com.

Wspólne wzorce zależności dla Linuksa

Zapoznaj się z pakietami zależności dla innych systemów operacyjnych Linuksowych powyżej.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Identyfikacja brakujących zależności

ldd to potężne narzędzie do diagnozowania brakujących zależności. Przez uruchomienie ldd IronInterop.so możesz zobaczyć listę wszystkich współdzielonych bibliotek wymaganych przez aplikację. Komunikat "not found" obok biblioteki, jak libcef.so => not found, wskazuje krytyczną brakującą zależność, która uniemożliwi poprawne działanie programu. Plik IronInterop.so znajduje się w folderze native specyficznym dla systemu operacyjnego. Na przykład, bin/Debug/net6.0/runtimes/linux-x64/native.

ldd IronInterop.so
ldd IronInterop.so
SHELL

IronCefSubprocess

IronCefSubprocess to plik binarny w folderze twojej aplikacji bin. Musi być możliwy do wykonywania przez proces .NET.

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess
# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess
SHELL

Często Zadawane Pytania

How can I convert HTML to PDF in C# on Linux?

You can use IronPDF's RenderHtmlAsPdf method to convert HTML strings into PDFs on Linux. This allows you to generate PDF documents directly from HTML content.

What are the system requirements for using PDF libraries on Linux?

To use IronPDF on Linux, the minimum hardware requirements are 1 Core and 1.75 GB of RAM. For optimal performance, it is recommended to have 2 Cores and 8 GB of RAM, leveraging the Chromium engine for rendering.

Which Linux distributions are compatible with PDF generation tools?

IronPDF supports Ubuntu 24, 22, 20, 18, 16, Debian 11, 10, CentOS 8, Fedora Linux 33, Amazon AWS Linux 2, and Amazon AWS Linux 2023 for PDF generation, providing a zero-configuration setup for seamless integration.

Can I integrate PDF generation with Docker on Linux?

Yes, IronPDF can be integrated with Docker on Linux. By setting LinuxAndDockerDependenciesAutoConfig to true, IronPDF will attempt to automatically install all necessary dependencies for running within Docker.

How do I install PDF generation tools on a Linux environment?

Install IronPDF on Linux using the NuGet package IronPdf.Linux or download the DLL from the IronPDF website. Ensure all dependencies are properly installed and that IronCefSubprocess is set as executable.

Which .NET versions are suitable for PDF generation on Linux platforms?

IronPDF supports .NET 10, 9, 8, 7, 6, 5, and .NET Core for PDF generation on Linux. It is advisable to use long-term support (LTS) versions like .NET Core 3.1 for stability and performance.

Is it feasible to run PDF generation on Alpine Linux?

Direct usage of IronPDF on Alpine Linux is unsupported due to compatibility issues with musl C libraries. However, using an IronPdfEngine Docker container can facilitate PDF functionalities on Alpine.

What should I do if I encounter a missing dependency error with PDF tools on Linux?

If a missing dependency error occurs, manually install the necessary packages using package managers like apt-get, dnf, or yum, based on your Linux distribution's requirements.

Can unsupported Linux distributions use PDF generation tools?

IronPDF may be used on unsupported Linux distributions by manually installing required dependencies. Consulting Chromium dependencies is recommended for guidance on manual installations.

How can I enhance PDF generation performance in a Linux environment?

To optimize IronPDF on Linux, ensure LinuxAndDockerDependenciesAutoConfig is enabled for automatic dependency setup. Utilize Linux-optimized NuGet packages and establish a writable directory for temporary files.

Is there a specific guide for setting up PDF tools on AWS Lambda?

Yes, IronPDF provides an AWS Lambda Setup Guide available on their website, offering detailed instructions on configuring IronPDF for use within AWS Lambda environments.

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

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,560,885 | Wersja: 2026.4 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.