Problembehebung bei der Bereitstellung für Azure Linux App Service

Curtis Chau

Updated: 10. Juni 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Problembehebung bei der Bereitstellung für Azure Linux App Service Beim Bereitstellen von IronPDF auf einem Azure Linux App Service kann es sein, dass die Anwendung aufgrund fehlender Systembibliotheken keine PDFs rendert. Dies liegt daran, dass Linux-Umgebungen mit weniger vorinstallierten Paketen als Windows geliefert werden und die IronPDF-Rendering-Engine zusätzliche gemeinsame Bibliotheken benötigt, um zu funktionieren. ```txt Multiple issues occurred while trying to deploy Chrome (libatk-1.0.so.0: cannot open shared object file: No such file or directory) (IronInterop.so: cannot open shared object file: No such file or directory) (Read-only file system: '/home/site/wwwroot/runtimes') ``` Der Fehler bedeutet, dass eine oder mehrere gemeinsame Bibliotheken, die von `IronInterop.so` benötigt werden, in der Linux-Umgebung fehlen. Die Ausführung von `ldd IronInterop.so` aus der SSH-Konsole im App Service identifiziert genau, welche Bibliotheken fehlen. Die Meldung über das schreibgeschützte Dateisystem im Runtimes-Ordner ist ein separates Symptom derselben Fehlender-Abhängigkeit-Bedingung. ## Lösung ### Schritt 1: Fehlende Abhängigkeiten identifizieren 1. Stellen Sie den App Service wie gewohnt aus Visual Studio bereit. 2. Öffnen Sie die SSH-Konsole für Ihren Azure Linux App Service. 3. Navigieren Sie zum Verzeichnis wwwroot: ```txt cd /home/site/wwwroot ``` 4. Führen Sie `ldd` gegen die native Binärdatei aus, um nicht behobene Abhängigkeiten aufzulisten: ```txt ldd IronInterop.so ``` 5. Überprüfen Sie die Betriebssystemversion, um zu bestätigen, welche Paketnamen zutreffen: ```txt cat /etc/os-release ``` ### Schritt 2: Fehlende Bibliotheken installieren Für die meisten Linux-Distributionen (Debian/Ubuntu-basierte Images) installieren Sie die erforderlichen Pakete mit: ```txt apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0 ``` Für Ubuntu 24.04 Images (verwendet mit .NET 10) verwenden Sie stattdessen die folgende Dockerfile-Anweisung, da sich einige Paketnamen geändert haben: ```dockerfile RUN apt update \ && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev ``` ### Schritt 3: Überprüfen Sie, ob alle Abhängigkeiten behoben sind Führen Sie `ldd` erneut aus, um zu bestätigen, dass keine nicht behobenen Einträge mehr vorhanden sind: ```txt ldd IronInterop.so ``` Alle Einträge sollten einen behobenen Pfad anzeigen und nicht `not found`. Sobald alle Abhängigkeiten vorhanden sind, wird das Rendern von PDFs über die Webanwendung normal funktionieren. Für die vollständige Liste der erforderlichen Pakete über verschiedene Linux-Distributionen hinweg, siehe den [Linux-Bereitstellungsleitfaden](/get-started/linux/).

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Beim Bereitstellen von IronPDF auf einem Azure Linux App Service kann es sein, dass die Anwendung aufgrund fehlender Systembibliotheken keine PDFs rendert. Dies liegt daran, dass Linux-Umgebungen mit weniger vorinstallierten Paketen als Windows geliefert werden und die IronPDF-Rendering-Engine zusätzliche gemeinsame Bibliotheken benötigt, um zu funktionieren.

Multiple issues occurred while trying to deploy Chrome (libatk-1.0.so.0: cannot open shared object file: No such file or directory) (IronInterop.so: cannot open shared object file: No such file or directory) (Read-only file system: '/home/site/wwwroot/runtimes')

Multiple issues occurred while trying to deploy Chrome (libatk-1.0.so.0: cannot open shared object file: No such file or directory) (IronInterop.so: cannot open shared object file: No such file or directory) (Read-only file system: '/home/site/wwwroot/runtimes')

Der Fehler bedeutet, dass eine oder mehrere gemeinsame Bibliotheken, die von IronInterop.so benötigt werden, in der Linux-Umgebung fehlen. Die Ausführung von ldd IronInterop.so aus der SSH-Konsole im App Service identifiziert genau, welche Bibliotheken fehlen. Die Meldung über das schreibgeschützte Dateisystem im Runtimes-Ordner ist ein separates Symptom derselben Fehlender-Abhängigkeit-Bedingung.

Lösung

Schritt 1: Fehlende Abhängigkeiten identifizieren

1. Stellen Sie den App Service wie gewohnt aus Visual Studio bereit.
2. Öffnen Sie die SSH-Konsole für Ihren Azure Linux App Service.
3. Navigieren Sie zum Verzeichnis wwwroot:

cd /home/site/wwwroot

cd /home/site/wwwroot

4. Führen Sie ldd gegen die native Binärdatei aus, um nicht behobene Abhängigkeiten aufzulisten:

ldd IronInterop.so

ldd IronInterop.so

5. Überprüfen Sie die Betriebssystemversion, um zu bestätigen, welche Paketnamen zutreffen:

cat /etc/os-release

cat /etc/os-release

Schritt 2: Fehlende Bibliotheken installieren

Für die meisten Linux-Distributionen (Debian/Ubuntu-basierte Images) installieren Sie die erforderlichen Pakete mit:

apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0

apt-get update && apt-get install -y libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatspi2.0-0

Für Ubuntu 24.04 Images (verwendet mit .NET 10) verwenden Sie stattdessen die folgende Dockerfile-Anweisung, da sich einige Paketnamen geändert haben:

RUN apt update \
    && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

RUN apt update \
    && apt install -y sudo libxkbcommon-x11-0 libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2t64 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

Schritt 3: Überprüfen Sie, ob alle Abhängigkeiten behoben sind

Führen Sie ldd erneut aus, um zu bestätigen, dass keine nicht behobenen Einträge mehr vorhanden sind:

ldd IronInterop.so

ldd IronInterop.so

Alle Einträge sollten einen behobenen Pfad anzeigen und nicht not found. Sobald alle Abhängigkeiten vorhanden sind, wird das Rendern von PDFs über die Webanwendung normal funktionieren. Für die vollständige Liste der erforderlichen Pakete über verschiedene Linux-Distributionen hinweg, siehe den Linux-Bereitstellungsleitfaden.

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...

Weiterlesen