# zabbix_modules

**Repository Path**: xtlyk/zabbix_modules

## Basic Information

- **Project Name**: zabbix_modules
- **Description**: zabbix 模块合集，支持 zabbix 6/7/8
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 14
- **Forks**: 8
- **Created**: 2025-09-17
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Zabbix Modules 集合

[English](README_en.md)

## ✨ 版本兼容性

所有模块均兼容 Zabbix 6.0 / 7.0+ / 8.0+ 版本。

- ✅ Zabbix 6.0.x
- ✅ Zabbix 7.0.x
- ✅ Zabbix 7.4.x
- ✅ Zabbix 8.0.x

## 描述

这是一个包含多个Zabbix模块的项目集合，每个模块都是独立的，为Zabbix监控系统提供额外的功能。

## 模块列表

### 1. Zabbix Reports

**简介**：用于生成每日、周、月报表的Zabbix前端模块，支持报表预览、PDF导出和邮件推送功能。

**功能特性**：

- 支持每日、周、月报表生成
- 报警数量和状态统计
- 显示报警最多的主机（前10名）
- 显示CPU和内存使用率最高的主机（前10名）
- 页面预览报表
- 手动导出PDF
- 邮件推送报表（HTML格式）

![1](zabbix_reports/images/1.png)
![2](zabbix_reports/images/2.png)

**文档链接**：[zabbix_reports/README.md](./zabbix_reports/README.md)

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

### 2. Zabbix CMDB

**简介**：用于配置管理数据库（CMDB）的Zabbix前端模块，提供主机信息的集中查看和管理功能。

**功能特性**：

- 支持通过主机名或IP地址进行搜索
- 支持按主机分组进行筛选
- 显示主机名、IP地址、接口方式、CPU总量、内存总量、主机分组等信息
- 支持中英文界面国际化
- 响应式设计，适配不同屏幕尺寸

![1](zabbix_cmdb/images/1.jpg)
![2](zabbix_cmdb/images/2.png)
![3](zabbix_cmdb/images/3.jpg)

**文档链接**：[zabbix_cmdb/README.md](./zabbix_cmdb/README.md)

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

### 3. Zabbix Graph Trees

**简介**：用于以树形结构浏览监控数据的Zabbix前端模块，提供主机分组树形导航、监控项筛选和实时图表展示功能。

**功能特性**：

- 树形结构浏览主机分组和主机
- 支持按标记（Tag）和标记值筛选监控项
- 监控项多选下拉框，灵活选择要展示的图表
- SVG折线图实时展示监控数据
- 多图表tooltip同步显示
- 图表放大全屏查看
- 自动刷新功能（支持5/10/20/30/60秒间隔）
- 多种时间范围选择（1小时至30天）
- 支持中英文界面国际化

![1](zabbix_graphtrees/images/1.png)
![2](zabbix_graphtrees/images/2.png)

**文档链接**：[zabbix_graphtrees/README.md](./zabbix_graphtrees/README.md)

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

### 4. Zabbix Rack

**简介**：用于数据中心机柜可视化和主机位置管理的Zabbix前端模块，支持机房和机柜的配置，以及主机的可视化分配。

**功能特性**：

- 机房管理：创建、编辑、删除机房
- 机柜管理：创建、编辑、删除机柜，支持1-60U高度配置
- 机柜可视化：42U机柜垂直布局，U位占用状态显示
- 主机分配：将Zabbix主机分配到机柜指定U位
- 搜索功能：按机柜或主机名称搜索
- 支持中英文界面国际化
- 响应式设计，适配不同屏幕尺寸

![1](zabbix_rack/images/1.png)
![2](zabbix_rack/images/2.png)
![3](zabbix_rack/images/3.png)

**文档链接**：[zabbix_rack/README.md](./zabbix_rack/README.md)

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

### 5. Zabbix SNMP

**简介**：SNMP 辅助助手 Zabbix 前端模块，提供 MIB 浏览和 SNMP Walk 功能，支持解析 OID、一键创建监控项和批量创建 SNMP 模板。

**功能特性**：

- MIB 浏览：自动扫描常见 MIB 目录，表格展示对象的 OID、解析 OID、语法/权限/状态，支持查看源码
- SNMP Walk：自动读取主机 SNMP 连接参数（v1/v2c/v3），将结果解析为表格并支持客户端分页
- 查看原数据、复制 snmpget 命令 / OID
- 选中单条结果一键创建监控项（自动映射数据类型）
- 勾选多条结果批量创建 SNMP 模板及监控项
- 支持中英文界面国际化

![1](zabbix_snmp/images/1.png)
![2](zabbix_snmp/images/2.png)
![3](zabbix_snmp/images/3.png)

**文档链接**：[zabbix_snmp/README.md](./zabbix_snmp/README.md)

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

### 6. Zabbix JumpServer

**简介**：用于将 Zabbix 主机和主机分组同步到 JumpServer 堡垒机的 Zabbix 前端模块，支持批量推送、自动创建节点，并可从 Zabbix 一键跳转连接主机。

**功能特性**：

- 顶部主机分组、主机、告警状态下拉框及 IP/主机名搜索，默认展示所有分组和主机
- 一键「推送所有主机组」「推送所有主机」，缺失的 JumpServer 节点自动创建
- 「获取 JumpServer 资产 ID」：从 JumpServer 按 IP 反向匹配并写回资产 ID 标记
- 自动识别主机平台（Linux / Windows），创建或更新 JumpServer 资产；创建时可按账号模板自动关联登录账号
- 告警状态列按严重度显示数量，行可展开查看全部告警明细
- JumpServer 资产 ID 以标记形式写回 Zabbix 主机；已推送主机悬停可重新推送
- 表格最后一列「连接」按钮，一键跳转到 JumpServer 主机连接页面
- 支持中英文界面国际化

![1](zabbix_jumpserver/images/1.png)

**文档链接**：[zabbix_jumpserver/README.md](./zabbix_jumpserver/README.md)

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

### 7. IM同步助手

**简介**：将**企业微信**、**飞书**、**钉钉**的组织架构同步到 Zabbix **用户组**，并将 IM 成员匹配或创建为 Zabbix 用户、加入对应用户组的 Zabbix 前端模块。

![1](zabbix_im/images/1.png)
![2](zabbix_im/images/2.png)
![3](zabbix_im/images/3.png)

**功能特性**：

- 多平台支持：企业微信（WeCom）、飞书（Feishu）、钉钉（DingTalk）
- Web 界面管理同步凭据（**Users → 同步设置**），同一时间仅启用一套配置
- 部门同步：按 IM 部门创建/更新 Zabbix 用户组，可选完整路径命名
- 用户同步：匹配或自动创建 Zabbix 用户并加入用户组；新用户密码自动生成（12 位）并在结果中展示一次
- 钉钉用户：无手机号时自动将姓名转为拼音作为 Zabbix 用户名
- 预览模式：同步前预览部门与用户匹配情况
- 支持中英文界面国际化

**文档链接**：[zabbix_im/README.md](./zabbix_im/README.md)（[English](./zabbix_im/README_en.md)）

**兼容性**：Zabbix 6.0.x, 7.0.x, 7.4.x, 8.0.x

## 安装说明

### 安装模块

这是最简单快捷的安装方式，一次性部署所有模块：

1. **Zabbix 6.0 / 7.0 部署方法**

```bash
git clone https://github.com/X-Mars/zabbix_modules.git /usr/share/zabbix/modules/
```

2. **Zabbix 7.4 / 8.0 部署方法**

```bash
git clone https://github.com/X-Mars/zabbix_modules.git /usr/share/zabbix/ui/modules/
```

3. **如果使用Zabbix 6.0，修改manifest_version**

```bash
cd /usr/share/zabbix/modules/
# 修改 zabbix_reports 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_reports/manifest.json

# 修改 zabbix_cmdb 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_cmdb/manifest.json

# 修改 zabbix_graphtrees 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_graphtrees/manifest.json

# 修改 zabbix_rack 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_rack/manifest.json

# 修改 zabbix_snmp 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_snmp/manifest.json

# 修改 zabbix_jumpserver 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_jumpserver/manifest.json

# 修改 zabbix_im 模块
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' zabbix_im/manifest.json
```

如果使用 Zabbix 7.0+ 或 8.0+，则无需修改，保持默认值即可。

### 启用模块

完成文件部署后，在Zabbix Web界面中启用模块：

1. 进入Zabbix Web界面
2. 导航到 **Administration → General → Modules**
3. 点击 **Scan directory** 扫描新模块
4. 找到并启用相应模块

![1](images/setting-1.png)
![2](images/setting-2.png)

### 验证安装

刷新页面后，您将在相应菜单中看到新模块：

- **Reports → Zabbix Reports** (每日/周/月报表)
- **Inventory → CMDB** (主机列表/主机分组)
- **Monitoring → Graph Trees** (图表树)
- **Inventory → Rack Management** (机柜管理)
- **数据采集 → SNMP Assistant** (SNMP 助手：Zabbix Mibs / Zabbix Walk)
- **资产记录 → JumpServer** (JumpServer 同步)
- **Users → IM同步助手** (IM 同步 / 同步设置)

### 单独安装模块

每个模块都有独立的安装说明，请参考各模块的README.md文件获取详细的安装和配置步骤。

## 贡献

欢迎提交问题报告和功能改进建议。请在相应模块的目录下提交问题。

## 许可证

所有模块遵循Zabbix的许可证条款。详情请见 [Zabbix许可证](https://www.zabbix.com/license)。