---
title: Ubuntu 24.04 安装 Zabbix 8.0 全记录
date: '2026-05-22T00:00:00.000Z'
slug: '202605221646'
draft: false
categories:
  - 笔记
tags: []
author: 小赵
layout: post
ai_comment: >-
  MySQL 8.0的binlog和权限管理确实严格了不少。建议在导入前临时关闭binlog（SET
  SQL_LOG_BIN=0）或者给zabbix用户加SUPER权限。另外AllowUnsupportedDBVersions=1这个参数很关键，Zabbix
  8.0对MySQL版本校验很严格，遇到类似问题的同仁可以直接参考这条解决方案。路径变更问题也提醒我们，版本升级时文档结构可能调整，find命令比记忆路径更可靠。
---
## 环境说明

新到了一台装了 Ubuntu 24.04 的机器，需要搭个 Zabbix 8.0 。用的 MySQL 8.0.45 做数据库，整个过程踩了不少坑，记录一下方便以后翻看。

---

## 安装流程

### 添加官方源

Ubuntu 自带源里的 Zabbix 版本太老，直接去官方拉最新的仓库包：

```bash
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 全装上：

```bash
sudo apt install -y zabbix-server-mysql zabbix-frontend-php zabbix-apache-conf zabbix-sql-scripts zabbix-agent mysql-server
```

### 配置数据库

先登进 MySQL：

```bash
sudo mysql -u root
```

建库、建用户、授权，三步走：

```sql
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;
```

### 导入初始数据

```bash
sudo zcat /usr/share/zabbix/sql-scripts/mysql/server.sql.gz | mysql -uzabbix -p zabbix
```

### 改配置文件

编辑 `/etc/zabbix/zabbix_server.conf`，加上这两行：

```
DBPassword=你的密码
AllowUnsupportedDBVersions=1
```

第二行后面会讲到为什么需要，第二行配置文件搞了我很久。

### 修复语言环境

```bash
sudo apt install -y locales
sudo locale-gen en_US.UTF-8
```

### 启动服务

```bash
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` 语言包**，最小化安装的系统可能要手动装

---

## 验证是否跑起来了

```bash
# 三个服务都看看状态
sudo systemctl status zabbix-server zabbix-agent apache2

# 翻翻日志有没有报错
sudo tail -20 /var/log/zabbix/zabbix_server.log
```

然后浏览器访问页面，用默认账号登进去，去"数据采集 -> 主机"里瞅一眼

本机那个 ZBX 图标变绿就说明整套东西跑通了。