# zabbix_modules

**Repository Path**: SRIM/zabbix_modules

## Basic Information

- **Project Name**: zabbix_modules
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-07-23

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

### 8. Zabbix Clonehosts

**简介**：基于已有监控主机的配置批量克隆导入大量主机的 Zabbix 前端模块，支持 CSV 文件导入和在线表格录入两种方式，并提供预览、冲突检测、选择性导入和实时导入进度反馈功能。

**功能特性**：

- 源主机克隆：选择任意已有监控主机作为克隆模板，其接口、群组、模板、标签、宏、TLS、IPMI、资产模式等全部配置均可被继承
- 双模式数据录入：CSV 文件上传（UTF-8/GBK 自动识别，可下载模板）/ 在线表格录入（增删行、清空、实时校验）
- 智能字段继承：仅主机名称和接口 IP 必填，其他字段留空时自动继承源主机配置
- 主机群组自动创建：CSV 中指定的主机群组若不存在，自动调用 API 创建后再关联
- 预览与冲突检测：导入前全面预览，自动检测主机名冲突、必填字段缺失、批次内重复、与已有主机/模板同名冲突；状态标识区分「已存在」「将新建」「未找到」「继承自源主机」
- 选择性导入：预览页支持勾选/取消要导入的主机，冲突主机自动跳过，就绪主机可单独取消导入
- 返回编辑：预览页可一键带着数据返回在线表格录入页，方便对非就绪主机进行编辑，不会清空已录入数据
- 导入进度反馈：逐台 AJAX 创建主机，实时进度条和成功/失败计数
- 结果报告导出：导入完成后可下载 CSV 格式的结果报告（含主机名、IP、主机ID、结果、错误信息）
- 支持中英文界面国际化

![1](zabbix_clonehosts/images/image.png)
![2](zabbix_clonehosts/images/image-1.png)
![3](zabbix_clonehosts/images/image-2.png)
![4](zabbix_clonehosts/images/image-3.png)

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

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

## 安装说明

### 方式一：下载 Releases 压缩包（适合生产部署，按需选择）

Releases 页面提供两种压缩包，无需安装 git：

- **整体打包压缩包**：`zabbix_modules-<版本号>.tar.gz`（包含所有模块，版本号格式：`模块数量.大版本.小版本`，如 `8.2.0`）
- **单模块压缩包**：`zabbix_<模块名>-<版本号>.tar.gz`（按需下载单个模块）

#### 选项 A：下载所有模块整体压缩包

1. 前往 [Releases 页面](https://github.com/X-Mars/zabbix_modules/releases)，下载 `zabbix_modules-<版本号>.tar.gz` 文件（如 `zabbix_modules-8.2.0.tar.gz`）
2. 上传到 Zabbix 服务器并解压到模块目录：

```bash
# Zabbix 6.0 / 7.0
tar -xzf zabbix_modules-<版本号>.tar.gz -C /usr/share/zabbix/modules/

# Zabbix 7.2+ / 7.4 / 8.0
tar -xzf zabbix_modules-<版本号>.tar.gz -C /usr/share/zabbix/ui/modules/
```

3. **如果使用 Zabbix 6.0，修改所有模块的 manifest_version**

```bash
for mod in /usr/share/zabbix/modules/zabbix_*/; do
  sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' ${mod}manifest.json
done
```

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

#### 选项 B：下载单个模块

1. 前往 [Releases 页面](https://github.com/X-Mars/zabbix_modules/releases)，下载所需模块的 `zabbix_<模块名>-<版本号>.tar.gz` 文件
2. 上传到 Zabbix 服务器并解压到模块目录：

```bash
# Zabbix 6.0 / 7.0
tar -xzf zabbix_<模块名>-<版本号>.tar.gz -C /usr/share/zabbix/modules/

# Zabbix 7.2+ / 7.4 / 8.0
tar -xzf zabbix_<模块名>-<版本号>.tar.gz -C /usr/share/zabbix/ui/modules/
```

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

```bash
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' /usr/share/zabbix/modules/zabbix_<模块名>/manifest.json
```

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

### 方式二：git clone 直接部署（适合开发/跟踪更新）

一次性部署所有模块：

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

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

2. **Zabbix 7.2+ / 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
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' /usr/share/zabbix/modules/zabbix_*/manifest.json
```

单独修改某个模块（如 zabbix_reports）：

```bash
sed -i 's/"manifest_version": 2.0/"manifest_version": 1.0/' /usr/share/zabbix/modules/zabbix_reports/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)。