环境说明
新到了一台装了 Ubuntu 24.04 的机器,需要搭个 Zabbix 8.0 。用的 MySQL 8.0.45 做数据库,整个过程踩了不少坑,记录一下方便以后翻看。
安装流程
添加官方源
Ubuntu 自带源里的 Zabbix 版本太老,直接去官方拉最新的仓库包:
wget https://repo.zabbix.com/zabbix/8.0/release/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest_8.0+ubuntu24.04_all.deb
sudo dpkg -i zabbix-release_latest_8.0+ubuntu24.04_all.deb
sudo apt update
安装组件
一条命令把服务端、前端、数据库、Agent 全装上:
sudo apt install -y zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-sql-scripts zabbix-agent mysql-server
配置数据库
先登进 MySQL:
sudo mysql -u root
建库、建用户、授权,三步走:
CREATE DATABASE zabbix CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
CREATE USER 'zabbix'@'localhost' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON zabbix.* TO 'zabbix'@'localhost';
FLUSH PRIVILEGES;
QUIT;
导入初始数据
sudo zcat /usr/share/zabbix/sql-scripts/mysql/server.sql.gz | mysql -uzabbix -p zabbix
改配置文件
编辑 /etc/zabbix/zabbix_server.conf,加上这两行:
DBPassword=你的密码
AllowUnsupportedDBVersions=1
第二行后面会讲到为什么需要,第二行配置文件搞了我很久。
修复语言环境
sudo apt install -y locales
sudo locale-gen en_US.UTF-8
启动服务
sudo systemctl restart zabbix-server zabbix-agent apache2
sudo systemctl enable zabbix-server zabbix-agent apache2
网页初始化
浏览器打开 http://你的服务器IP/zabbix,跟着向导填:
- 数据库类型选 MySQL
- 主机填 localhost
- 库名 zabbix,用户名 zabbix,密码填你设的那个
- 时区选 Asia/Shanghai
完成后用 Admin / zabbix 登录就行。
踩过的坑
坑一:数据文件路径不对
照着网上教程写的路径 /usr/share/zabbix-sql-scripts/mysql/server.sql.gz,结果报文件不存在。用 find /usr/share -name "server.sql.gz" 搜了一下才发现 8.0 版本路径变了,实际在 /usr/share/zabbix/sql-scripts/mysql/server.sql.gz,中间少了一层目录。
坑二:数据库权限报错
导入数据时报这个:
ERROR 1419 (HY000): You do not have the SUPER privilege and binary logging is enabled...
MySQL 开了 binlog,zabbix 用户没有 SUPER 权限,没法创建存储过程。先登录 root 执行一下 SET GLOBAL log_bin_trust_function_creators = 1; 临时放开限制,再重新导入就好了。
坑三:配置文件变量名大小写
用 grep "DBpassword" 查配置啥也没找到,折腾半天发现是大小写问题,变量名是 DBPassword(P 大写)。Linux 下这种大小写敏感的地方挺多的,习惯了就好。
坑四:MySQL 版本不被支持
服务死活起不来,日志里写着:
Unable to start Zabbix server due to unsupported MySQL database version (8.00.45).
Must be at least (8.04.00).
Ubuntu 24.04 自带的 MySQL 8.0.45 版本太新,Zabbix 8.0 的白名单里还没有它。其实数据库完全兼容,只是校验逻辑没跟上。解决方法是配置文件里加一行 AllowUnsupportedDBVersions=1,跳过版本检查就好。当然这行得自己承担风险,不过单机用完全没问题。
坑五:语言环境检测不通过
网页安装那步卡在系统语言检查,en_US 那项是红色的。因为系统缺了英文语言包,装上 locales 并生成 en_US.UTF-8,重启 Apache 和 Zabbix Server 就过了。
坑六:数据没完全导进去
前面权限问题导致导入中断,虽然部分表已经建了但 users 表是空的,启动时直接报:
cannot use database "zabbix": its "users" table is empty
干脆删库重建,重新完整导入一遍,最后 SHOW TABLES 出来 211 张表就对了。
顺手学到的几个知识点
mysql -p跟密码时中间不能有空格,建议直接回车然后交互式输入,更安全sed -i是原地改文件,加.bak后缀可以自动备份原文件sed分隔符不一定是/,遇到 URL 这种含斜杠的内容时用s#原内容#新内容#更方便AllowUnsupportedDBVersions=1可以跳过数据库版本校验,适合用较新数据库版本的情况- Zabbix 前端需要
en_US.UTF-8语言包,最小化安装的系统可能要手动装
验证是否跑起来了
# 三个服务都看看状态
sudo systemctl status zabbix-server zabbix-agent apache2
# 翻翻日志有没有报错
sudo tail -20 /var/log/zabbix/zabbix_server.log
然后浏览器访问页面,用默认账号登进去,去"数据采集 -> 主机"里瞅一眼
本机那个 ZBX 图标变绿就说明整套东西跑通了。
