通过源码安装Zabbix进行监控 编译安装篇

发表于 分类于 Disqus： 本文字数： 4.3k 阅读时长 ≈ 16 分钟

我发现现在服务器好多啊，之前成功申请到了Oracle的服务器（Oracle真豪气，4核24G的服务器想给就给），所以那么多服务器我觉得有必要监控起来，nagios在公司用过了，所以这次我就是用Zabbix来把我那么多服务器监控起来，这一篇，描述如何完整从源码安装zabbix，下一篇描述如何监控其他服务器并在通信中进行加密。

唉，一年一度的520，帅哥和美女都是成群结队的，单身狗只能独自写写文档加深记忆，习惯了。。。

(English version translate by GPT-3.5)

安装环境

Zabbix server我会安装在自己的阿里云上，自从上个月买了腾讯云服务器后，阿里云就沦落为我家内网穿透专用机了，这篇文章将记录我编译zabbix，到安装zabbix到Oracle机器并完成监控到全过程，本文先做 - 安装完成部分。

1
2
3
4
5
6
服务器：Aliyun(China) 1 core 1G 2M bandwidth
系统：Ubuntu 20.04
Kernel: 5.4.0-110-generic
数据库：Aliyun RDS （自己准备一个MySQL数据库，我用的是MySQL 8.0）
Docker：apt安装最新版本
下面文本中，数据库名称 rt_zabbix,myzabbix,zabbix视为同一个数据库，因为这篇文章我不是一口气写完的，为了最大程度安全，因此所有表单信息，数据库信息均经过修改，公网环境我也不会使用root/root这么简单的密码。

下载源码

第一步当然是下载源码，不使用最新版我难受 zabbix-6.0.4.tar.gz - zabbix.com，在服务器上先下过来

1
wget -c https://cdn.zabbix.com/zabbix/sources/stable/6.0/zabbix-6.0.4.tar.gz

控制台内容

1
2
3
4
5
--2022-05-19 19:39:06--  https://cdn.zabbix.com/zabbix/sources/stable/6.0/zabbix-6.0.4.tar.gz
......
zabbix-6.0.4.tar.gz 100%[===================>]  31.86M  11.6MB/s    in 2.8s    

2022-05-19 19:39:10 (11.6 MB/s) - ‘zabbix-6.0.4.tar.gz’ saved [33412454/33412454

然后解压一下

1
2
tar -zxvf zabbix-6.0.4.tar.gz 
cd zabbix-6.0.4

编译源码 Configure

按照 官方文档 - 17.加密 - zabbix.com 的指引，要使用OpenSSL配置服务器和agent代理的源，可以使用以下内容，我需要在编译时加上如下的参数

1
./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl

那我就运行它吧，我喜欢在后面加上 –prefix，这样安装的内容就是在一个目录下，下次看到不爽删起来也快得多。

1
./configure --prefix=/usr/local/zabbix --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl

等待一会后，提示

1
2
3
4
5
6
7
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /usr/bin/mkdir -p
checking for gawk... no
...
checking for mariadb_config... no
configure: error: MySQL library not found

好像是mysql的库没有，那么就装一个

1
apt install -y libmysqlclient-dev

再运行上面的configure，又提示了

1
2
3
4
5
6
......
checking for multirow insert statements... yes
checking for pkg-config... no
checking for pkg-config... no
configure: error: LIBXML2 library not found
configure: error: LIBXML2 library not found

那就….

1
apt install -y libxml2-dev

再运行….还是不存在？我查了下，看到了这一条 Compiling Zabbix 5.2 with libxml2 support，里面第一个回答是要安装一个pkg-config，正好提示libxml2上面的是checking for pkg-config... no，那就装一个

1
apt install -y pkg-config

果然错误变了，变成了

1
2
3
4
5
6
......
checking pkg-config is at least version 0.9.0... yes
checking for xmlReadMemory in -lxml2... yes
checking for net-snmp-config... no
configure: error: Invalid Net-SNMP directory - unable to find net-snmp-config
root@iZbp12wn36q08um7s5aap5Z:~/download/zabbix-6.0.4# apt search Net-SNMP

再来。

1
apt install -y libsnmp-dev

提示…

1
2
3
.....
checking for libevent support... no
configure: error: Unable to use libevent (libevent check failed)

安装…

1
apt install -y libevent-dev

提示…

1
2
3
4
.....
checking for gawk... (cached) mawk
checking for curl-config... no
configure: error: Curl library not found

安装…

1
apt install -y libcurl4-openssl-dev

看到如下信息时，即表示预编译环境配置完成

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
Configuration:

  Detected OS:           linux-gnu
  Install path:          /usr/local/zabbix
  Compilation arch:      linux

  Compiler:              cc
  Compiler flags:         -g -O2  

  Library-specific flags:
    database:              -I/usr/include/mysql    
    libXML2:               -I/usr/include/libxml2
    Net-SNMP:               -I/usr/local/include -I/usr/lib/x86_64-linux-gnu/perl/5.30/CORE -I. -I/usr/include
    TLS:                   -I/usr/include

  Enable server:         yes
  Server details:
    With database:         MySQL
    WEB Monitoring:        cURL
      SSL certificates:      /usr/local/zabbix/share/zabbix/ssl/certs
      SSL keys:              /usr/local/zabbix/share/zabbix/ssl/keys
    SNMP:                  yes
    IPMI:                  no
    SSH:                   no
    TLS:                   OpenSSL
    ODBC:                  no
    Linker flags:           -L/usr/lib/x86_64-linux-gnu   -L/usr/lib/x86_64-linux-gnu           -L/usr/lib   -rdynamic     
    Libraries:              -lmysqlclient  -lpthread -ldl -lz -lssl -lcrypto -lresolv -lm -lrt      -lnetsnmp    -lz -lpthread -levent -lssl -lcrypto   -lcurl -lm -ldl  -lresolv -lxml2   -lpcre 
    Configuration file:    /usr/local/zabbix/etc/zabbix_server.conf
    External scripts:      /usr/local/zabbix/share/zabbix/externalscripts
    Alert scripts:         /usr/local/zabbix/share/zabbix/alertscripts
    Modules:               /usr/local/zabbix/lib/modules

  Enable proxy:          no

  Enable agent:          yes
  Agent details:
    TLS:                   OpenSSL
    Modbus:                no
    Linker flags:             -L/usr/lib   -rdynamic     
    Libraries:              -lz -lpthread -lssl -lcrypto   -lcurl -lm -ldl  -lresolv -lxml2   -lpcre 
    Configuration file:    /usr/local/zabbix/etc/zabbix_agentd.conf
    Modules:               /usr/local/zabbix/lib/modules

  Enable agent 2:        no

  Enable web service:    no

  Enable Java gateway:   no

  LDAP support:          no
  IPv6 support:          yes

***********************************************************
*            Now run 'make install'                       *
*                                                         *
*            Thank you for using Zabbix!                  *
*              <http://www.zabbix.com>                    *
***********************************************************

执行编译并安装 make

编译时间，大约 2分34秒

1
make -j1

-jN这个N表示使用多少核编译，如果单纯-j表示使用所有核心，如果内存比较小就可能导致OOM中途失败。这一步会比较慢，泡杯咖啡，慢慢来。

导入数据库

根据官方文档 - 1 创建数据库 - zabbix.com的指引，zabbix mysql必须运行init脚本

建立数据库

可以先看看上面的官方文档 - 1 创建数据库 - zabbix.com，然后下面进行数据库的建立和导入

阿里云RDS走这一步

我zabbix会使用aliyun RDS mysql数据库，所以我的走这一步，注意支持字符集选择utf8mb4，或utf8
新建utf8mb4的数据库
然后左侧对这个新建对数据库进行授权，假设这里数据库使用的名字是 **rt_zabbix**，虽然后面改成了myzabbix
账号授权
接着，使用工具连接过去(我使用navicat连接rds)，可以看到zabbix已经在这个账号上了。这里要进行修改，因为rds创建的数据库默认会使用utf8_general_ci的排序规则，这里必须改成utf8_bin，原因是官方文档有这么一句话

1
Zabbix Server/Proxy 完美适配 MySQL 数据库的重要前提是 MySQL 数据库的字符集必须使用 utf8（又名 utf8mb3）或 utf8mb4（分别使用 utf8_bin 和 utf8mb4_bin 排序规则）。建议全新安装时使用 utf8mb4 。

修改数据库排序

自建数据库走这一步

这一步我就不做尝试了

1
2
3
4
mysql -uroot -p<password>
create database zabbix character set utf8mb4 collate utf8mb4_bin;
create user 'zabbix'@'localhost' identified by '<password>';
grant all privileges on zabbix.* to 'zabbix'@'localhost';

导入数据

如果你是从源码安装 Zabbix，请继续按照以下步骤将数据导入数据库。这些数据库文件在 zabbix编译目录下（而不是最后安装的/usr/local/zabbix下）的/zabbix-6.0.4/database/mysql中
我们先把【schema.sql，images.sql，data.sql】（注意导入sql的顺序必须按照上面的文件顺序来）复制到本机来，用navicat导入（文件大小共32MB，建议压缩成zip传过来，如果本机有mysql server，可以直接跟着文档导入）。

导入后，一共是173个表，导入过程中我没有遇到任何错误。
zabbix表

配置zabbix

1
vi /usr/local/zabbix/etc/zabbix_server.conf

修改第一个位置（如果数据库在本机，跳过）

1
DBHost=你的数据库地址

修改第二个位置

1
DBName=创建的zabbix数据库,我这里假设是 myzabbix，上面由于后来改过数据库名了，从rt_zabbix改成了myzabbix

修改第三个位置

1
DBUser=数据库用户名，假设这里是 root

修改第四个位置

1
DBPassword=你的密码

其他可修改的地方

1
2
3
ListenPort=10051 #这里修改其zabbix与agent通讯端口，默认是10051
DBPort=3306 # 默认注释

启动服务端和Agent

1
2
/usr/local/zabbix/sbin/zabbix_server
/usr/local/zabbix/sbin/zabbix_agentd

日志在 /tmp下，server打印出这些内容后，

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
14212:20220519:203804.857 server #36 started [trapper #5]
14214:20220519:203804.861 server #38 started [alert syncer #1]
14215:20220519:203804.864 server #39 started [history poller #1]
14216:20220519:203804.867 server #40 started [history poller #2]
14217:20220519:203804.868 server #41 started [history poller #3]
14218:20220519:203804.870 server #42 started [history poller #4]
14219:20220519:203804.871 server #43 started [history poller #5]
14220:20220519:203804.872 server #44 started [availability manager #1]
14221:20220519:203804.876 server #45 started [trigger housekeeper #1]
14222:20220519:203804.877 server #46 started [odbc poller #1]
14201:20220519:203805.834 Zabbix agent item "vm.memory.size[total]" on host "Zabbix server" failed: first network error, wait for 15 seconds
.......
14193:20220519:203858.925 item "Zabbix server:zabbix[process,report writer,avg,busy]" became not supported: No "report writer" processes started.
14193:20220519:203859.934 item "Zabbix server:zabbix[process,report manager,avg,busy]" became not supported: No "report manager" processes started.
14207:20220519:203950.941 enabling Zabbix agent checks on host "Zabbix server": interface became available

Agent的日志

1
2
3
4
5
6
7
8
9
10
11
12
14229:20220519:203936.410 Starting Zabbix Agent [Zabbix server]. Zabbix 6.0.4 (revision 3d787ff402e).
14229:20220519:203936.410 **** Enabled features ****
14229:20220519:203936.410 IPv6 support:          YES
14229:20220519:203936.410 TLS support:           YES
14229:20220519:203936.410 **************************
14229:20220519:203936.410 using configuration file: /usr/local/zabbix/etc/zabbix_agentd.conf
14229:20220519:203936.411 agent #0 started [main process]
14233:20220519:203936.413 agent #4 started [listener #3]
14232:20220519:203936.413 agent #3 started [listener #2]
14234:20220519:203936.414 agent #5 started [active checks #1]
14231:20220519:203936.415 agent #2 started [listener #1]
14230:20220519:203936.418 agent #1 started [collector]

似乎都已经起来了。

准备 docker php环境

这里由于zabbix Web需要php环境，如果从0开始装太折腾了，所以就直接使用docker来完成，直接pull镜像吧

自Zabbix 5.0 版本开始，Zabbix 前端需 PHP 7.2 及以上版本。，那就安装7.4.29版本吧，别用8，后面会说的，然后结合php-fpm与nginx进行交互

1
docker pull php:7.4.29-fpm

然后注意下面的需求，按照下面的需求重新打包php:7.4.29-fpm

PHP 版本 7.2.5
PHP memory_limit 选项 128MB 在 php.ini 中： memory_limit = 128M
PHP post_max_size 选项 16MB 在 php.ini 中： post_max_size = 16M
PHP upload_max_filesize 选项 2MB 在 php.ini 中： upload_max_filesize = 2M
PHP max_execution_time 选项 300 秒（允许值 0 和 -1） 在 php.ini 中： max_execution_time = 300
PHP max_input_time 选项 300 秒（允许值 0 和 -1） 在 php.ini 中： max_input_time = 300
PHP session.auto_start 选项 必须禁用 在 php.ini: session.auto_start = 0
数据库支持 其中之一：MySQL、Oracle、PostgreSQL。 必须安装以下模块之一： mysql、oci8、pgsql
bcmath php-bcmath
mbstring php-mbstring
PHP mbstring.func_overload 选项 必须禁用 在 php.ini: mbstring.func_overload = 0
sockets php-net-socket.需要用户脚本支持。
gd 2.0.28 php-gd. PHP GD 扩展必须支持 PNG 图像 (–with-png-dir)、JPEG (–with-jpeg-dir) 图像和 FreeType 2 (–with-freetype-dir)。
libxml 2.6.15 php-xml
xmlwriter php-xmlwriter
xmlreader php-xmlreader
ctype php-ctype
session php-session
gettext php-gettext 自 Zabbix 2.2.1 起，PHP gettext 扩展不是安装 Zabbix 的强制要求。如果未安装 gettext，前端将照常工作，但是翻译将不可用。

我已经准备好了按上面要求修改过的基于php:7.4.29-fpm 的 php-template.ini，我们先建立一个目录，假设我建立在 /root/download/docker-php下

1
2
mkdir -p /home/docker-php
cd /home/docker-php

首先，先把这个php-template给下载下来，我已经基于7.4.29-fpm的php.ini-production按上面参数改了php.ini出来，或者，你自己可以自行提取/usr/local/etc/php/php.ini-production

1
wget https://oss.ruterfu.com/blog/2024/05/15/old-files/20220519-php7.4.29-fpm-template.ini -O php-template.ini

然后在把下面的内容写入 sources.list 文件（如果在国外，可以跳过，别忘了Dockerfile删除 COPY sources.list /etc/apt/sources.list 这句话，在国内不替换，卡死你。。）

1
2
3
4
5
6
7
8
deb https://mirrors.aliyun.com/debian/ bullseye main non-free contrib
deb-src https://mirrors.aliyun.com/debian/ bullseye main non-free contrib
deb https://mirrors.aliyun.com/debian-security/ bullseye-security main
deb-src https://mirrors.aliyun.com/debian-security/ bullseye-security main
deb https://mirrors.aliyun.com/debian/ bullseye-updates main non-free contrib
deb-src https://mirrors.aliyun.com/debian/ bullseye-updates main non-free contrib
deb https://mirrors.aliyun.com/debian/ bullseye-backports main non-free contrib
deb-src https://mirrors.aliyun.com/debian/ bullseye-backports main non-free contrib

然后新建 Dockerfile，并写入以下内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 基于php:7.4.29-fpm构建docker，别用php8，zabbix不支持。
FROM php:7.4.29-fpm
# 复制当前目录下的sources.list到docker中的/etc/apt/sources.list
# 如果上一步sources.list文件不写即使用原来的sources.list，下面用#注释掉
COPY sources.list /etc/apt/sources.list
# 复制当前目录的php-template.ini到docker中的/usr/local/etc/php/php.ini
COPY php-template.ini /usr/local/etc/php/php.ini
# 然后执行下面的命令，根据https://hub.docker.com/_/php重新编辑的，加上了zabbix最低要求支持
# 最后4行表示支持中文，英语，日语的语言选择，如果需要在配置中选择其他语言，请自行加入，否则构建好后只能选择中文英文和日语这3个
RUN apt-get update  && apt-get install -y \
                libfreetype6-dev \
                libjpeg62-turbo-dev \
                libpng-dev \
                libjpeg-dev \
                gettext \
                libldap2-dev \
                locales \
        && docker-php-ext-configure gd --with-freetype --with-jpeg  \
        && docker-php-ext-install -j$(nproc) gd \
        && docker-php-ext-install gettext \
        && docker-php-ext-install ldap \
        && docker-php-ext-install sockets \
        && docker-php-ext-install bcmath \
        && docker-php-ext-install mysqli \
        && echo 'zh_CN.UTF-8 UTF-8' > /etc/locale.gen \
        && echo 'en_US.UTF-8 UTF-8' >> /etc/locale.gen \
        && echo 'ja_JP.UTF-8 UTF-8' >> /etc/locale.gen \
        && locale-gen

千万别用php8，zabbix还不支持php8，不然打开后就是像我这样子

php8 一堆红色

最后，执行 Docker build .

1
docker build .

这个可能需要执行一段时间，执行完毕后，控制台会输出

1
2
3
4
5
6
7
8
9
10
11
12
.......
find . -name \*.so | xargs rm -f
find . -name .libs -a -type d|xargs rm -rf
rm -f libphp.la      modules/* libs/*
Generating locales (this might take a while)...
  zh_CN.UTF-8... done
  en_US.UTF-8... done
  ja_JP.UTF-8... done
Generation complete.
Removing intermediate container 0e992fd8595d
 ---> 0b79b4c11d3c
Successfully built 0b79b4c11d3c

然后执行下面运行命令，下面的0b79b4c11d3c 就是上面 Successfully built 0b79b4c11d3c的值

下面的 -v /usr/local/zabbix/php-webui:/var/www/zabbix 冒号前面的是宿主机目录，冒号后面的是docker中的目录

1
docker run -itd -p 9000:9000 -v /usr/local/zabbix/php-webui:/var/www/zabbix --name php-fpm 0b79b4c11d3c

输出

1
f7dbe3921462ae42891fef72bb48311f5a7e661486f7e6be485739fc89cf9bb4

然后将zabbix-ui文件复制到 /usr/local/zabbix/php-webui中，下面的/root/download/zabbix-6.0.4是上面编译zabbix的目录

1
cp -rf /root/download/zabbix-6.0.4/ui/* /usr/local/zabbix/php-webui/

这里记住，在Docker里，php-webui对应的是/var/www/zabbix

配置nginx，按照下面改就行了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
server {
        listen 8999;
        server_name 填上自己的域名;
        
        location ~ (\/zabbix).*\.php {
        		# 这里的/var/www指的是docker里面的目录
                root /var/www;
                fastcgi_index  index.php;
                fastcgi_pass   127.0.0.1:9000;
                fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
                include        fastcgi_params;
        }
        location /zabbix/assets {
                alias /usr/local/zabbix/php-webui/assets;
                expires 30d;
        }
        location /zabbix/js {
                alias /usr/local/zabbix/php-webui/js;
                expires 30d;
        }
        location /zabbix/favicon.ico {
                alias /usr/local/zabbix/php-webui/favicon.ico;
                expires 30d;
        }

}

配置Web环境

欢迎

打开自己网页 假设我这里是 http://127.0.0.1:8999，打开后即可看到Zabbix首页，选择语言包为中文。

打开首页

必要条件检测

刚才构建docker时准备的充分，可以看到这里已经全部支持了

支持所有的环境

配置DB连接

这里跟着上面zabbix的配置方式，配置的完全一致就行了，如果不能连接，试着把Database TLS encryption给关掉，如果连不上数据库是下不去的。

配置DB连接

设置 Settings

这里设置zabbix主机名字，然后时区选择东八区上海，这不用说了把

设置 Settings

安装前汇总

看下哪里是有问题的，不对的返回校对下

安装前汇总

安装

我这里悲剧的出现了无法写入文件，估计是权限不够，那么手动下载这个文件就行。

1
cp /tmp/zabbix.conf.php /usr/local/zabbix/php-webui/conf/zabbix.conf.php

之所以传到 /usr/local/zabbix/php-webui 下面而不是按照网站要求传到/var/www/zabbix/conf/zabbix.conf.php是因为docker run时设置了将 /usr/local/zabbix/php-webui 映射到了 /var/www/zabbix，所以说修改前面的目录等同于修改docker里面的这个目录

最后一步

上传完毕并覆盖后，点击完成，结束

所有配置结束

登录zabbix Web

默认的用户时Admin，密码是zabbix

进去后看到上面有一行报错红字

1
2
3
4
Connection to Zabbix server "localhost" failed. Possible reasons:
1. Incorrect server IP/DNS in the "zabbix.conf.php";
2. Incorrect DNS server configuration.
Cannot assign requested address

很明显是无法解析 localhost 到准确的IP（一般情况下，系统能识别 localhost成127.0.0.1 是因为在 /etc/hosts进行了配置，而这个配置是系统自己做的）

这里很简单，修改下刚刚上传的 zabbix.conf.php，找到如下内容

1
2
3
4
5
6
7
8
9
// Use IEEE754 compatible value range for 64-bit Numeric (float) history values.
// This option is enabled by default for new Zabbix installations.
// For upgraded installations, please read database upgrade notes before enabling this option.
$DB['DOUBLE_IEEE754']   = true;

// Uncomment and set to desired values to override Zabbix hostname/IP and port.
# 取消注释这2行，然后分别填上 172.17.0.1 和 10051
// $ZBX_SERVER                  = '';
// $ZBX_SERVER_PORT             = '';

取消上面 $ZBX_SERVER 和 $ZBX_SERVER_PORT 前面的注释，然后填上值 172.17.0.1 以及 10051，保存即可，无需重启docker。这里为什么要填写 172.17.0.1 是因为docker在默认情况下，会生成一个 172.17.0.1/24 的ip负责docker之间的通信，其中宿主机IP固定是 172.17.0.1，所以，这里填写172.17.0.1等同于访问宿主机10051端口，而刚刚编译后，运行 zabbix_server，它就是监听者10051端口。

安装过程结束

至此，安装过程告终，密码别忘了改，后面zabbix如何自启下一篇会描述，然后zabbix_agent如何和主机建立安全的连接，下一篇会详细描述。至于为什么一篇说不完本身我自己也在挖坑，例如说构建docker时如何一口气装上所有的软件，然后中文tm就弄了我一会，拿php-8.4来构建好了结果一堆红。

关于Oracle云，近期在电报群中听到Oracle Cloud竟然送免费的服务器，我也成功申请了一台，如果你有兴趣的话，Oracle 云免费套餐 - oracle.com 我就贴上地址，自行注册，自行解决问题，我不会为这个提供任何建议以及不会给予任何指导。