Używanie IronPDF na Linuksie
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
Oficjalnie wspierane dystrybucje Linuksa
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
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
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
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/
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:
- 64-bitowy obraz Docker Ubuntu 20.04 dla .NET Runtime 3.1 ('3.1-focal')
- 64-bitowy obraz Docker Ubuntu 20.04 dla .NET Runtime 5.0 ('5.0-focal')
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/
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:
- 64-bitowy obraz Docker Ubuntu 18.04 dla .NET Runtime 3.1 ('3.1-bionic')
- Chociaż nie ma oficjalnego obrazu dockera dla .NET 5 na Ubuntu 18, kompatybilność jest bardzo wysoka.
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/
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/
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
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:
- 64-bitowy obraz Docker Debian 11 dla .NET Runtime 3.1
- 64-bitowy obraz Docker Debian 11 dla .NET Runtime 5.0
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/
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:
- 64-bitowy obraz Docker Debian 10 dla .NET Runtime 3.1
- 64-bitowy obraz Docker Debian 10 dla .NET Runtime 5.0
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/
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
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/
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
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/
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 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
libxkbcommoni 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"
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/
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/
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
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
runtimeskatalogubin. - Może być potrzebna
sudouprawnienie.
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/
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
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
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.

