统信UOS上可安装Zabbix客户端（zabbix-agent），需先确认系统架构与uos-extra源启用，再通过apt install -y zabbix-agent安装，配置Server、ServerActive、Hostname后启动服务并放行10050端口，最后在Zabbix Web端添加主机并关联模板即可完成监控接入。
在统信UOS桌面或服务器系统上安装Zabbix客户端（zabbix-agent），是为了让本机被远程Zabbix服务端采集指标、执行主动检查或接收指令，必须确保agent与服务端网络连通且配置指向正确的server地址。
确认系统架构与源可用性
打开终端，先确认当前UOS版本及CPU架构：
执行 cat /etc/os-release | grep -E "(VERSION_CODENAME|ID)"，输出应含 ID=uos 和 VERSION_CODENAME=focal 或类似标识；再运行 uname -m，若返回 x86_64 则为标准64位环境。【若显示 aarch64，请勿直接套用x86_64的deb包，需寻找适配ARM的zabbix-agent二进制或源码编译】
检查是否已启用uos-extra源：运行 ls /etc/apt/sources.list.d/uos-extra.list，如无该文件，需手动添加官方扩展仓库，否则 apt 将找不到 zabbix-agent 包。
安装Zabbix Agent（推荐APT方式）
方法一：使用UOS官方仓库（最快捷）
执行 sudo apt update → 确保软件索引刷新成功 → 运行 sudo apt install -y zabbix-agent。这会自动拉取适配UOS 1070e的zabbix-agent 5.0.x版本，并完成基础依赖安装。
方法二：手动下载并安装Debian兼容包（当apt源无zabbix-agent时）
访问Zabbix官网对应页面（https://repo.zabbix.com/zabbix/5.0/debian/pool/main/z/zabbix-agent/），下载后缀为 _amd64.deb 的包（如 zabbix-agent_5.0.39-1+debian10_all.deb）→ 在终端中执行 sudo dpkg -i zabbix-agent_*.deb → 若提示依赖缺失，立即补全：sudo apt --fix-broken install。
配置Agent连接服务端
第一步：编辑主配置文件
运行 sudo vim /etc/zabbix/zabbix_agentd.conf，定位到以下四行并修改：
Server=192.168.26.110 ← 填写Zabbix服务端的真实IP（非localhost）ServerActive=192.168.26.110:10051 ← 启用主动模式时必填，端口默认10051Hostname=web-server-01 ← 必须与Zabbix Web前端添加主机时填写的“Host name”完全一致Include=/etc/zabbix/zabbix_agentd.d/*.conf ← 保持启用，便于后续扩展监控项
第二步：验证配置语法
执行 sudo zabbix_agentd -t agent.ping，若返回 agent.ping [s] 1 表示本地agent进程可响应；若报错，说明配置有误，需逐行检查等号前后空格、IP拼写、Hostname大小写。
第三步：启动并设为开机自启sudo systemctl restart zabbix-agent → sudo systemctl enable zabbix-agent。此时运行 sudo ss -tlnp | grep :10050 应能看到 agent 监听在 10050 端口。
开放本机防火墙端口
UOS默认使用ufw管理防火墙。若服务端需被动连接本机agent（即Server拉取数据），必须放行10050端口：
执行 sudo ufw allow 10050 → sudo ufw reload。【切勿关闭整个ufw，仅开放必要端口；若使用主动模式（ServerActive），此步可跳过】
验证连通性：从Zabbix服务端机器执行 telnet 192.168.26.111 10050（目标为本机IP），能成功建立连接即表示网络层通畅。
在Zabbix Web端添加该主机
登录Zabbix服务端Web界面（如 http://192.168.26.110/zabbix）→ 使用 Admin/zabbix 登录 → 进入「配置」→「主机」→「创建主机」：
填写「主机名称」（必须与agent配置中 Hostname 完全一致）→ 「可见名称」可自定义 → 「群组」选 Templates/Linux → 点击「模板」选项卡 → 搜索并添加「Template OS Linux by Zabbix agent」→ 返回「主机」选项卡 → 在「Agent接口」中填入本机实际IP和端口10050 → 点击「添加」。
约30秒后，该主机状态将变为绿色「已启用」，最新数据开始流入。可在「监测」→「最新数据」中搜索主机名，查看 cpu.usage、system.uptime 等指标是否实时更新。
