zbxtable 3.0.5
ZbxTable 是一个开源的 Zabbix 报表系统.本次主要更新ZbxTable 前后端程序版本到 3.0.5 版本,修复上个版本出现的几个严重 Bug,建议尽快更新.
版本概览
- 设备分组(Asset Group)能力:新增设备分组前后端模型与接口,支持对设备进行更细粒度的逻辑组织。
- 自定义设备类型与动态菜单:基于设备分组与设备类型动态生成导航菜单,突破原有内置类型与硬编码菜单的限制。
- 统一设备入口(设备管理 / 设备树):将顶级菜单重构为「设备管理」父容器,新增「设备树」承载统一设备浏览,收敛历史分散的主机 / 网络 / 硬件列表入口。
- 通用设备页面:新增通用设备列表页(
GenericDeviceList)与通用设备详情页,统一承载内置及自定义设备类型的展示。 - 列表字段配置能力:支持按设备类型自定义列表展示字段(字段勾选、列头重命名、排序与可见性控制)。
- 报表与导出增强:完善主机报表数据处理、Excel 导出链路及定时任务与日报类数据处理逻辑。
- 系统交互细节修复:修复登录跳转后页面标题更新异常、控制台报错,并优化搜索、路由映射、国际化与权限判断等细节。
设备管理体系重构
在此前版本中,主机管理、网络管理、硬件管理等设备列表入口较为分散,且系统仅支持 6 种内置设备类型(Linux 虚机、Windows 虚机、网络设备、服务器、光纤设备、存储设备),菜单与路由均为硬编码方式,用户即便创建了自定义类型也无法在导航菜单中呈现。
v3.0.5 版本针对上述问题进行了如下优化:
- 顶级菜单重构为「设备管理」父容器,将原「主机管理 / 网络管理 / 硬件管理」的列表统一并入,仅保留各设备详情路由,菜单结构更清晰。
- 系统管理下统一为「设备配置」入口,整合「设备分组 / 设备类型 / 设备绑定」三个标签页,收敛配置路径,降低使用与维护成本。
- 新增设备分组(Asset Group)模型,内置「主机管理 / 网络管理 / 硬件管理」三类基础分组,并支持用户自定义分组;内置分组不可删除,保障系统结构稳定。
- 拆分设备类型主列表、字段配置抽屉、弹窗表单等组件,使前端结构更清晰,便于后续迭代扩展。
说明:历史菜单「资产管理 → 资产设置」已统一更名为「设备配置」,「资产树」更名为「设备树」,「资产绑定」更名为「设备绑定」,相关更名均为幂等处理,升级后将自动迁移存量菜单记录。
通过该重构,设备组织方式由「固定枚举」升级为「可配置、可扩展」的设备模型体系。

自定义设备类型与动态菜单
本版本打通了「自定义设备类型 → 动态菜单 → 通用列表页」的完整链路。
用户在创建自定义设备类型时,可指定其所属菜单分组(主机 / 网络 / 硬件 / 自定义)。系统将基于设备分组与设备类型数据库记录动态生成导航菜单:
- 内置分组(host / net / server)下的自定义类型,将注入至对应的父菜单之下;
- 自定义分组将作为顶级菜单动态创建并展示;
- 内置 6 种类型保持原有菜单结构,避免重复注入。
这一能力使系统从「固定类型 + 硬编码菜单」演进为「数据驱动的动态导航」,用户无需修改代码即可扩展全新的设备类型与对应的管理页面。

统一设备浏览与列表字段配置
围绕设备展示逻辑,本版本对原有分散页面进行了统一整理。
- 新增「设备树」统一浏览入口,集中按设备分组与设备类型查看设备,并提供设备总览面板,减少菜单分散问题。
- 新增通用设备列表页(GenericDeviceList)与通用设备详情页,可根据路由所携带的设备类型(
type_code)动态加载对应字段配置并渲染表格列。 - 新增列表字段配置能力,支持按设备类型自定义展示字段:字段勾选、列头重命名、列宽设置、排序与可见性控制,满足不同设备类型差异化的清单展示需求。
通过通用列表页与字段配置的组合,系统得以用一套通用组件承载所有内置及自定义设备类型的列表展示,显著降低重复实现成本。

###报表与导出能力补强
针对日常报表、巡检输出及导出场景,v3.0.5 版本进行了进一步完善:
- 增强主机报表相关数据处理能力,并支持异步主机报表生成,提升报表数据的准确性与完整性;
- 优化导出链路及 Excel 生成逻辑,提升大批量数据导出的稳定性;
- 完善定时任务、日报数据与统计汇总相关处理流程。
以上优化主要面向报表准确性与导出稳定性,帮助巡检与运维输出场景更平稳落地。

其他问题修复与细节优化
除上述核心能力外,v3.0.5 版本还同步完成了一批影响日常使用与维护体验的修复:
- 修复登录跳转后页面标题更新异常及相关前端控制台报错;
- 优化版本信息页、系统带宽页等页面细节展示;
- 优化头部搜索、页面布局、路由映射与国际化展示;
- 调整部分菜单与权限判断逻辑,提升页面访问稳定性。
在线 Demo
全新安装
全新安装可查看安装文档https://www.zbxtable.com/docs/install/install/
升级
在线升级
点击系统管理-版本信息-检查更新,发现新版本后,点击升级更新完成,重启应用并重新登录即可.
二进制升级
按照以下方法升级 下载最新版本,解压后替换zbxtable二进制文件,并重启
wget https://dl.cactifans.com/zbxtable/zbxtable-latest-linux-amd64.tar.gz
tar -xzf zbxtable-latest-linux-amd64.tar.gz
cd zbxtable-*-linux-amd64
mv zbxtable /usr/local/zbxtable/
chmod a+x /usr/local/zbxtable/zbxtable
chown zbxtable:zbxtable /usr/local/zbxtable/
systemctl restart zbxtable
前后端版本都已经升级成功。如前端未更新,请退出重新登陆并使用 Ctrl+F5 强制刷新即可.
文档
帮助文档:https://zbxtable.com/docs/
发布公告:https://zbxtable.com/blog/releases/
FAQ: https://zbxtable.com/docs/faq/faq/