麒麟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
