Установка Zabbix агента на Ubuntu/Debian 12: пошаговая инструкция | AdminWiki

Установка Zabbix агента на Ubuntu и Debian: подробное руководство для DevOps

18 декабря 2025 5 мин. чтения #Debian 12 #debian #devops #linux #ubuntu #zabbix #zabbix agent #мониторинг

Представь, что ты хочешь мониторить свой сервер — следить за загрузкой CPU, использованием памяти, дисковым пространством. Zabbix — мощная система мониторинга, но чтобы она «видела» твой сервер, на него нужно установить специальную программу — агент. Давай разберем, как правильно выполнить установку Zabbix агента на Ubuntu и Debian, включая актуальную версию Debian 12.

Zabbix агент — это легковесная программа, которая работает на наблюдаемом хосте, собирает метрики и отправляет их на Zabbix сервер. Он необходим для мониторинга любых внутренних параметров системы.

Подготовка к установке Zabbix агента

Перед началом убедись, что у тебя есть:

  • Доступ к серверу с правами sudo или root.
  • IP-адрес или доменное имя твоего Zabbix сервера.
  • Стабильное интернет-соединение для загрузки пакетов.

Шаг 1: Добавление репозитория Zabbix

Официальные пакеты Zabbix не всегда есть в стандартных репозиториях. Добавим репозиторий, чтобы установить актуальную версию. Процесс для Ubuntu и Debian очень похож.

bash
# Обновляем список пакетов
sudo apt update

# Устанавливаем зависимости
sudo apt install -y wget gnupg2

# Скачиваем и устанавливаем ключ репозитория Zabbix
wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-5+ubuntu22.04_all.deb
sudo dpkg -i zabbix-release_6.0-5+ubuntu22.04_all.deb

# Еще раз обновляем кэш пакетов
sudo apt update
Внимание для Debian 12: Если ты используешь Debian 12 «Bookworm», в команде wget замени «ubuntu» на «debian» и укажи версию дистрибутива: zabbix-release_6.0-5+debian12_all.deb. Аналогично для других версий Ubuntu/Debian — проверяй соответствие на официальном сайте.

Шаг 2: Установка Zabbix агента

Теперь установим сам пакет агента. Он называется zabbix-agent2 (современная версия с поддержкой плагинов) или классический zabbix-agent.

bash
# Установка Zabbix Agent 2 (рекомендуется)
sudo apt install -y zabbix-agent2 zabbix-agent2-plugin-

# ИЛИ установка классического Zabbix Agent
# sudo apt install -y zabbix-agent

В чем разница между агентами?

Параметр Zabbix Agent 2 Zabbix Agent
Архитектура Многопоточный, плагины Однопоточный
Гибкость Выше (поддержка Go-плагинов) Стандартная
Рекомендация Для новых систем Для совместимости

Шаг 3: Настройка конфигурации агента

Ключевой этап — указать агенту, куда отправлять данные. Основной конфиг находится в /etc/zabbix/zabbix_agent2.conf (или zabbix_agentd.conf для классического агента).

bash
# Открываем конфиг для редактирования
sudo nano /etc/zabbix/zabbix_agent2.conf

Найди и измени следующие параметры:

config
# Адрес Zabbix сервера (активные проверки)
Server=192.168.1.100
# Адрес для пассивных проверок (можно указать несколько через запятую)
ServerActive=192.168.1.100
# Имя хоста, как он будет отображаться в Zabbix
Hostname=My-Ubuntu-Server
# Включить удаленные команды (0 - выкл, 1 - вкл, осторожно!)
EnableRemoteCommands=0
# Файл для логов
LogFile=/var/log/zabbix/zabbix_agent2.log
# Уровень логирования (0-5, где 0 - отладка)
LogFileSize=0
DebugLevel=3
Важно: Параметр Hostname должен точно совпадать с именем хоста, которое ты укажешь при создании узла в веб-интерфейсе Zabbix сервера. Это ключ для связи.

Шаг 4: Запуск и добавление в автозагрузку

После настройки запустим агент и убедимся, что он запускается автоматически при загрузке системы.

bash
# Перезапускаем службу (или start, если запускаем впервые)
sudo systemctl restart zabbix-agent2

# Проверяем статус службы
sudo systemctl status zabbix-agent2

# Добавляем в автозагрузку
sudo systemctl enable zabbix-agent2

Шаг 5: Проверка работы и настройка фаервола

Агент по умолчанию слушает порт 10050. Нужно открыть его на фаерволе, если он активен.

bash
# Если используешь ufw (Ubuntu)
sudo ufw allow 10050/tcp
sudo ufw reload

# Если используешь iptables
sudo iptables -A INPUT -p tcp --dport 10050 -j ACCEPT

# Проверяем, что процесс слушает порт
ss -tlnp | grep 10050
# или
netstat -tlnp | grep zabbix

Тестовая проверка с Zabbix сервера

С Zabbix сервера можно выполнить простую проверку, запросив у агента какую-либо метрику, например, системное время.

bash
# Выполняем на Zabbix сервере
zabbix_get -s 192.168.1.150 -p 10050 -k "system.localtime"
# Замени 192.168.1.150 на IP-адрес твоего агента
# Успешный ответ: Unix timestamp

Частые проблемы и их решение

  • Агент не запускается: Проверь конфиг на ошибки: sudo zabbix_agent2 -t (проверка конфигурации). Смотри логи: sudo journalctl -u zabbix-agent2 -f.
  • Zabbix сервер не видит агент: Убедись, что на хосте открыт порт 10050 и нет блокировок по сети (firewall, security groups). Проверь совпадение Hostname в конфиге и в веб-интерфейсе.
  • Ошибки с репозиторием в Debian 12: Убедись, что скачал правильный пакет zabbix-release для своей версии ОС.

Заключение

Ты успешно установил Zabbix агент на Ubuntu или Debian. Теперь этот хост готов к добавлению в систему мониторинга Zabbix. Основные этапы: добавление репозитория, установка пакета, тонкая настройка конфигурации под твою сеть, открытие порта и проверка связи. Для Debian 12 процесс практически идентичен, за исключением имени пакета репозитория.

Дальнейшие шаги — добавление узла через веб-интерфейс Zabbix сервера, настройка шаблонов мониторинга и создание триггеров с уведомлениями. Удачи в построении отказоустойчивой инфраструктуры!

Поделиться:
Сохранить гайд? В закладки браузера