3 从源代码安装

您可以通过从源代码编译来获取最新版本的 Zabbix。

这里提供了一个逐步教程，介绍如何从源代码安装 Zabbix。

安装 Zabbix 守护进程

1 下载源代码归档

前往 Zabbix 下载页面 并下载源代码归档。下载完成后，运行以下命令解压源代码：

tar -zxvf zabbix-7.4.0.tar.gz

2 创建用户账户

所有 Zabbix 守护进程都以非特权系统用户身份运行。
如果 Zabbix 守护进程是从非特权用户账户启动的，它将继续以该用户身份运行。

在默认配置中，如果守护进程以 root 身份启动，它会切换到 zabbix 用户账户，该账户必须已存在。
要创建 zabbix 系统用户和组，请运行下面列出的命令。

基于 RedHat 的系统：

groupadd --system zabbix
useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix

基于 Debian 的系统：

addgroup --system --quiet zabbix
adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix

无需为 Zabbix 前端创建单独的用户账户。

安全建议

如果 Zabbix 服务器 和 agent 运行在同一台机器上，建议它们使用不同的用户账户运行。
如果两者使用同一个用户运行，agent 就可以访问服务器的配置文件，这可能会向 Zabbix 中任何管理员级别用户暴露敏感信息，例如数据库密码。

主目录（可选）

Zabbix 进程不需要主目录，因此通常不建议创建。
不过，如果您需要依赖主目录的功能（例如，将 MySQL 凭据存储在 $HOME/.my.cnf 中），可以使用下面列出的命令创建它。

在基于 RedHat 的系统上，运行：

mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix
chown zabbix:zabbix /usr/lib/zabbix

在基于 Debian 的系统上，运行：

mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix
chown zabbix:zabbix /var/lib/zabbix

3 创建Zabbix数据库

对Zabbixserver和proxy守护进程，还有Zabbix前端，必须要有一个数据库。但运行Zabbixagent不需要。

此处SQL脚本用于创建数据库模式和插入数据集。Zabbix proxy数据库只需要数据库模式，而Zabbix server数据库在数据库模式之上还需要数据集。

创建了Zabbix数据库之后，执行以下步骤来编译Zabbix。

4 配置源代码

构建 Zabbix 服务器、Zabbix proxy 或 Zabbix agent 需要使用带有 GNU 扩展的 C99。 可以通过设置 CFLAGS="-std=gnu99" 显式指定此版本：

export CFLAGS="-std=gnu99"

在为 Zabbix 服务器或 proxy 配置源代码时，必须指定要使用的数据库类型。每次只能将一种数据库类型编译到服务器或 proxy 进程中。

要查看所有受支持的配置选项，请在解压后的 Zabbix 源代码目录中运行：

./configure --help

要为 Zabbix 服务器和 agent 配置源代码，可以运行如下命令：

./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi --with-ares

要为 Zabbix 服务器（使用 PostgreSQL 等）配置源代码，可以运行：

./configure --enable-server --with-postgresql --with-net-snmp

要为 Zabbix proxy（使用 SQLite 等）配置源代码，可以运行：

./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2

要为 Zabbix agent 配置源代码，可以运行：

./configure --enable-agent

或者，对于 Zabbix agent 2：

./configure --enable-agent2

编译选项说明：

• --enable-agent - 编译 Zabbix agent，以及 Zabbix get 和 Zabbix sender 命令行工具。
• --with-libcurl - 虚拟机监控、SMTP 身份验证以及 web.page.* Zabbix agent 监控项所必需。另请参见：要求（libcurl）。
• --with-libxml2 - 虚拟机监控所必需。
• --with-libpcre2[=DIR] - Zabbix 始终使用 PCRE2 库进行编译；此选项仅用于指定自定义的 PCRE2 安装路径。
• --with-mysql=/path/to/mysql_config - 指定特定 MySQL 客户端库配置文件的路径。当安装了多个版本的 MySQL 或 MariaDB 时很有用。
• --enable-static - 静态链接库（Solaris 上不支持）。如果您计划将编译后的二进制文件分发到没有所需库的系统上，请使用此选项。不建议在构建 Zabbix 服务器时使用。若要静态构建服务器，则需要每个外部库都提供静态版本。configure 脚本不会自动检查这一点。
• --with-stacksize=<value> - 设置每个线程的栈大小，单位为 KB（例如，--with-stacksize=512）。如果由于栈溢出导致 Zabbix 崩溃或冻结，您可以增大此值（例如，在默认线程栈限制较低的系统上进行预处理时）。

checking for main in -lmysqlclient... no
configure: error: Not found mysqlclient library

/usr/bin/ld: cannot find -lssl
/usr/bin/ld: cannot find -lcrypto

另请参见：

• 编译启用加密支持的 Zabbix
• 已知的编译问题

5 制作并安装所有内容

make install

此步骤应由权限足够的用户执行（通常为 'root'，或使用 sudo）。

默认情况下，运行 make install 会将守护进程二进制文件 (zabbix_server, zabbix_agentd, zabbix_proxy) 安装到 /usr/local/sbin，并将 客户端二进制文件 (zabbix_get, zabbix_sender) 安装到 /usr/local/bin。

6 查看并编辑配置文件

• 编辑 Zabbix agent 配置文件 /usr/local/etc/zabbix_agentd.conf

你需要为每个安装了 zabbix_agentd 的主机配置此文件。

你必须在文件中指定 Zabbix 服务器的 IP 地址。 来自其他主机的连接将被拒绝。

• 编辑 Zabbix 服务器配置文件 /usr/local/etc/zabbix_server.conf

你必须指定数据库名称、用户和密码（如果使用的话）。

如果你的安装规模较小（最多十台受监控主机），其余参数使用默认值即可。不过，如果你想最大化 Zabbix 服务器（或 proxy）的性能，仍应修改默认参数。

• 如果你安装了 Zabbix proxy，请编辑 proxy 配置文件 /usr/local/etc/zabbix_proxy.conf

你必须指定服务器 IP 地址和 proxy 主机名（服务器必须已知该主机名），以及数据库名称、用户和密码（如果使用的话）。

7 启动守护进程

在服务器端运行 zabbix_server。

zabbix_server

在所有受监控的机器上运行 zabbix_agentd。

zabbix_agentd

如果您已安装 Zabbix proxy，请运行 zabbix_proxy。

zabbix_proxy

安装 Zabbix 前端

复制 PHP 文件

Zabbix 前端是用 PHP 编写的，因此运行它需要一个支持 PHP 的 web 服务器。 安装只需将 ui 目录中的 PHP 文件复制到 web 服务器的 HTML 文档目录中即可。

Apache web 服务器的 HTML 文档目录常见位置包括：

• /usr/local/apache2/htdocs（从源代码安装 Apache 时的默认目录）
• /srv/www/htdocs（OpenSUSE、SLES）
• /var/www/html（Debian、Ubuntu、Fedora、RHEL）

建议使用子目录，而不是 HTML 根目录。 要创建子目录并将 Zabbix 前端文件复制到其中，请执行以下命令，并将 <htdocs> 替换为实际目录：

mkdir <htdocs>/zabbix
cd ui
cp -a . <htdocs>/zabbix

如果计划使用英语以外的其他语言，请参阅安装其他前端语言了解说明。

安装前端

有关 Zabbix 前端安装向导的信息，请参见 Web interface installation 页面。

安装 Zabbix agent 2 可加载插件

只有在您希望监控内置插件未覆盖的目标时，才需要安装 Zabbix agent 2 可加载插件（例如 MongoDB 服务器或集群、PostgreSQL 及其分支等）。 请参阅 可加载插件 和 内置插件 的完整列表。

要从源代码安装，请先 下载 并解压可加载插件源代码归档文件。

要编译插件，请进入解压后的插件目录并运行 make：

make

只要 Zabbix agent 2 能够加载，插件可执行文件可以放在任意位置。 请在插件配置文件中指定插件二进制文件的路径，例如 PostgreSQL 插件的 postgresql.conf 中：

Plugins.PostgreSQL.System.Path=/path/to/executable/zabbix-agent2-plugin-postgresql

插件配置文件的路径必须在 Zabbix agent 2 配置文件的 Include 参数中指定：

Include=/path/to/plugin/configuration/file/postgresql.conf

有关配置插件的更多详细信息，请继续查看 设置。

Zabbix 提供的可加载插件使用简单的 makefile，并包含以下构建目标：

• make - 构建插件
• make clean - 删除构建插件时创建的所有文件
• make check - 运行自检（需要真实的监控目标，例如 PostgreSQL 数据库）
• make style - 使用 golangci-lint 检查 Go 代码风格
• make format - 使用 go fmt 格式化 Go 代码
• make dist - 创建包含所有依赖项的源代码归档文件

安装 Java 网关

只有在需要监控 JMX 应用程序时，才需要安装 Java 网关。Java 网关是轻量级的，不需要数据库。

要从源代码安装，首先下载并解压源代码归档文件。

要编译 Java 网关，请使用 --enable-java 选项运行 ./configure 脚本。建议您指定 --prefix 选项，以请求使用默认 /usr/local 之外的安装路径，因为安装 Java 网关会创建完整的目录树，而不仅仅是一个可执行文件。

./configure --enable-java --prefix=$PREFIX

要将 Java 网关编译并打包为 JAR 文件，请运行 make。请注意，执行此步骤时，您的路径中需要有 javac 和 jar 可执行文件。

make

现在，您会在 src/zabbix\_java/bin 中得到一个 zabbix-java-gateway-$VERSION.jar 文件。如果您可以接受直接从发行目录中的 src/zabbix\_java 运行 Java 网关，那么可以继续阅读配置和运行 Java 网关的说明。否则，请确保您有足够的权限并运行 make install。

make install

有关配置和运行 Java 网关的更多详细信息，请继续查看设置。

安装 Zabbix web service

只有在您希望使用 计划报告时，才需要安装 Zabbix web service。

要从源代码安装，请先 下载并 解压源代码归档文件。

要编译 Zabbix web service，请运行带有 --enable-webservice 选项的 ./configure 脚本。

在安装了 web service 的机器上运行 zabbix_web_service：

zabbix_web_service

请继续查看设置，以了解有关配置计划报告生成的更多详细信息。