Zabbix Agent 部署在被監控的 Linux 主機上,主動/被動收集系統指標 (CPU、記憶體、磁碟、網路、進程、日誌等) 並發送給 Zabbix Server/Proxy。本文覆蓋 **Zabbix 6.0/7.0 LTS** 在主流發行版 (RHEL/CentOS/Rocky/AlmaLinux, Debian/Ubuntu, SUSE) 上的**標準化安裝、配置、安全加固、自動註冊、TLS 加密、常見問題排查**全流程。
zabbix 運行 Agent (套件安裝通常自動創建)。# 1. 配置 Zabbix 官方倉庫 (以 Zabbix 7.0 LTS 為例)
rpm -Uvh https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/zabbix-release-7.0-1.el9.noarch.rpm
# 或 CentOS 7: .../zabbix/7.0/rhel/7/x86_64/zabbix-release-7.0-1.el7.noarch.rpm
# 清理快取並安裝
dnf clean all
dnf install -y zabbix-agent zabbix-sender zabbix-get # zabbix-sender/get 用於測試
# 1. 下載並安裝釋放包 (以 Ubuntu 22.04 Jammy, Zabbix 7.0 為例)
wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_7.0-1+ubuntu22.04_all.deb
dpkg -i zabbix-release_7.0-1+ubuntu22.04_all.deb
apt update
# 2. 安裝
apt install -y zabbix-agent zabbix-sender zabbix-get
# 添加倉庫並安裝 (按實際版本調整 URL)
zypper addrepo https://repo.zabbix.com/zabbix/7.0/sles/15/x86_64/zabbix-release-7.0-1.sles15.noarch.rpm
zypper refresh
zypper install zabbix-agent zabbix-sender zabbix-get
zabbix_agent-7.0.1-linux-4.0.0-amd64-static.tar.gz)。tar -xzf zabbix_agent-*.tar.gz -C /opt/。useradd -r -s /sbin/nologin zabbixmkdir -p /etc/zabbix /var/log/zabbix /var/run/zabbixchown zabbix:zabbix /var/log/zabbix /var/run/zabbix/etc/zabbix/zabbix_agentd.conf (見下文配置)。/etc/systemd/system/zabbix-agent.service (參考官方模板)。systemctl daemon-reload && systemctl enable --now zabbix-agent。關鍵參數 (必須修改/檢查):
# === 連接配置 ===
Server=10.0.0.100 # Zabbix Server/Proxy IP,被動模式允許的來源 (逗號分隔多個)
ServerActive=10.0.0.100 # Zabbix Server/Proxy IP:Port,主動模式發送數據目標 (支援域名、多地址逗號分隔)
ListenPort=10050 # Agent 監聽端口 (被動模式),建議修改非默認端口增強安全
ListenIP=0.0.0.0 # 監聽地址 (0.0.0.0 監聽所有介面,或指定內網 IP)
# === 主機標識 (關鍵:必須與 Zabbix 前端主機名完全一致) ===
Hostname=web-01-prod # 唯一主機名,區分大小寫,建議使用 FQDN 或規範命名
# HostnameItem=system.hostname # 可選:自動獲取系統主機名作為 Hostname (需系統 hostname 正確)
# === 主動模式優化 (推薦大規模/高延遲/NAT 環境啟用) ===
StartAgents=3 # 被動模式預啟動進程數 (0 純主動模式)
RefreshActiveChecks=60 # 主動檢查列表刷新間隔 (秒)
BufferSend=5 # 數據緩衝發送間隔 (秒)
BufferSize=100 # 緩衝區大小 (值)
MaxLinesPerSecond=100 # 日誌監控每秒最大行數
# === 安全加固 (生產環境強烈建議啟用 TLS PSK) ===
# TLSConnect=psk # 主動模式連接 Server 使用 PSK
# TLSAccept=psk # 被動模式接受 Server 連接使用 PSK
# TLSPSKIdentity=web-01-prod # PSK 身份標識 (需與 Server 端配置一致)
# TLSPSKFile=/etc/zabbix/zabbix_agentd.psk # PSK 密鑰文件路徑 (64 位十六進制字符串)
# === 進階功能啟用 ===
AllowRoot=0 # 禁止 root 運行 (安全)
User=zabbix # 運行用戶 (套件安裝自動配置)
EnableRemoteCommands=0 # 禁用遠端命令執行 (高風險,慎開)
UnsafeUserParameters=0 # 禁用不安全 UserParameter 語法
Include=/etc/zabbix/zabbix_agentd.d/*.conf # 載入自定義監控配置目錄
# === 日誌與調試 ===
LogFile=/var/log/zabbix/zabbix_agentd.log
LogFileSize=10 # MB
DebugLevel=3 # 3=警告, 4=調試 (排查時臨時調 4)
Timeout=30 # 處理請求超時 (秒)
# 生成 256-bit (64 字符) PSK
openssl rand -hex 32 | sudo tee /etc/zabbix/zabbix_agentd.psk
sudo chown zabbix:zabbix /etc/zabbix/zabbix_agentd.psk
sudo chmod 400 /etc/zabbix/zabbix_agentd.psk
# 將 PSK 字符串與 Identity (Hostname) 在 Zabbix Server 前端「主機」→「加密」頁配置一致
| 防火牆工具 | 命令 (允許 Server IP 訪問 Agent 10050,Agent 訪問 Server 10051) |
|---|---|
| firewalld (RHEL 7+/CentOS 7+) | firewall-cmd --permanent --add-rich-rule='rule family="ipv4" source address="10.0.0.100" port port="10050" protocol="tcp" accept' |
| iptables/nftables | iptables -A INPUT -s 10.0.0.100 -p tcp --dport 10050 -j ACCEPT保存規則 (iptables-save > /etc/sysconfig/iptables 等) |
| ufw (Ubuntu/Debian) | ufw allow from 10.0.0.100 to any port 10050 proto tcp |
# 1. 啟動並設開機自啟
systemctl enable --now zabbix-agent
systemctl status zabbix-agent # 確認 active (running)
# 2. 本地測試 Agent 響應 (被動模式)
zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.util[,idle]"
zabbix_get -s 127.0.0.1 -p 10050 -k "agent.version"
zabbix_get -s 127.0.0.1 -p 10050 -k "system.uname"
# 3. 測試主動發送數據給 Server
zabbix_sender -z 10.0.0.100 -p 10051 -s "web-01-prod" -k "test.key" -o "test_value"
# Server 前端「最新數據」應看到 test.key 收到值
# 4. 自動註冊 (Auto-registration) - 免去前端手動添加主機
# 前提:Server 前端「管理」→「一般」→「自動註冊」啟用,配置動作 (Action) 關聯模板/主機群組
# Agent 配置:
# ServerActive=10.0.0.100
# Hostname=web-01-prod # 或 HostnameItem=system.hostname
# HostMetadata=linux_web_prod # 可選元數據,用於動作條件匹配
# 重啟 Agent 即自動向 Server 註冊
在 /etc/zabbix/zabbix_agentd.d/ 創建 .conf 文件定義自定義鍵值:
# /etc/zabbix/zabbix_agentd.d/nginx.conf
UserParameter=nginx.active,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk '/Active connections/{print $$3}'
UserParameter=nginx.reading,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk '/Reading/{print $$2}'
UserParameter=nginx.writing,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk '/Writing/{print $$4}'
UserParameter=nginx.waiting,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk '/Waiting/{print $$6}'
UserParameter=nginx.accepts,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk 'NR==3{print $$1}'
UserParameter=nginx.handled,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk 'NR==3{print $$2}'
UserParameter=nginx.requests,/usr/bin/curl -s https://127.0.0.1/nginx_status | awk 'NR==3{print $$3}'
# /etc/zabbix/zabbix_agentd.d/mysql.conf
UserParameter=mysql.ping,mysqladmin -u zabbix_mon -p\$PASSWORD ping 2>/dev/null | grep -c alive
UserParameter=mysql.uptime,mysql -u zabbix_mon -p\$PASSWORD -e "SHOW GLOBAL STATUS LIKE 'Uptime'" -sN 2>/dev/null | awk '{print $$2}'
UserParameter=mysql.threads_connected,mysql -u zabbix_mon -p\$PASSWORD -e "SHOW GLOBAL STATUS LIKE 'Threads_connected'" -sN 2>/dev/null | awk '{print $$2}'
UserParameter=mysql.queries,mysql -u zabbix_mon -p\$PASSWORD -e "SHOW GLOBAL STATUS LIKE 'Questions'" -sN 2>/dev/null | awk '{print $$2}'
UserParameter=mysql.slow_queries,mysql -u zabbix_mon -p\$PASSWORD -e "SHOW GLOBAL STATUS LIKE 'Slow_queries'" -sN 2>/dev/null | awk '{print $$2}'
# 注意:密碼含特殊字符需轉義,建議使用 .my.cnf [client] 區段存密碼,命令簡化為 mysql -u zabbix_mon -e ...
# /etc/zabbix/zabbix_agentd.d/disk_io.conf
UserParameter=disk.io.util[*],iostat -x 1 2 | awk '/^$$1/ {print $$NF}' # 參數為設備名如 sda
UserParameter=disk.io.read_kbs[*],iostat -x 1 2 | awk '/^$$1/ {print $$6}'
UserParameter=disk.io.write_kbs[*],iostat -x 1 2 | awk '/^$$1/ {print $$7}'
添加後 systemctl restart zabbix-agent,Server 端即可創建監控項使用這些 Key (如 nginx.active, disk.io.util[sda])。
| 現象 | 排查步驟 |
|---|---|
| Server 前端顯示主機「Zabbix agent unreachable」 | 1. Agent 服務運行? systemctl status zabbix-agent2. 防火牆放行 10050? 雙向網路通? 3. zabbix_get -s Agent_IP -p 10050 -k "agent.ping" 從 Server 手動測試4. Agent 配置 Server= 包含 Server IP? ListenIP 正確?5. SELinux 阻擋? setsebool -P zabbix_can_network 1 或檢查 audit.log |
| 主動模式數據不上報 | 1. ServerActive IP:Port 正確?2. Hostname 與前端主機名**完全一致** (含大小寫)?3. zabbix_sender 手動測試能否發送?4. Agent 日誌 /var/log/zabbix/zabbix_agentd.log 看錯誤 (如 TLS 不匹配、Buffer 滿、Server 拒絕)。 |
| 自定義 UserParameter 無數據/報錯 | 1. 命令路徑絕對路徑? 依賴環境變數? (建議寫腳本放 /usr/local/bin/ 用絕對路徑調用) 2. 執行超時? ( Timeout 參數、命令本身慢)3. 權限不足? (zabbix 用戶能執行命令/讀取文件? sudoers 配置?)4. 輸出格式? (僅輸出值、換行結尾、無額外文本) |
| TLS PSK 連接失敗 | 1. Agent/Server 双方 TLSPSKIdentity 字符串**完全一致**?2. TLSPSKFile 內容 64 位十六進制字符串一致? 文件權限 400 屬主 zabbix?3. Agent 配置 TLSConnect=psk (主動)、TLSAccept=psk (被動) 正確?4. Server 前端主機「加密」頁 PSK Identity/Value 填寫正確? |
dnf/apt update 獲取安全更新。ServerActive),減輕 Server 輪詢壓力,適應 NAT/雲環境。Hostname (如 {角色}-{環境}-{序號}),配合自動註冊實現零接觸納管。zabbix 用戶、禁用 EnableRemoteCommands、UnsafeUserParameters、限制防火牆來源 IP。/etc/zabbix/zabbix_agentd.d/*.conf,便於 Ansible/Salt 批量分發管理。zabbix[agent,version], zabbix[agent,uptime], zabbix[buffer,usage] 納入監控。遵循本指南部署 Zabbix Agent,可構建**安全、高效、可擴展、易維護**的企業級監控採集層,為 Zabbix Server 提供高質量的原始監控數據。