geonhoyu/zabbix

Zabbix (含Python3) Docker镜像文档

镜像概述

本镜像基于https://github.com/zabbix/zabbix-docker%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%9C%A8%E4%BF%9D%E7%95%99Zabbix%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E7%9A%84%E5%9F%BA%E7%A1%80%E4%B8%8A%EF%BC%8C%E9%A2%9D%E5%A4%96%E9%9B%86%E6%88%90%E4%BA%86Python3%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%B8%BAZabbix%E7%9B%91%E6%8E%A7%E7%B3%BB%E7%BB%9F%E6%8F%90%E4%BE%9BPython%E8%84%9A%E6%9C%AC%E6%89%A7%E8%A1%8C%E8%83%BD%E5%8A%9B%EF%BC%8C%E6%BB%A1%E8%B6%B3%E7%94%A8%E6%88%B7%E9%80%9A%E8%BF%87Python%E6%89%A9%E5%B1%95%E7%9B%91%E6%8E%A7%E5%8A%9F%E8%83%BD%E7%9A%84%E9%9C%80%E6%B1%82%E3%80%82

核心功能与特性

• 继承官方功能：完整保留zabbix-docker项目的全部核心功能，包括Zabbix Server、Agent、Web界面等组件
• Python3支持：内置Python3运行环境，可直接执行Python监控脚本、告警脚本等
• 兼容性保障：与Zabbix官方镜像保持兼容，支持标准Zabbix配置方式

使用场景

• 需要通过Python脚本实现自定义监控项的场景
• 需运行Python编写的Zabbix告警脚本或自动修复脚本的环境
• 基于Python的Zabbix API调用与二次开发需求
• 对Zabbix进行Python扩展开发的测试环境

使用方法与配置说明

基本使用（以Zabbix Server为例）

bash
docker run -d \
  --name zabbix-server-with-python3 \
  -p 10051:10051 \
  -e DB_SERVER_HOST="mysql-server" \
  -e MYSQL_USER="zabbix" \
  -e MYSQL_PASSWORD="zabbix_password" \
  -e MYSQL_DATABASE="zabbix" \
  your-image-name:tag

Docker Compose配置示例

yaml
version: '3'
services:
  zabbix-server:
    image: your-image-name:tag
    ports:
      - "10051:10051"
    environment:
      - DB_SERVER_HOST=mysql
      - MYSQL_USER=zabbix
      - MYSQL_PASSWORD=zabbix_password
      - MYSQL_DATABASE=zabbix
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=zabbix
      - MYSQL_USER=zabbix
      - MYSQL_PASSWORD=zabbix_password
    volumes:
      - mysql-data:/var/lib/mysql
    restart: always

volumes:
  mysql-data:

Python脚本使用说明

1. 将Python脚本放置于容器内的/usr/lib/zabbix/externalscripts/目录
2. 在Zabbix前端配置相应的外部检查项，调用该Python脚本
3. 脚本输出需符合Zabbix监控项数据格式要求

注意事项

• 本镜像基于zabbix-docker项目构建，详细配置参数请参考https://github.com/zabbix/zabbix-docker
• Python3环境已预装，可通过docker exec -it <container_id> python3 --version验证版本
• 如需额外Python依赖包，可通过docker exec进入容器后使用pip3 install安装