麒麟os部署zabbix客户端有三种实测可行方式:一、yum在线安装,适用于有网络环境;二、离线rpm手动安装,适配无网信创场景;三、agent2编译安装,满足高定制与稳定性需求。

如果您在麒麟操作系统上部署Zabbix客户端(Agent)时遇到服务无法启动、配置不生效或与服务端通信失败等问题,则很可能是由于安装方式与系统环境不匹配、配置项未正确指向服务端,或SELinux/防火墙策略拦截所致。以下是针对麒麟OS(涵盖V10 SP2/SP3及V11)安装Zabbix客户端的多种实测可行路径:
一、YUM在线快速安装方式
该方式适用于具备内网镜像源或可访问公网的麒麟OS环境,由dnf/yum自动解析并安装依赖,适合批量部署与快速验证场景。安装包经麒麟官方仓库适配,兼容性已通过基础测试。
1、导入Zabbix官方仓库GPG密钥并安装仓库配置包:
rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/zabbix-release-7.0-1.el8.noarch.rpm
2、清理缓存并刷新软件源:
dnf clean all && dnf makecache
3、安装Zabbix Agent组件:
dnf install -y zabbix-agent
4、修改主配置文件:
vim /etc/zabbix/zabbix_agentd.conf
5、关键配置项需替换为实际值:
Server=Zabbix服务端IP地址
ServerActive=Zabbix服务端IP地址
Hostname=本机在Zabbix Web中注册的唯一主机名
6、启动并设为开机自启:
systemctl enable --now zabbix-agent
二、离线RPM包手动安装方式
该方式专为无网络连接的生产环境设计,所有依赖需提前打包并校验完整性,避免因缺失libevent、openssl等底层库导致服务启动失败。适用于审计严格、网络隔离的信创场景。
1、在可联网环境下载对应版本RPM包:
wget https://repo.zabbix.com/zabbix/6.4/rhel/8/x86_64/zabbix-agent-6.4.15-1.el8.x86_64.rpm
2、将RPM包及依赖包(如libevent-2.1.8-8.ky10.x86_64.rpm)上传至目标麒麟主机
3、按依赖顺序安装:
rpm -ivh libevent-2.1.8-8.ky10.x86_64.rpm
rpm -ivh zabbix-agent-6.4.15-1.el8.x86_64.rpm
4、检查配置文件权限与属主:
chown root:zabbix /etc/zabbix/zabbix_agentd.conf
chmod 644 /etc/zabbix/zabbix_agentd.conf
5、配置TLS加密通信(可选但推荐):
生成PSK密钥:openssl rand -hex 32 > /etc/zabbix/zabbix_agentd.psk
在zabbix_agentd.conf中添加:
TLSConnect=psk
TLSAccept=psk
TLSPSKFile=/etc/zabbix/zabbix_agentd.psk
TLSPSKIdentity=ClientPSKIdentity
6、重启服务并验证监听状态:
systemctl restart zabbix-agent
ss -tuln | grep :10050
三、Zabbix Agent2(Go语言版)编译安装方式
该方式适用于需扩展插件能力、采集自定义指标或规避C语言Agent内存泄漏风险的高要求场景。Agent2无运行时依赖,编译后二进制文件可跨同构麒麟主机直接复用,符合最小化组件原则。
1、安装Go语言环境(v1.21+):
wget https://go.dev/dl/go1.21.13.linux-amd64.tar.gz
tar -C /usr/local -xzf go1.21.13.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> /etc/profile.d/go.sh
source /etc/profile.d/go.sh
2、创建专用运行用户:
useradd -r -s /sbin/nologin zabbix
3、下载Agent2源码并解压:
wget https://cdn.zabbix.com/zabbix/sources/stable/6.4/zabbix-6.4.15.tar.gz
tar -xf zabbix-6.4.15.tar.gz
4、进入源码目录并编译Agent2:
cd zabbix-6.4.15/src/go/
go build -o /usr/local/bin/zabbix_agent2 ./cmd/zabbix_agent2
5、复制默认配置模板:
cp misc/conf/zabbix_agent2.conf /etc/zabbix/zabbix_agent2.conf
6、编辑配置文件,设置服务端地址与主机名:
sed -i 's/^Server=.*/Server=Zabbix服务端IP地址/g' /etc/zabbix/zabbix_agent2.conf
sed -i 's/^Hostname=.*/Hostname=本机唯一标识/g' /etc/zabbix/zabbix_agent2.conf
7、创建systemd服务单元:
cat > /etc/systemd/system/zabbix-agent2.service [Unit]
Description=Zabbix Agent2
After=network.target
[Service]
Type=simple
User=zabbix
ExecStart=/usr/local/bin/zabbix_agent2 -c /etc/zabbix/zabbix_agent2.conf
Restart=on-failure
[Install]
WantedBy=multi-user.target
EOF
8、加载并启用服务:
systemctl daemon-reload
systemctl enable --now zabbix-agent2










