企业官网建设流程全解析

说实话，接到这个需求的时候，我第一反应是有点犯嘀咕的。openEuler 24.03 LTS 虽然跟 RHEL 血缘很近，但 Zabbix 官方仓库并没有直接为它准备 RPM 包，你硬把 CentOS 的 rpm 拿过来装，依赖上会整出一堆问题，搞不好就把系统的 dnf 环境搅乱了。而监控系统这种基础设施，最怕的就是装完不敢动、升级还得看别人脸色。所以我最终选了源码编译的路线，把 Zabbix 7.4 完整地从源码编出来，装到 openEuler 24.03 LTS 上，效果比我预想的稳定。这篇文章就把整个过程拆开讲清楚，包括依赖怎么配、数据库怎么选、前端怎么挂、服务怎么托管，以及我实际踩过的几个坑。

这篇内容适合谁？如果你正在做国产化替代，需要把监控系统迁移到 openEuler；如果你不想被发行版软件仓库绑死，想自己控制 Zabbix 的编译选项和版本；或者你只是想提前看看源码编译 Zabbix 会遇到哪些坎，都可以把这篇文章当作一个可复现的参考。整个流程走下来，一台 4C8G 的机器，两个小时左右可以搞定。

1. 为什么选源码编译：openEuler 上的现实选择

1.1 官方仓库不直接支持 openEuler，这才是核心原因

Zabbix 官方提供 RPM 包的发行版列表里，主要是 RHEL、Rocky Linux、AlmaLinux、Debian、Ubuntu 这些“老面孔”。openEuler 虽然兼容 RHEL 的很多软件包格式，但毕竟不是 RHEL 的复制品，官方仓库里压根没有针对 openEuler 的 repodata。你去 Zabbix 官网下载页翻一遍，会发现它给出的安装命令里根本没有 openEuler 的选项，硬套 CentOS 的源大概率会遇到依赖解析失败，因为 openEuler 24.03 的库版本和 CentOS 7 差了好几个代际。

有人可能说，那我自己把官方 RPM 的 baseurl 改成指向 openEuler 呢？这个思路在个别包上能碰运气，但 Zabbix Server 依赖 libevent、pcre2、OpenSSL 等一堆库，版本一不匹配，dnf 就会给你列出几十个冲突，最后你还得手动换库版本，风险太大。生产环境里为装一个监控软件去动系统级的 SSL 或者 PCRE 库，这个账怎么算都不划算。

还有一部分人说那就用 Docker 跑 Zabbix，容器方案确实干净，但不少内网环境对容器管控很严，或者你监控的就是宿主机自身的硬件状态，用容器部署反而要多绕一层网络和权限的问题。相比之下，源码编译是最“接地气”的路径——不污染系统的其他软件包，只把 Zabbix 相关的二进制装进独立的 prefix 目录，升级的时候重新编译覆盖即可，卸载的时候直接删目录也很干净。

1.2 源码编译能带来哪些实际便利

用--prefix把 Zabbix 独立安装在/usr/local/zabbix下，意味着所有二进制、配置文件、甚至是未来要用的前端 PHP 代码，都窝在同一个目录里。日常维护思路很清楚：备份这个目录，配置和程序一起走；想回退版本，把旧包解压覆盖回来就行。对比用 RPM 那种散落在/etc、/usr/sbin、/usr/share的安装方式，源码编译对于定制化强的环境反而更容易管理。

另外，你可以按需裁剪编译选项。不需要 SNMP 监控的话，就不加--with-net-snmp；需要 JMX 监控的话，提前装好 Java 头文件再编译进去。这种“要什么编什么”的控制力，是用 RPM 包没法做到的。我这次场景比较通用，所以把常用的模块都编上了，包括 SNMP、IPMI、libcurl、libxml2，后面接各种设备监控时不用再回头重编。

2. 环境准备：工具链、依赖库和基础服务

2.1 系统检查和软件源更新

我用的是一台最小化安装的 openEuler 24.03 LTS x86_64 机器。拿到机器第一件事，先看系统版本和 CPU/内存，确认环境没问题：

cat /etc/openEuler-release nproc free -h df -h /

版本输出是 openEuler release 24.03 (LTS)，内存 8G，4 核，磁盘剩余 50G 左右，编译 Zabbix 完全够用。接下来更新软件源缓存，确保后续装的依赖包都是最新状态：

dnf update -y dnf makecache

这一步建议别省。openEuler 24.03 刚装完，软件源索引往往是旧的，直接装依赖可能拉到老版本，编译时遇到奇怪的报错再排查就绕远了。

2.2 安装编译工具链和关键依赖库

Zabbix Server 是纯 C 写的，编译需要完整的 GNU 工具链。openEuler 的软件组和 RHEL 体系一致，直接装 Development Tools 这个组：

dnf groupinstall "Development Tools" -y

这个组会把 gcc、gcc-c++、make、autoconf 等一次性装齐。接下来是 Zabbix 源码编译时真正决定成败的依赖库，我把常用项整理成表格：

安装命令：

dnf install -y wget vim net-tools pcre-devel pcre2-devel libevent-devel \ curl-devel libxml2-devel net-snmp-devel OpenIPMI-devel openssl-devel \ mariadb-devel libssh-devel java-1.8.0-openjdk-devel sqlite-devel

我在里面额外加了java-1.8.0-openjdk-devel和sqlite-devel，前者是为了给 Zabbix Server 预留 JMX 监控能力，后者是某些内部模块需要。如果目标机器上实在装不齐，至少保证表格里前 7 个必须装完，否则编译中后期会卡壳。

2.3 创建独立的运行用户和基础目录

Zabbix 官方建议用非 root 用户运行服务，这样即使被利用，权限也不会直接打到 root。这里创建独立的系统用户：

groupadd --system zabbix useradd --system --gid zabbix --shell /sbin/nologin --home-dir /usr/local/zabbix zabbix

用--system创建的是系统账号，不会出现在登录界面里。后面所有 Zabbix 相关的服务进程，都会以这个身份运行。

3. 准备数据库：Zabbix 7.4 的数据底座

3.1 为什么我选了 MariaDB

Zabbix 7.4 支持的数据库有 MySQL、MariaDB、PostgreSQL 和 TimescaleDB。openEuler 24.03 的软件源原生带的是 MariaDB，直接用 dnf 安装就能跑，省去折腾 MySQL 官方源的过程。而且 MariaDB 对 MySQL 协议完全兼容，Zabbix 前端 PHP 用的 mysqlnd 扩展连接它毫无压力，日常运维也够稳。

如果你团队里有 DBA 明确要求用 PostgreSQL，Zabbix 也能支持，但本文场景我用 MariaDB 做完整流程，这点先讲清楚。生产环境如果已经装了 MySQL 8.x，也可以直接复用，数据库账号授权的方式是通用的。

3.2 安装并初始化 MariaDB

dnf install -y mariadb-server mariadb systemctl enable --now mariadb

初始化安全设置这一步，建议按提示走一遍，至少把 root 密码设好、禁止匿名用户、删除 test 库：

mysql_secure_installation

MariaDB 装好后默认监听 3306，Zabbix Server 直接走本机回环连接，不需要暴露到外网。

3.3 创建 Zabbix 专用数据库和账号

登录数据库，执行下面的 SQL 创建 Zabbix 需要的库和账号。字符集必须按官方要求用utf8mb4和utf8mb4_bin，否则后面中文监控项和图形标题可能出现乱码或者排序异常：

mysql -uroot -p

CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; CREATE USER 'zabbix'@'localhost' IDENTIFIED BY 'YourStrongPassword123!'; GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost'; FLUSH PRIVILEGES;

这里有个细节：@'localhost'和@'127.0.0.1'在 MySQL 协议里是两个不同的账号，如果后面 Zabbix Server 的配置里DBHost填的是 127.0.0.1，而授权只给了 localhost，那你启动服务后看日志会发现 access denied。我的习惯是干脆两个都建，省得排查这种“看似连接失败”的坑：

CREATE USER 'zabbix'@'127.0.0.1' IDENTIFIED BY 'YourStrongPassword123!'; GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'127.0.0.1'; FLUSH PRIVILEGES;

密码强度自己控制，生产环境别用我这种演示密码，建议大小写加数字加特殊符号，长度至少 12 位。

4. 编译安装 Zabbix Server 与 Agent

4.1 获取 7.4 源码包

Zabbix 官方源码包放在 cdn 上，稳定版路径是sources/stable/7.4/zabbix-7.4.0.tar.gz，如果后续出了更小的小版本号，比如 7.4.1，名称相应替换即可。我这次用的 7.4.0：

wget https://cdn.zabbix.com/zabbix/sources/stable/7.4/zabbix-7.4.0.tar.gz tar zxvf zabbix-7.4.0.tar.gz cd zabbix-7.4.0

下载前记得确认网络能连到公网。在内网环境下，可以把 tar 包先下载后传到服务器上。解压后目录结构很简单，database里放数据库初始化脚本，frontends/php里是 Web 前端源码，src是 C 源码，后面全用得上。

4.2 configure 参数详解与生成

configure 是整个编译过程的“定调”环节，参数决定了你要编出什么样的 Zabbix。下面这个组合是我这套环境验证过的：

./configure \ --prefix=/usr/local/zabbix \ --enable-server \ --enable-agent \ --with-mysql \ --with-net-snmp \ --with-libcurl \ --with-libxml2 \ --with-openssl \ --with-ssh2 \ --with-java

configure 正常结束后，注意看最后的输出摘要，它会明确列出你启用的功能模块。如果你发现哪一行显示SNMP support: no，说明刚才的依赖包没装对，这时候返工比编译到一半报错要省事得多。

4.3 make 编译和安装

编译这一步对 CPU 和内存有一定压力，我直接用多核并行：

make -j$(nproc)

注意，如果你的服务器内存只有 2G，建议别把nproc的核数全压上去，手动控制make -j2，否则编译过程中可能因为资源不足直接 OOM 挂掉，白等好几分钟。编译时间跟机器性能关系很大，4 核机器一般 10 分钟左右能跑完。

编译完成后安装：

make install

安装完成后，检查一下关键目录：

ls -l /usr/local/zabbix/sbin/ ls -l /usr/local/zabbix/etc/

如果能看到zabbix_server、zabbix_agentd（或zabbix_agent2）和对应的.conf文件，这步就成功了。我在首次编译时遇到过zabbix_agent2没生成的情况，后来确认是因为--enable-agent不够，又补了一次make clean && ./configure --enable-server --enable-agent --enable-agent2 ...，所以如果你的环境想直接用新版 agent2，建议 configure 时把--enable-agent2也显式加上。

4.4 导入数据库表结构

Zabbix 前面创建的zabbix库目前还是空的，需要导入三份初始 SQL。文件默认安装在/usr/local/zabbix/share/zabbix/database/mysql/目录下：

cd /usr/local/zabbix/share/zabbix/database/mysql/ ls

正常情况下能看到schema.sql、images.sql、data.sql三个文件。导入顺序不能乱，schema 是表结构，images 是图片，data 是默认配置数据：

mysql -uzabbix -p'YourStrongPassword123!' zabbix < schema.sql mysql -uzabbix -p'YourStrongPassword123!' zabbix < images.sql mysql -uzabbix -p'YourStrongPassword123!' zabbix < data.sql

如果某些版本打包的是.sql.gz压缩文件，就用 zcat 方式导入：

zcat schema.sql.gz | mysql -uzabbix -p'YourStrongPassword123!' zabbix

导入完成后可以快速确认一下表数量：

mysql -uzabbix -p'YourStrongPassword123!' zabbix -e "show tables;"

正常会有 160+ 张表，如果一张表都没有，八成是导入失败，MySQL 会报错，回头检查账号权限或磁盘空间。

5. 部署 Web 前端：Nginx + PHP-FPM

5.1 前端需要的 PHP 扩展

Zabbix 7.4 的前端是 PHP 写的，要求 PHP 8.0 以上，并且在 openEuler 24.03 的默认软件源里 PHP 版本刚好满足需求。我在前端选型上用了 Nginx + PHP-FPM，比 Apache 更轻量，也和现在主流的 Web 部署习惯一致。

先把 PHP 和扩展装齐：

dnf install -y nginx php php-fpm php-gd php-bcmath php-mbstring php-xml \ php-mysqlnd php-gettext php-ldap

这些扩展缺一不可。php-gd缺失会导致前端图形绘制异常，php-bcmath缺失会导致某些数值计算报错，php-mysqlnd是 PHP 连 MariaDB 的桥梁。如果前端安装向导提示某个扩展缺失，按提示补齐后重启 php-fpm 即可。

5.2 配置 PHP-FPM 和 Nginx 站点

先改 PHP 时区，不然后端会一直报时区配置警告：

vim /etc/php.ini

把date.timezone那一行取消注释并改成：

date.timezone = Asia/Shanghai

同时把常用参数调整一下，避免后续数据量大了前端卡顿：

memory_limit = 256M post_max_size = 16M max_execution_time = 300 max_input_time = 300

启动 PHP-FPM：

systemctl enable --now php-fpm

RHEL 系默认的 php-fpm 监听 127.0.0.1:9000，我直接用这个端口，不需要改成 socket，省去权限适配的麻烦。

把前端源码复制到 Zabbix 安装目录下的 Web 访问路径：

mkdir -p /usr/local/zabbix/share/zabbix/php cp -r frontends/php/* /usr/local/zabbix/share/zabbix/php/ chown -R nginx:nginx /usr/local/zabbix/share/zabbix/php

这里的前端路径直接放在 Zabbix prefix 目录下，好处是未来升级时前后端版本能保持严格一致，不会出现前端文件和 Server 版本错位导致的功能异常。

Nginx 站点配置如下：

server { listen 80; server_name zabbix.example.com; root /usr/local/zabbix/share/zabbix/php; index index.php; location / { try_files $uri $uri/ /index.php?$args; } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } location ~ /\.(?!well-known).* { deny all; } }

保存后重载 Nginx：

systemctl enable --now nginx nginx -t && systemctl reload nginx

5.3 安装向导操作流程

浏览器访问http://你的服务器IP/，会进入 Zabbix 前端安装向导。这个向导总共有 5 步，我实际点下来有几个地方特别容易出错。

第一步是环境预检。页面会列出 PHP 版本、各扩展状态、时区配置等，全部是 OK 才可继续。如果某个扩展没装，会明确报红字，直接回服务器补装重启 php-fpm 就行。

第二步填写数据库连接信息。这里有个坑：数据库用户那一栏默认显示的是replace_user而不是zabbix，很多人不细看直接点了下一步，然后就报access denied for user 'replace_user'@'localhost'。我第一次装也中招了，所以后来回回都特意提醒自己改。数据库主机填 localhost，端口默认 0（表示用 MySQL 默认端口），库名填 zabbix，用户填 zabbix，密码填创建账号时设的密码。

第三步配置 Zabbix Server 参数。Host 填本机 IP，端口保持 10051，Name 可以填一个能识别这台监控服务器的名字，比如Zabbix-OpenEuler-Main，这一项会显示在前端右上角。

第四步是安装前汇总，确认配置没问题。

第五步，前端会把配置写入conf/zabbix.conf.php。如果目录权限不够导致写入失败，页面会提示你手动下载该文件，把它放到/usr/local/zabbix/share/zabbix/php/conf/目录下。我建议提前做好权限，避免走手动下载的弯路：

chown -R nginx:nginx /usr/local/zabbix/share/zabbix/php/conf

安装完成后用默认管理员账号登录：用户名Admin，初始密码zabbix。登录后第一件事就是改掉这个默认密码，不然监控系统等于对所有人裸奔。

6. 服务配置、托管与主机接入

6.1 编写 zabbix_server.conf 关键配置

Zabbix Server 的主配置文件是/usr/local/zabbix/etc/zabbix_server.conf。我重点调整了这几项：

LogFile=/var/log/zabbix/zabbix_server.log PidFile=/var/run/zabbix/zabbix_server.pid DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=YourStrongPassword123!

DBHost这里我填 localhost 而不是 127.0.0.1，和前面建数据库账号的授权保持一致。如果启动后日志报Access denied for user 'zabbix'@'localhost'，大概率就是授权里的 host 和这里的 host 对不上。

创建日志和 PID 目录并授权：

mkdir -p /var/log/zabbix /var/run/zabbix chown -R zabbix:zabbix /var/log/zabbix /var/run/zabbix

6.2 用 systemd 托管 Zabbix Server

虽然 Zabbix Server 本身支持直接启动，但我建议写成 systemd 服务，方便开机自启和崩溃自动拉起。新建/usr/lib/systemd/system/zabbix-server.service：

[Unit] Description=Zabbix Server After=network.target mariadb.service [Service] Type=forking PIDFile=/var/run/zabbix/zabbix_server.pid ExecStart=/usr/local/zabbix/sbin/zabbix_server ExecStop=/bin/kill -SIGTERM $MAINPID User=zabbix Group=zabbix Restart=on-failure [Install] WantedBy=multi-user.target

Type=forking是因为 zabbix_server 默认会 fork 到后台运行，systemd 通过 PIDFile 跟踪主进程，这个配置适合默认行为。启动：

systemctl daemon-reload systemctl enable --now zabbix-server systemctl status zabbix-server

如果状态是 active (running)，这时去看一下日志确认没有报错：

tail -f /var/log/zabbix/zabbix_server.log

能看到using configuration file: /usr/local/zabbix/etc/zabbix_server.conf和current database version类似的信息基本就是正常起来了。

Agent 的 systemd 服务也顺手托一下：

[Unit] Description=Zabbix Agent After=network.target [Service] Type=forking PIDFile=/var/run/zabbix/zabbix_agentd.pid ExecStart=/usr/local/zabbix/sbin/zabbix_agentd ExecStop=/bin/kill -SIGTERM $MAINPID User=zabbix Group=zabbix Restart=on-failure [Install] WantedBy=multi-user.target

Agent 配置文件/usr/local/zabbix/etc/zabbix_agentd.conf里需要改这几行：

Server=127.0.0.1 ServerActive=127.0.0.1 Hostname=OpenEuler-Monitor-Server

这里的 Server 表示允许谁来这台机器拉数据，ServerActive 表示这台 agent 主动向哪个 server 上报，Hostname 在 Zabbix Web 界面添加主机时要保持一致，不然会出现数据能采到但对不到主机上的情况。

6.3 放行防火墙端口

openEuler 默认可能开了 firewalld，先把页面监控端口和 Zabbix 通信端口放出来：

firewall-cmd --permanent --add-port=80/tcp firewall-cmd --permanent --add-port=10051/tcp firewall-cmd --permanent --add-port=10050/tcp firewall-cmd --reload

10050 是 agent 被动采集端口，10051 是 server 接收数据端口。如果你不开防火墙，这一步可以跳过，但我建议还是按标准把端口管控住。

6.4 其他主机怎么添加到 Zabbix 监控

这套环境建好后，下一步自然是接入其他机器。最简单的办法，是在被监控主机上单独编译一个 agent，配置完全一致，就是只编 agent 部分：

./configure --prefix=/usr/local/zabbix-agent --enable-agent make && make install

然后按 6.2 的方式做 systemd 托管，配置文件里把 Server 和 ServerActive 都改成监控中心服务器的 IP，Hostname 改为这台被监控主机的名字。

接着回 Zabbix Web 界面，配置路径是数据采集 → 主机 → 创建主机：

• 主机名称填刚才 agent 配置里的 Hostname，要和 agent 的配置完全一致
• 可见名称可以填中文业务名，比如“财务核心服务器”
• 模板选择Linux by Zabbix agent
• 接口 IP 填被监控主机的 IP，端口 10050

保存后大概等 1-2 分钟，到监测 → 最新数据里就能看到 CPU、内存、磁盘这些指标了。如果一直是灰色没数据，优先检查两个方向：一是被监控主机防火墙是不是把 10050 端口挡了，二是 agent 配置里 Server 字段是不是真的允许这台监控中心来取数。

7. 常见问题与排查实录

7.1 高频问题速查表

我把这段时间在 openEuler 上编 Zabbix 遇到的典型问题整理成一个速查表，遇到问题先按这个表对照一遍：

7.2 印象最深的三次踩坑

configure: error: MySQL library not found是我第一次编译时卡住的第一个坎。我看了下系统里明明有 mysql 客户端，但 configure 说的是“库”，不是“客户端命令”。在 openEuler 里对应的开发库包名是mariadb-devel，装上之后重新跑 configure 就顺利通过了。后来我才意识到，RHEL 系的 MySQL 客户端和服务器虽然叫 mysql，但开发头文件早就整合在 mariadb-devel 里，看到包名的第一反应不能是“我要装 MySQL 的开发包”。

第二个坑就是access denied for user 'replace_user'@'localhost'。这个报错信息很有迷惑性，乍一看像数据库没有这个用户，实际是前端安装向导默认数据库用户那栏填的就是 replace_user，一个引导性的占位符。当时没仔细看就直接点了下一步，数据库当然会拒绝。这个报错在很多社区里被反复问过，说明不是我一个人粗心。

第三个坑是zabbix server is not running: the information displayed may not be current.。这个提示一出来，我第一反应是看 systemd 状态，发现服务明明是 active，但前端就是报 not running。后来查日志发现，Server 启动后因为数据库里有历史数据、首次升级索引等原因，初始化时间比较长，而前端检测的静态超时时间太短。解决办法很简单：等两分钟刷新页面就正常了。如果刷新后还是报错，再去看/var/log/zabbix/zabbix_server.log的尾部，有没有cannot start preprocessing这类字样，那才说明真的有配置问题。

7.3 关于版本选择的一点个人建议

Zabbix 7.4 属于功能迭代版本，比 7.0 LTS 有更新的模板和特性，但如果你是要长期稳定运行、不追求新功能的生产环境，我更建议把编译参数里的版本号换成 7.0 LTS，过程一模一样。毕竟 LTS 意味着官方修复周期更长，在监控这种 7x24 的平台上，稳定性价值高于新功能价值。我这次为了写这篇文章选的 7.4，个人实验环境无所谓，生产环境建议按需求权衡。

最后再分享一个小技巧：整个流程走完一遍后，最好把下载好的源码包、configure 参数、systemd 单元文件、配置文件都保存在一个目录里，比如/opt/zabbix-install-backup/，以后新加监控服务器，照着这套存档重放一遍要比你重新回忆所有参数轻松得多。监控系统本身就是为了省事，搭建过程别给自己留麻烦。