萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 系統 Zabbix Agent 客戶端安裝配置全攻略 (Zabbix 6.0/7.0 LTS)

Zabbix Agent 部署在被監控的 Linux 主機上,主動/被動收集系統指標 (CPU、記憶體、磁碟、網路、進程、日誌等) 並發送給 Zabbix Server/Proxy。本文覆蓋 **Zabbix 6.0/7.0 LTS** 在主流發行版 (RHEL/CentOS/Rocky/AlmaLinux, Debian/Ubuntu, SUSE) 上的**標準化安裝、配置、安全加固、自動註冊、TLS 加密、常見問題排查**全流程。

安裝前準備

  • 確認 Zabbix Server/Proxy 版本 (Agent 版本需與 Server 主版本一致,如 6.0 Agent 對應 6.0 Server)。
  • 被監控主機可訪問 Server/Proxy 端口 (預設 10051);Server/Proxy 可訪問 Agent 端口 (預設 10050) (被動模式)。
  • 建議創建專用低權限用戶 zabbix 運行 Agent (套件安裝通常自動創建)。

第一步:安裝 Zabbix Agent (官方倉庫推薦)

RHEL / CentOS / Rocky / AlmaLinux / Fedora

# 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 用於測試

Debian / Ubuntu

# 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

SUSE / openSUSE

# 添加倉庫並安裝 (按實際版本調整 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

通用:二進制包手動安裝 (無網/特定版本/容器化)

  1. 下載 Zabbix Agent 靜態編譯二進制包 (如 zabbix_agent-7.0.1-linux-4.0.0-amd64-static.tar.gz)。
  2. 解壓:tar -xzf zabbix_agent-*.tar.gz -C /opt/。
  3. 創建用戶/目錄/配置:
    useradd -r -s /sbin/nologin zabbix
    mkdir -p /etc/zabbix /var/log/zabbix /var/run/zabbix
    chown zabbix:zabbix /var/log/zabbix /var/run/zabbix
  4. 編寫 /etc/zabbix/zabbix_agentd.conf (見下文配置)。
  5. 創建 Systemd 服務文件 /etc/systemd/system/zabbix-agent.service (參考官方模板)。
  6. systemctl daemon-reload && systemctl enable --now zabbix-agent。

第二步:核心配置文件詳解 (/etc/zabbix/zabbix_agentd.conf)

關鍵參數 (必須修改/檢查):

# === 連接配置 ===
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                  # 處理請求超時 (秒)

生成 PSK 密鑰 (若啟用 TLS)

# 生成 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'
firewall-cmd --permanent --add-port=10051/tcp # 若 Agent 需主動連 Server (通常 Server 在防火牆外無需此規則)
firewall-cmd --reload
iptables/nftablesiptables -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 註冊

第五步:自定義監控項 (UserParameter) 實戰

在 /etc/zabbix/zabbix_agentd.d/ 創建 .conf 文件定義自定義鍵值:

範例 1:監控 Nginx 狀態 (需 Nginx stub_status 模組)

# /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}'

範例 2:監控 MySQL/MariaDB (需 .my.cnf 配置免密登入)

# /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 ...

範例 3:監控磁碟 IO (iostat)

# /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-agent
2. 防火牆放行 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/雲環境。
  • ✅ **啟用 TLS PSK 加密** 保護監控數據傳輸機密性完整性 (內網亦建議)。
  • ✅ **統一命名規範** Hostname (如 {角色}-{環境}-{序號}),配合自動註冊實現零接觸納管。
  • ✅ **最小權限**:專用 zabbix 用戶、禁用 EnableRemoteCommands、UnsafeUserParameters、限制防火牆來源 IP。
  • ✅ **模組化配置**:自定義監控放 /etc/zabbix/zabbix_agentd.d/*.conf,便於 Ansible/Salt 批量分發管理。
  • ✅ **監控 Agent 自身**:zabbix[agent,version], zabbix[agent,uptime], zabbix[buffer,usage] 納入監控。

遵循本指南部署 Zabbix Agent,可構建**安全、高效、可擴展、易維護**的企業級監控採集層,為 Zabbix Server 提供高質量的原始監控數據。

copyright © 萬盛學電腦網 all rights reserved