保姆级教程：一步一步使用1Panel安装兵完成Zabbix监控系统配置

发表于前天 13:09

本帖最后由 hackfans 于 2026-6-15 15:47 编辑

一、安装环境
（1）操作系统：Ubuntu 26
（2）1Panel版本：社区版v2.2.1
（3）安装前准备环境
由于1Panel几乎虽有的软件，都是基于Docker的，提前测试好网络环境或添加Docker镜像，因为如果网速很慢，有时拉去镜像会出现一些不可预测的或者奇奇怪怪的问题。
二、开始安装
（1）1Panel当前提供的Zabbix版本是7.4，需要先安装MySql数据库，这里要求数据库版本在8.0以上。这里没有特殊需求默认安装就好了。
（2）开始安装Zabbix
安装.png

这里可以搜索到2个，先安装Zabbix-Server

安装Zabbix.png

基本也没有什么可以修改的，除非有端口或者数据库方面的要求，之后Docker就开始拉取数据了，这个过程因服务器资源和网络环境，不大相同，耐心等待。
拉取Zabbix镜像.png

（3）登录后台修改语言
一般默认的登录地址是 http://IP:8080，默认登录的用户名和密码分别为Admin/zabbix，注意区分大小写。
之后如图修改时区和语言。
修改中文.jpg

这样我们登录到系统就是中文界面了。
登录界面.png

我们可以注意到系统默认添加Zabbix Server主机监控项的，是用的是Anegt作为主机的监控类型，由于我们还没有安装，此时无法监控到，所谓主机为不可用状态。
接下来按时安装Zabbix-Agent。
跟安装Zabbix Server一样，几乎不用改任何配置，直接就可以。
这里需要注意的是监控主机的主机名一定要记好，必须跟后面Zabbix Server里，监控的主机名称完全一致，服务端IP地址为安装Zabbix Server服务器的地址，在这里，我们都是在一个主机里进行的，所以IP地址一样，如果修改了端口，记得需要同步修改。
安装Zabbix-Agent.png

接来下，就是开始拉取Zabbix Agent的镜像安装过程了。
安装Zabbix-Agent_2.png

三、调试与排除故障
安装并确认Zabbix Agent启动正常，在Zabbix Server里发现并没有检测到，此时主机的配置信息IP地址为127.0.0.1，默认指向本机，按理说应该可以的，提示链接被拒绝，如下图。
Agent 报错不可用1.png

不过我这里是通过Docker安装的，这里先把IP地址改成服务器的IP地址，尝试一下，服务器IP地址为192.168.66.250
Agent 报错不可用2.png

稍等几分钟，一会儿会刷新结果。
Agent 报错不可用3.png

从结果看，提示错误变了，但还是不行，好像提示权限问题，被拒绝了。那我们去Zabbix Agent看下Dcoker有没有相关的日志吧。
Agent 报错不可用4.png

竟然提示，failed to accept an incoming connection: connection from "172.18.0.1" rejected, allowed hosts: "192.168.66.250"
从报错信息上来看，来自172.18.0.1的链接被拒绝，允许的主机是192.168.66.250。初步分析，这个172.18.0.1，是Docker的桥接网关地址，如果是物理主机直接安装，应该不会出现这个问题，那我们就去修改一下Zabbix Agent的配置文件，尝试一下。
================================
修改有风险，必须评估后，再尝试，或提前做好备份！！！
修改有风险，必须评估后，再尝试，或提前做好备份！！！
修改有风险，必须评估后，再尝试，或提前做好备份！！！
================================
Agent 报错不可用5.png

打开容器的参数配置文件
Agent 报错不可用6.png

切换到标签 & 环境变量标签，往下找环境变量参数。
Agent 报错不可用7.png

之后确认保存，系统会有提示，是否确认。
Agent 报错不可用8.png

确认后，容器会重新加载文件，并启动。
Agent 报错不可用9.png

这时，我们切回Zabbix Server界面，稍等几分钟，看看Zabbix Agent是否可以正常上线。
我们神奇的发现，Zabbix已经上线了。
Agent 报错不可用10.png

等半个小时，各项数据都能正常刷新出来了。
Agent 报错不可用11.png

具体原因，估计是因为Docker网关的事儿，物理机安装可能不会遇到此问题。
上面只是我遇到的情况和解决方案，不代表都是因为此问题导致的，需要自己权衡判断后尝试。