--- url: https://next.zammad.org/de/reference/proxy-connections.md --- # Proxy und Verbindungen ## Proxy Dieser Abschnitt beinhaltet die Proxy-Konfiguration mittels Umgebungsvariablen. Alternativ ist die Proxy-Konfiguration auch über die Zammad-Benutzeroberfläche möglich. Weitere Informationen dazu finden Sie im Netzwerk-Abschnitt der Admin-Dokumentation. | | GUI Konfiguration | Umgebungsvariable | |----------------------------------------------|-------------------|---------------------------| | Zugriff auf Host-OS erforderlich | Nein | Ja | | Automatische Ausnahme von Loopback-Adressen | Ja | Nein | | Konfigurationsprüfung | Ja | Manuell per Test-Skript | | Ausnahmen | Ja | Nein | Die folgenden Umgebungsvariablen können zur Konfiguration der Proxy-Einstellungen verwendet werden. Passen Sie die Werte entsprechend Ihrer Umgebung an. `HTTP_PROXY` : Variable für HTTP-Verkehr. Setzen Sie sie auf die Adresse Ihres Proxy-Servers, einschließlich des Ports. Funktioniert nicht im Docker-Kontext. Beispiel: ```sh export HTTP_PROXY="http://127.0.0.1:8080" ``` `HTTPS_PROXY` : Variable für HTTPS-Verkehr. Setzen Sie sie auf die Adresse Ihres Proxy-Servers, einschließlich des Ports. Funktioniert nicht im Docker-Kontext. Beispiel: ```sh export HTTPS_PROXY="http://127.0.0.1:8080" ``` `NO_PROXY` : Variable für Adressen, auf die direkt und ohne Proxy zugegriffen werden soll. Erwartet eine kommagetrennte Liste von Adressen und unterstützt Wildcards. Verwenden Sie einen führenden `.` als Platzhalter für Subdomains. Das Beispiel `.example.com` schließt example.com und alle seine Subdomains ein. Achten Sie darauf, dass Sie Loopback-Adressen einschließen, damit sie nicht über den Proxy geleitet werden. Beispiel: ```sh export NO_PROXY="localhost,127.0.0.1,.example.com" ``` `ES_JAVA_OPTS` : Variable für die Einstellung eines Proxys für Elasticsearch. Standardmäßig kommuniziert Elasticsearch nicht mit externen Systemen während des Betriebs. Es kann jedoch Fälle geben, in denen dies erforderlich ist. Beispiel: ```sh export ES_JAVA_OPTS="-Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=8080 -Dhttps.proxyHost=127.0.0.1 -Dhttps.proxyPort=8080" ``` ::: tip Je nach Ihrer Umgebung benötigen Sie vielleicht auch die klein geschriebene Variante der Variablen. Im Zweifelsfall setzen Sie beide Varianten, indem Sie sie zusätzlich mit den Werten der großgeschriebenen Varianten angeben: ```sh export http_proxy=$HTTP_PROXY ``` ::: ## Externe Verbindungen Während der Installation und des Betriebs von Zammad sind einige Verbindungen zu Online-Diensten erforderlich. Abhängig von Ihrer Installationsmethode und der Konfiguration von Zammad wird eine Verbindung zu den folgenden Diensten hergestellt (vielleicht auch hilfreich für die Firewall-Konfiguration): | Addresse | Kommentar | |------------------------------|-------------------------------------------------------| | dl.packager.io | Download des OS-Pakets (Paketinstallation) | | go.packager.io | Wie oben; neuer Paket-Hosting-Dienst | | geo.zammad.com | Wird für Geodaten verwendet | | google.com | Download von Feiertagen für den Kalender | | index.rubygems.org | Download von Gems für Ruby | | registry.npmjs.org | Download von JS-Abhängigkeiten | Sie können ein Skript verwenden, um den Verbindungsstatus Ihres Systems zu überprüfen. Es versucht, eine Verbindung zu den oben genannten Diensten herzustellen und zeigt das Ergebnis an. Wenn alle Verbindungen erfolgreich waren, zeigt es für jeden kontaktierten Dienst ein Häkchen an. Führen Sie es aus, indem Sie es entweder aus der Paketquelle von Zammad abrufen oder die lokale Version auf Ihrem Zammad-Server ausführen. **Skript online abrufen:** ```sh curl -fsSL https://raw.githubusercontent.com/zammad/zammad/refs/heads/stable/contrib/packager.io/test_download_dependencies_connection.sh | sh ``` **Lokales Skript verwenden:** ```sh /opt/zammad/contrib/packager.io/test_download_dependencies_connection.sh ``` ## Web-Push-Benachrichtigungen Zammad kann Agenten über ihre Tickets auf mobilen Geräten benachrichtigen. Diese Benachrichtigungen werden als Web-Push-Nachrichten über den Browser des Geräts übermittelt. Auf Android können sowohl ein kompatibler Browser als auch die installierte Ansicht diese empfangen. Auf iPhone und iPad muss die Mobilansicht zuerst zum Startbildschirm hinzugefügt werden. Wie man sie auf einem Gerät einrichtet, wird in der [Mobilansicht-Dokumentation](/de/documentation/use/guides/mobile-view) beschrieben. Die Nachrichten werden über HTTPS (Port 443) vom Hintergrundprozess von Zammad an den Push-Dienst des Browseranbieters gesendet. Eine Firewall, die ausgehenden Datenverkehr beschränkt, muss die folgenden Adressen, einschließlich ihrer Subdomains, zulassen: | Addresse | Kommentar | |-----------------------------|-------------------------------------------------------| | fcm.googleapis.com | Web Push für Chrome und andere Chromium-basierte Browser | | jmt17.google.com | Alternative Adresse des Google Push-Service | | notify.windows.com | Web Push für Microsoft Edge | | push.services.mozilla.com | Web Push für Mozilla Firefox | | web.push.apple.com | Web Push für Safari auf iPhone, iPad und Mac | Die obige Proxy-Konfiguration gilt auch für diese Verbindungen, einschließlich der No-Proxy-Liste in der GUI-Konfiguration und der `NO_PROXY`-Umgebungsvariable. Zammad akzeptiert nur Geräteabonnements der oben aufgelisteten Push-Dienste. Ein Browser, der einen anderen Push-Dienst verwendet, kann Push-Benachrichtigungen nicht aktivieren. In Zammad müssen keine Einstellungen vorgenommen werden. Das Schlüsselpaar, das zur Signierung der Nachrichten verwendet wird (VAPID), wird einmalig pro Installation generiert und sollte nicht geändert werden: Alle bestehenden Geräteabonnements werden ungültig, sobald die Schlüssel geändert werden. Der Push-Dienst des Browser-Anbieters übermittelt die Nachrichten, nicht Zammad. Je nach Gerät kann die Zustellung eine Weile dauern, beispielsweise auf Android-Geräten durch die Akkuoptimierung. Eine Nachricht, die nicht sofort zugestellt werden kann, wird vom Push-Dienst bis zu einem Tag lang gespeichert. Auf dem iPhone und dem iPad bleiben mehrere Nachrichten zum selben Ticket als separate Benachrichtigungen bestehen, während andere Plattformen die vorherige Benachrichtigung ersetzen.