[comment]: # ({e62e1497-e62e1497})
# 5 Installation aus Containern

[comment]: # ({/e62e1497-e62e1497})

[comment]: # ({5f71f243-a3ac452e})
### Übersicht

Diese Seite beschreibt, wie Zabbix mit Docker oder Docker Compose bereitgestellt wird.

[Docker Compose](#docker-compose) ist der schnellste Weg, Zabbix bereitzustellen.
Es liest eine Konfigurationsdatei und startet automatisch alle Container, aus denen eine vollständige Zabbix-Installation besteht, in der richtigen Reihenfolge.

[Docker (manuelle Bereitstellung)](#docker-manual-deployment) erreicht dasselbe Ergebnis, indem jede Komponente Schritt für Schritt bereitgestellt wird.

[comment]: # ({/5f71f243-a3ac452e})

[comment]: # ({b13b686a-fba82ded})
### Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Docker (1.12.0 oder höher) auf Ihrem System installiert ist.
Falls nicht, folgen Sie der [Docker-Installationsanleitung](https://docs.docker.com/engine/install/).
Für die Bereitstellung mit Docker Compose ist außerdem Docker Compose (2.24.0 oder höher) erforderlich.

Für einige Zabbix-Komponenten müssen auf dem Host, auf dem Docker ausgeführt wird, bestimmte Ports geöffnet sein (z. B. 10051/TCP für den Zabbix Server, 162/UDP für SNMP-Traps).
Eine vollständige Liste der von Zabbix-Komponenten verwendeten Ports finden Sie unter [Anforderungen](/manual/installation/requirements#default-port-numbers).
Für den Zabbix Server und den Agent kann der Standardport durch Setzen der Umgebungsvariable `ZBX_LISTENPORT` im jeweiligen Container geändert werden.

[comment]: # ({/b13b686a-fba82ded})

[comment]: # ({6c7779eb-f9acea87})
### Verfügbare Docker-Images

Zabbix stellt für jede Zabbix-Komponente ein Docker-Image bereit, die alle auf [Docker Hub](https://hub.docker.com/u/zabbix) veröffentlicht sind.
Jedes Image wird verwendet, um einen Container zu erstellen, der diese Komponente ausführt.

|Zabbix-Komponente|Docker-Image|
|--|--------|
|Agent|[zabbix/zabbix-agent](https://hub.docker.com/r/zabbix/zabbix-agent/)|
|Agent 2|[zabbix/zabbix-agent2](https://hub.docker.com/r/zabbix/zabbix-agent2)|
|Server (MySQL)|[zabbix/zabbix-server-mysql](https://hub.docker.com/r/zabbix/zabbix-server-mysql/)|
|Server (PostgreSQL)|[zabbix/zabbix-server-pgsql](https://hub.docker.com/r/zabbix/zabbix-server-pgsql/)|
|Web-Frontend (Apache + MySQL)|[zabbix/zabbix-web-apache-mysql](https://hub.docker.com/r/zabbix/zabbix-web-apache-mysql/)|
|Web-Frontend (Apache + PostgreSQL)|[zabbix/zabbix-web-apache-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-apache-pgsql/)|
|Web-Frontend (Nginx + MySQL)|[zabbix/zabbix-web-nginx-mysql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-mysql/)|
|Web-Frontend (Nginx + PostgreSQL)|[zabbix/zabbix-web-nginx-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-pgsql/)|
|Proxy (SQLite3)|[zabbix/zabbix-proxy-sqlite3](https://hub.docker.com/r/zabbix/zabbix-proxy-sqlite3/)|
|Proxy (MySQL)|[zabbix/zabbix-proxy-mysql](https://hub.docker.com/r/zabbix/zabbix-proxy-mysql/)|
|Java gateway|[zabbix/zabbix-java-gateway](https://hub.docker.com/r/zabbix/zabbix-java-gateway/)|
|Web service|[zabbix/zabbix-web-service](https://hub.docker.com/r/zabbix/zabbix-web-service)|
|SNMP traps|[zabbix/zabbix-snmptraps](https://hub.docker.com/r/zabbix/zabbix-snmptraps/)|

::: noteclassic
Um [SNMP traps](/manual/config/items/itemtypes/snmptrap) zu verwenden, muss der SNMP-traps-Container ein Volume mit dem Zabbix-Server- oder Proxy-Container gemeinsam nutzen (siehe [Verwendung dieses Images](https://hub.docker.com/r/zabbix/zabbix-snmptraps#how-to-use-this-image) auf Docker Hub und das [Beispiel](#deploy-zabbix-server-postgresql-with-snmp-traps) unten).
:::

Alle Zabbix-Komponenten-Images auf Docker Hub basieren auf den neuesten Hauptversionen der [unterstützten Betriebssysteme](#image-tags).
Diese Images werden automatisch neu erstellt, wenn die zugrunde liegenden OS-Images aktualisiert werden.

[comment]: # ({/6c7779eb-f9acea87})

[comment]: # ({a7a01d95-e498c2aa})
#### Image-Tags

Jedes Image unterstützt Tags zur Auswahl des Basisbetriebssystems und der Zabbix-Version:

```default
zabbix/<image>:<os>-<version>
```

Unterstützte `<os>`-Werte:

-   `alpine` - Alpine Linux
-   `ubuntu` - Ubuntu
-   `centos` - CentOS Stream
-   `ol` - Oracle Linux
-   `ltsc2022` - Windows 11 LTSC 2022 (nur Zabbix Agent)

Unterstützte `<version>`-Werte:

-   `latest` - Neueste stabile Zabbix-Version auf Alpine Linux
-   `<os>-latest` - Neueste stabile Zabbix-Version auf dem ausgewählten Betriebssystem
-   `<os>-trunk` - Neuester Entwicklungs- (Nightly-) Build auf dem ausgewählten Betriebssystem
-   `<os>-X.X-latest` - Neueste Zabbix-Nebenversion einer bestimmten Zabbix-Hauptversion auf dem ausgewählten Betriebssystem
-   `<os>-X.X.*` - Bestimmte Zabbix-Nebenversion auf dem ausgewählten Betriebssystem

Beispiele:

```bash
# Neuester stabiler Zabbix-Proxy (SQLite3) auf Alpine Linux:
docker pull zabbix/zabbix-proxy-sqlite3:latest

# Neuester stabiler Zabbix-Proxy (SQLite3) auf Ubuntu:
docker pull zabbix/zabbix-proxy-sqlite3:ubuntu-latest

# Neuester Entwicklungs- (Nightly-) Build des Zabbix-Servers (MySQL) auf Ubuntu:
docker pull zabbix/zabbix-server-mysql:ubuntu-trunk

# Neueste 7.0-Nebenversion des Zabbix-Servers (MySQL) auf Alpine Linux:
docker pull zabbix/zabbix-server-mysql:alpine-7.0-latest

# Version 7.0.1 des Zabbix-Servers (MySQL) auf Alpine Linux:
docker pull zabbix/zabbix-server-mysql:alpine-7.0.1
```

[comment]: # ({/a7a01d95-e498c2aa})

[comment]: # ({a76784bc-c443c22e})
### Docker Compose

Docker Compose ist der schnellste Weg, Zabbix bereitzustellen.
Es liest eine Konfigurationsdatei (Compose-Datei) und übernimmt die gesamte Einrichtung - das Herunterladen von Docker-Images, das Erstellen eines internen Netzwerks zwischen Containern, das Einrichten des Speichers, das Initialisieren der Datenbank und das Starten aller Komponenten in der richtigen Reihenfolge.

Das Repository [offizielle Zabbix Dockerfiles](https://github.com/zabbix/zabbix-docker) stellt sofort verwendbare Docker-Compose-Dateien und ein auf `.env` basierendes Konfigurationssystem bereit, das verschiedene Betriebssysteme, Datenbank-Backends und die Konfiguration von Zabbix-Komponenten unterstützt.

1\. Klonen Sie das Repository, wechseln Sie in das Verzeichnis und schalten Sie auf Version 7.0 um:

```bash
git clone https://github.com/zabbix/zabbix-docker.git
cd zabbix-docker
git checkout 7.0
```

2\. (Optional) Passen Sie die Bereitstellung mit [Umgebungsvariablen](#environment-variables) an.
Dieser Schritt kann bei einer Standardinstallation übersprungen werden.

3\. Stellen Sie die Standardkonfiguration bereit - Zabbix Server, Weboberfläche (auf Nginx laufend) und ein Datenbank-Backend (MySQL oder PostgreSQL), wobei jede Komponente in einem eigenen Container unter Alpine Linux ausgeführt wird.

```bash
# Mit MySQL als Datenbank:
docker compose -f ./compose.yaml up -d

# Mit PostgreSQL als Datenbank:
docker compose -f ./compose_pgsql.yaml up -d
```

Nachdem die Container gestartet und betriebsbereit sind (in der Regel innerhalb von 1-3 Minuten), wird der Zabbix Server gestartet und die Weboberfläche ist unter `http://localhost` verfügbar.

::: noteclassic
Verwenden Sie `docker compose ps`, um den Status der Container zu prüfen.
Alle Container (außer dem Container `zabbix-docker-server-db-init-1`) sollten den Status `Up` haben.
Falls bei einem Container `Exited` angezeigt wird, prüfen Sie die Protokolle auf Fehler mit `docker logs -f <container-name>`.
:::

[comment]: # ({/a76784bc-c443c22e})

[comment]: # ({c9a11d44-0be3c140})
#### Umgebungsvariablen

Das Verhalten von Docker Compose und die Konfiguration von Zabbix-Komponenten können beide über Umgebungsvariablen angepasst werden.

**Variablen auf Compose-Ebene** (definiert in der [`.env`-Datei](https://github.com/zabbix/zabbix-docker/blob/7.0/.env)) steuern, welche Docker-Images, Ports und Netzwerk-IP-Bereiche verwendet werden.
Sie können diese Variablen direkt vor dem `docker compose`-Befehl inline verwenden oder die `.env`-Datei bearbeiten.

Beispielsweise stellt der folgende Befehl ein vollständiges Zabbix-Setup mit mehreren Containern bereit, das ein auf Ubuntu basierendes Image verwendet (anstelle des standardmäßigen Alpine Linux) und die Weboberfläche über Nginx auf benutzerdefinierten HTTP- (8282) und HTTPS- (8443) Ports bereitstellt:

```bash
OS=ubuntu \
ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \
docker compose -f ./compose.yaml up -d
```

**Variablen auf Komponentenebene** (definiert in den [`env_vars/.env_<component>`](https://github.com/zabbix/zabbix-docker/blob/7.0/env_vars/) Dateien) steuern die Konfiguration der Zabbix-Komponenten.
Bearbeiten Sie die jeweilige `.env_<component>`-Datei, bevor Sie den `docker compose`-Befehl ausführen.

Beispielsweise können Sie die Anzahl der passiven Poller des Zabbix-Servers und die Cache-Einstellungen anpassen sowie die Zeitzone der Weboberfläche konfigurieren, indem Sie die folgenden Variablen bearbeiten:

```ini
# env_vars/.env_srv
ZBX_STARTPOLLERS=20
ZBX_CACHESIZE=64M
ZBX_HISTORYCACHESIZE=32M

# env_vars/.env_web
PHP_TZ=Europe/Paris
```

::: noteclassic
Umgebungsvariablen auf Komponentenebene entsprechen Konfigurationsparametern der Zabbix-Komponenten, verwenden jedoch eine andere Namenskonvention (z. B. entspricht `ZBX_STARTPOLLERS` [`StartPollers`](/manual/appendix/config/zabbix_server#startpollers)).
Einige Variablen sind Docker-spezifisch, und einige Konfigurationsparameter können nicht geändert werden (z. B. `PIDFile` und `LogType`).
Wenn Sie Umgebungsvariablen verwenden, lesen Sie bitte den Abschnitt *Environment variables* in der Beschreibung des jeweiligen [Docker-Images](#available-docker-images) auf Docker Hub.
:::

[comment]: # ({/c9a11d44-0be3c140})

[comment]: # ({15680aeb-7d10f7dc})
#### Volumes

Docker Compose speichert persistente Daten im Verzeichnis `zbx_env/`, das zusammen mit der Compose-Datei erstellt wird.
Dieses Verzeichnis bewahrt die Daten der Komponenten über Container-Neustarts und Aktualisierungen hinweg.

Der Inhalt von `zbx_env/` ist für das Image jeder Komponente vordefiniert. Zum Beispiel:

-   `zbx_env/etc/` - wird vom [Zabbix web interface container](https://hub.docker.com/r/zabbix/zabbix-web-nginx-mysql#allowed-volumes-for-the-zabbix-web-interface-container) verwendet
-   `zbx_env/usr/` und `zbx_env/var/` - werden vom [Zabbix server container](https://hub.docker.com/r/zabbix/zabbix-server-mysql#allowed-volumes-for-the-zabbix-server-container) verwendet

Weitere Informationen zu den einzelnen Volumes finden Sie im Abschnitt *Allowed volumes* in der Beschreibung des [Docker-Images](#available-docker-images) jeder Komponente auf Docker Hub.

[comment]: # ({/15680aeb-7d10f7dc})

[comment]: # ({4287ef6f-fb9850d6})
#### Makefile

Das Zabbix Dockerfiles-Repository stellt außerdem eine [Makefile](https://github.com/zabbix/zabbix-docker/blob/7.0/Makefile) als Abkürzung für gängige Docker-Compose-Aufgaben bereit.
Anstelle des vollständigen Befehls `docker compose` können Sie kürzere `make`-Befehle verwenden (führen Sie `make help` aus, um die verfügbaren Optionen anzuzeigen):

```bash
# Standardbereitstellung (Zabbix Server, Weboberfläche, MySQL, alles auf Alpine Linux)
make up

# Benutzerdefinierte Bereitstellung (Zabbix Server, Weboberfläche mit benutzerdefinierten Nginx-Ports, PostgreSQL, alles auf Ubuntu)
make up \
  OS=ubuntu \
  DB=pgsql \
  ZABBIX_WEB_NGINX_HTTP_PORT=8282 \
  ZABBIX_WEB_NGINX_HTTPS_PORT=8443
```

::: noteimportant
Beim Stoppen oder Entfernen von Containern geben Sie immer denselben Datenbanktyp an, der bereitgestellt wurde (z. B. `make down DB=pgsql`).
:::

Standardmäßig startet `make up` nur einen minimalen Satz von Diensten (Zabbix Server, Weboberfläche und Datenbank).
Dadurch bleibt die Einrichtung schlank und es werden keine Komponenten gestartet, die möglicherweise nicht benötigt werden.
Um zusätzliche Komponenten einzubeziehen, können Sie die folgenden [Compose-Profile](https://docs.docker.com/compose/how-tos/profiles/) verwenden:

```bash
# Standardbereitstellung + Zabbix Agent, Java gateway, Webdienst und SNMP-Traps:
make up COMPOSE_PROFILES=full

# COMPOSE_PROFILES=full + Zabbix Proxy (MySQL und SQLite3):
make up COMPOSE_PROFILES=all
```

[comment]: # ({/4287ef6f-fb9850d6})

[comment]: # ({ec9e0e44-0b4b68c7})
### Docker (manuelle Bereitstellung)

Verwenden Sie die manuelle Bereitstellung, wenn Sie Zabbix Schritt für Schritt bereitstellen, einzelne Komponenten ausführen, sie in eine vorhandene Umgebung integrieren oder eine alternative Container-Runtime wie Podman verwenden möchten.

Um beispielsweise einen Zabbix Proxy bereitzustellen, führen Sie den folgenden Befehl aus:

```bash
docker run --name zabbix-proxy-sqlite3 \
  -e ZBX_SERVER_HOST=192.0.2.1 \
  -e ZBX_PROXYMODE=0 \
  -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \
  -v zabbix-proxy-data:/var/lib/zabbix/db_data \
  --init \
  -d \
  zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest
```

:::noteimportant
Zabbix (7.0.0-7.0.2) darf in Containern nicht als `PID1`/`init`-Prozess ausgeführt werden.
:::

Dieser Befehl:

-   Lädt das [Docker-Image](#available-docker-images) `zabbix/zabbix-proxy-sqlite3:alpine-7.0-latest` herunter.

-   Erstellt und startet einen `zabbix-proxy-sqlite3`-Container auf Basis des Docker-Images (mit den Flags [`--init`](https://docs.docker.com/reference/cli/docker/container/run/#init) und [`-d`](https://docs.docker.com/reference/cli/docker/container/run/#detach)).

-   Konfiguriert den Zabbix Proxy-Parameter [`Server`](/manual/appendix/config/zabbix_proxy#server) über die Umgebungsvariable `ZBX_SERVER_HOST`.
    Dieser Parameter gibt die IP-Adresse des Zabbix Servers an, von dem der Proxy Konfigurationsdaten abruft und an den er gesammelte Daten sendet.
    Beachten Sie, dass andere für den aktiven Proxy-Betrieb erforderliche Variablen Standardwerte verwenden und weggelassen werden können.

::: noteclassic
Umgebungsvariablen entsprechen Zabbix-Komponenten-Konfigurationsparametern mit einer anderen Namenskonvention (z. B. entspricht `ZBX_SERVER_HOST` [`Server`](/manual/appendix/config/zabbix_proxy#server)).
Einige Variablen sind Docker-spezifisch, und einige Konfigurationsparameter können nicht geändert werden (z. B. `PIDFile` und `LogType`).
Wenn Sie Umgebungsvariablen verwenden, lesen Sie bitte den Abschnitt *Environment variables* in der Beschreibung des jeweiligen [Docker-Images](#available-docker-images) auf Docker Hub.
:::

-   Bindet einen von Docker verwalteten Speicherort (z. B. `/var/lib/docker/volumes/zabbix-proxy-data/`) an das Verzeichnis `/var/lib/zabbix` des Containers, damit die Daten des Zabbix Proxy dauerhaft gespeichert werden, auch wenn der Container entfernt wird.

::: noteclassic
Weitere Informationen zu den einzelnen Volumes finden Sie im Abschnitt *Allowed volumes* in der Beschreibung des jeweiligen [Docker-Images](#available-docker-images) auf Docker Hub.
:::

Nachdem Sie den Zabbix Proxy-Container bereitgestellt haben, können Sie in Ihrer Zabbix Frontend mit dem [Hinzufügen des Proxys](/manual/distributed_monitoring/proxies#configuration) fortfahren und [Hosts konfigurieren](/manual/config/hosts/host#configuration), die von diesem Proxy überwacht werden sollen.

Die folgenden Beispiele decken drei weitere Bereitstellungsszenarien ab:

-   Zabbix Server (MySQL) mit Java gateway
-   Zabbix Server (PostgreSQL) mit SNMP-Traps
-   Zabbix Server (MySQL) mit Java gateway auf RHEL 8–10

Weitere Beispiele finden Sie in der Beschreibung des jeweiligen [Docker-Images](#available-docker-images) auf Docker Hub.

[comment]: # ({/ec9e0e44-0b4b68c7})

[comment]: # ({a807fe94-492bd3ba})
#### Zabbix-Server (MySQL) mit Java gateway bereitstellen

Dieses Beispiel zeigt, wie ein Zabbix-Server mit einem MySQL-Backend, einem Java gateway für [JMX-Monitoring](/manual/config/items/itemtypes/jmx_monitoring) und einer webbasierten Oberfläche auf Nginx-Basis bereitgestellt wird.

1\. Erstellen Sie ein dediziertes Docker-Netzwerk, damit alle Zabbix-Komponenten-Container sich über ihren Containernamen gegenseitig erreichen können:

```bash
docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net
```

2\. Starten Sie einen leeren MySQL-Server-Container (ersetzen Sie `zabbix_pwd` und `root_pwd` durch starke Passwörter und verwenden Sie diese Werte in den folgenden Schritten):

```bash
docker run --name mysql-server -t \
  -e MYSQL_DATABASE="zabbix" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_pwd" \
  -e MYSQL_ROOT_PASSWORD="root_pwd" \
  --network=zabbix-net \
  --restart unless-stopped \
  -d mysql:8.0-oracle \
  --character-set-server=utf8mb4 --collation-server=utf8mb4_bin
```

3\. Verfolgen Sie die MySQL-Logs und warten Sie, bis MySQL Verbindungen annimmt (mit `Ctrl+C` beenden Sie die Log-Ausgabe):

```bash
docker logs -f mysql-server

# ... [Server] /usr/sbin/mysqld: ready for connections. ...
```

4\. Starten Sie einen Zabbix Java gateway-Container:

```bash
docker run --name zabbix-java-gateway -t \
  --network=zabbix-net \
  --restart unless-stopped \
  -d zabbix/zabbix-java-gateway:alpine-7.0-latest
```

5\. Aktivieren Sie `log_bin_trust_function_creators` im MySQL-Server-Container.
Dadurch werden die Sicherheitsbeschränkungen für gespeicherte Funktionen vorübergehend gelockert; die Einstellung wird in späteren Schritten wieder deaktiviert.
So kann der Zabbix-Datenbankbenutzer gespeicherte Funktionen ohne die Berechtigung `SUPER` erstellen, die MySQL bei aktiviertem [Binary Logging](https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html) benötigt (standardmäßig seit MySQL 8.0).
Führen Sie den folgenden Befehl aus:

```bash
docker exec -it mysql-server mysql -u root -p'root_pwd' \
  -e "SET GLOBAL log_bin_trust_function_creators = 1;"
```

6\. Starten Sie einen Zabbix-Server-Container und verbinden Sie ihn mit den Containern des Java gateway und des MySQL-Servers:

```bash
docker run --name zabbix-server-mysql -t \
  -e DB_SERVER_HOST="mysql-server" \
  -e MYSQL_DATABASE="zabbix" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_pwd" \
  -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \
  --network=zabbix-net \
  -p 10051:10051 \
  --restart unless-stopped \
  --init \
  -d zabbix/zabbix-server-mysql:alpine-7.0-latest
```

7\. Verfolgen Sie die Zabbix-Server-Logs und warten Sie, bis der Zabbix-Server das Initialisieren des Datenbankschemas abgeschlossen hat (mit `Ctrl+C` beenden Sie die Log-Ausgabe):

```bash
docker logs -f zabbix-server-mysql

# ... [info]: ** Creating 'zabbix' schema in MySQL
# ... [info]: ** Database schema successfully created!
```

8\. Deaktivieren Sie `log_bin_trust_function_creators` im MySQL-Server-Container.
Dadurch wird die Sicherheitsbeschränkung wieder aktiviert, die Nicht-`SUPER`-Benutzer daran hindert, gespeicherte Funktionen zu erstellen.
Führen Sie den folgenden Befehl aus:

```bash
docker exec -it mysql-server mysql -u root -p'root_pwd' \
  -e "SET GLOBAL log_bin_trust_function_creators = 0;"
```

9\. Starten Sie einen Container für die Zabbix-Weboberfläche und verbinden Sie ihn mit den Containern des Zabbix-Servers und des MySQL-Servers:

```bash
docker run --name zabbix-web-nginx-mysql -t \
  -e ZBX_SERVER_HOST="zabbix-server-mysql" \
  -e DB_SERVER_HOST="mysql-server" \
  -e MYSQL_DATABASE="zabbix" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_pwd" \
  -e PHP_TZ="Europe/Riga" \
  --network=zabbix-net \
  -p 80:8080 \
  --restart unless-stopped \
  -d zabbix/zabbix-web-nginx-mysql:alpine-7.0-latest
```

Nachdem die Container gestartet wurden, wird der Zabbix-Server ausgeführt und die Weboberfläche ist unter `http://localhost` verfügbar.

::: noteclassic
Verwenden Sie `docker ps`, um den Status der Container zu prüfen.
Alle Container sollten den Status `Up` haben.
Falls einer `Exited` anzeigt, prüfen Sie die Logs auf Fehler mit `docker logs -f <container-name>`.
:::

#### Zabbix-Server (PostgreSQL) mit SNMP-Traps bereitstellen

Dieses Beispiel zeigt, wie ein Zabbix-Server mit einem PostgreSQL-Backend, [SNMP-Traps](/manual/config/items/itemtypes/snmptrap) und einer webbasierten Oberfläche auf Nginx-Basis bereitgestellt wird.

1\. Erstellen Sie ein dediziertes Docker-Netzwerk, damit alle Zabbix-Komponenten-Container sich über ihren Containernamen gegenseitig erreichen können:

```bash
docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net
```

2\. Starten Sie einen leeren PostgreSQL-Server-Container (ersetzen Sie `zabbix_pwd` durch ein starkes Passwort und verwenden Sie diesen Wert in den folgenden Schritten):

```bash
docker run --name postgres-server -t \
  -e POSTGRES_USER="zabbix" \
  -e POSTGRES_PASSWORD="zabbix_pwd" \
  -e POSTGRES_DB="zabbix" \
  --network=zabbix-net \
  --restart unless-stopped \
  -d postgres:latest
```

3\. Starten Sie einen Zabbix-SNMP-Traps-Container:

```bash
docker run --name zabbix-snmptraps -t \
  -v /zbx_instance/snmptraps:/var/lib/zabbix/snmptraps:rw \
  -v /var/lib/zabbix/mibs:/usr/share/snmp/mibs:ro \
  --network=zabbix-net \
  -p 162:1162/udp \
  --restart unless-stopped \
  -d zabbix/zabbix-snmptraps:alpine-7.0-latest
```

4\. Starten Sie einen Zabbix-Server-Container und verbinden Sie ihn mit den Containern des PostgreSQL-Servers und der SNMP-Traps:

```bash
docker run --name zabbix-server-pgsql -t \
  -e DB_SERVER_HOST="postgres-server" \
  -e POSTGRES_USER="zabbix" \
  -e POSTGRES_PASSWORD="zabbix_pwd" \
  -e POSTGRES_DB="zabbix" \
  -e ZBX_ENABLE_SNMP_TRAPS="true" \
  --network=zabbix-net \
  -p 10051:10051 \
  --volumes-from zabbix-snmptraps \
  --restart unless-stopped \
  --init \
  -d zabbix/zabbix-server-pgsql:alpine-7.0-latest
```

5\. Verfolgen Sie die Zabbix-Server-Logs und warten Sie, bis der Zabbix-Server das Initialisieren des Datenbankschemas abgeschlossen hat (mit `Ctrl+C` beenden Sie die Log-Ausgabe):

```bash
docker logs -f zabbix-server-pgsql

# ... [info]: ** Creating 'zabbix' schema in PostgreSQL
# ... [info]: ** Database schema successfully created!
```

6\. Starten Sie einen Container für die Zabbix-Weboberfläche und verbinden Sie ihn mit den Containern des Zabbix-Servers und des PostgreSQL-Servers:

```bash
docker run --name zabbix-web-nginx-pgsql -t \
  -e ZBX_SERVER_HOST="zabbix-server-pgsql" \
  -e DB_SERVER_HOST="postgres-server" \
  -e POSTGRES_DB="zabbix" \
  -e POSTGRES_USER="zabbix" \
  -e POSTGRES_PASSWORD="zabbix_pwd" \
  -e PHP_TZ="Europe/Riga" \
  --network=zabbix-net \
  -p 443:8443 \
  -p 80:8080 \
  -v /etc/ssl/nginx:/etc/ssl/nginx:ro \
  --restart unless-stopped \
  -d zabbix/zabbix-web-nginx-pgsql:alpine-7.0-latest
```

Nachdem die Container gestartet wurden, wird der Zabbix-Server ausgeführt und die Weboberfläche ist unter `http://localhost` verfügbar.

::: noteclassic
Verwenden Sie `docker ps`, um den Status der Container zu prüfen.
Alle Container sollten den Status `Up` haben.
Falls einer `Exited` anzeigt, prüfen Sie die Logs auf Fehler mit `docker logs -f <container-name>`.
:::

#### Zabbix-Server (MySQL) mit Java gateway auf RHEL 8–10 bereitstellen

Dieses Beispiel zeigt, wie ein Zabbix-Server mit einem MySQL-Backend, einem Java gateway für [JMX-Monitoring](/manual/config/items/itemtypes/jmx_monitoring) und einer webbasierten Oberfläche auf Nginx-Basis bereitgestellt wird, die alle auf Red Hat Enterprise Linux 8, 9 oder 10 ausgeführt werden.

Unter Red Hat Enterprise Linux wird als Container-Runtime Podman anstelle von Docker empfohlen.
Podman funktioniert ähnlich wie Docker, benötigt jedoch keinen im Hintergrund laufenden Dienst mit Root-Rechten, was besser zu Red-Hat-Umgebungen passt.

1\. Erstellen Sie einen neuen Pod mit dem Namen `zabbix` und freigegebenen Ports für die Zabbix-Weboberfläche und den Zabbix-Server-Trapper:

```bash
podman pod create --name zabbix -p 80:8080 -p 10051:10051
```

2\. (Optional) Starten Sie einen Zabbix-Agent-Container im Pod `zabbix`:

```bash
podman run --name zabbix-agent \
  -e ZBX_SERVER_HOST="127.0.0.1,localhost" \
  --restart=always \
  --pod=zabbix \
  -d registry.connect.redhat.com/zabbix/zabbix-agent-70:latest
```

3\. Erstellen Sie auf dem RHEL-Host ein Verzeichnis `./mysql/`:

```bash
mkdir -p ./mysql
```

4\. Starten Sie einen leeren MySQL-Server-Container (ersetzen Sie `zabbix_pwd` und `root_pwd` durch starke Passwörter und verwenden Sie diese Werte in den folgenden Schritten):

```bash
podman run --name mysql-server -t \
  -e MYSQL_DATABASE="zabbix" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_pwd" \
  -e MYSQL_ROOT_PASSWORD="root_pwd" \
  -v ./mysql/:/var/lib/mysql/:Z \
  --restart=always \
  --pod=zabbix \
  -d mysql:8.0 \
  --character-set-server=utf8mb4 --collation-server=utf8mb4_bin
```

5\. Verfolgen Sie die MySQL-Logs und warten Sie, bis MySQL Verbindungen annimmt (mit `Ctrl+C` beenden Sie die Log-Ausgabe):

```bash
podman logs -f mysql-server

# ... [Server] /usr/sbin/mysqld: ready for connections. ...
```

6\. Starten Sie einen Zabbix Java gateway-Container:

```bash
podman run --name zabbix-java-gateway -t \
  --restart=always \
  --pod=zabbix \
  -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-70
```

7\. Aktivieren Sie `log_bin_trust_function_creators` im MySQL-Server-Container.
Dadurch werden die Sicherheitsbeschränkungen für gespeicherte Funktionen vorübergehend gelockert; die Einstellung wird in späteren Schritten wieder deaktiviert.
So kann der Zabbix-Datenbankbenutzer gespeicherte Funktionen ohne die Berechtigung `SUPER` erstellen, die MySQL bei aktiviertem [Binary Logging](https://dev.mysql.com/doc/refman/8.0/en/stored-programs-logging.html) benötigt (standardmäßig seit MySQL 8.0).
Führen Sie den folgenden Befehl aus:

```bash
podman exec -it mysql-server mysql -u root -p'root_pwd' \
  -e "SET GLOBAL log_bin_trust_function_creators = 1;"
```

8\. Starten Sie einen Zabbix-Server-Container und verbinden Sie ihn mit den Containern des Java gateway und des MySQL-Servers:

```bash
podman run --name zabbix-server-mysql -t \
  -e DB_SERVER_HOST="127.0.0.1" \
  -e MYSQL_DATABASE="zabbix" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_pwd" \
  -e ZBX_JAVAGATEWAY="127.0.0.1" \
  --restart=always \
  --init \
  --pod=zabbix \
  -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-70
```

9\. Verfolgen Sie die Zabbix-Server-Logs und warten Sie, bis der Zabbix-Server das Initialisieren des Datenbankschemas abgeschlossen hat (mit `Ctrl+C` beenden Sie die Log-Ausgabe):

```bash
podman logs -f zabbix-server-mysql

# ... [info]: ** Creating 'zabbix' schema in MySQL
# ... [info]: ** Database schema successfully created!
```

10\. Deaktivieren Sie `log_bin_trust_function_creators` im MySQL-Server-Container.
Dadurch wird die Sicherheitsbeschränkung wieder aktiviert, die Nicht-`SUPER`-Benutzer daran hindert, gespeicherte Funktionen zu erstellen.
Führen Sie den folgenden Befehl aus:

```bash
podman exec -it mysql-server mysql -u root -p'root_pwd' \
  -e "SET GLOBAL log_bin_trust_function_creators = 0;"
```

11\. Starten Sie einen Container für die Zabbix-Weboberfläche und verbinden Sie ihn mit den Containern des Zabbix-Servers und des MySQL-Servers:

```bash
podman run --name zabbix-web-mysql -t \
  -e ZBX_SERVER_HOST="127.0.0.1" \
  -e DB_SERVER_HOST="127.0.0.1" \
  -e MYSQL_DATABASE="zabbix" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_pwd" \
  -e PHP_TZ="Europe/Riga" \
  --restart=always \
  --pod=zabbix \
  -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-70
```

::: noteclassic
Der Pod `zabbix` stellt den Port `80/TCP` (HTTP) des Containers `zabbix-web-mysql` auf dem Host über `8080/TCP` bereit.
:::

Nachdem die Container gestartet wurden, wird der Zabbix-Server ausgeführt und die Weboberfläche ist unter `http://localhost` verfügbar.

::: noteclassic
Verwenden Sie `docker ps`, um den Status der Container zu prüfen.
Alle Container sollten den Status `Up` haben.
Falls einer `Exited` anzeigt, prüfen Sie die Logs auf Fehler mit `docker logs -f <container-name>`.
:::

[comment]: # ({/a807fe94-492bd3ba})
