monitoringartist/dockbix-xxl
monitoringartist
自动构建
这是一个集成Zabbix 3.4 server、web、proxy、java gateway、snmpd及社区扩展的Docker镜像，支持Docker监控，可自动导入模板和配置，便于快速部署监控系统。
21 次收藏下载次数: 0状态：自动构建维护者：monitoringartist仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Dockbix XXL
Dockbix XXL是Docker化的Zabbix镜像，预配置以支持轻松的Docker监控。该镜像包含标准Zabbix及额外的XXL社区扩展，支持自动导入Zabbix数据库、Docker监控模板、自动注册规则等常规任务。
核心功能
- 集成Zabbix 3.4的server、web UI、proxy、java gateway、snmpd组件
- 包含XXL社区扩展：Searcher（搜索工具）、Grapher（图表工具）、Zapix（API扩展）
- 自动导入Docker监控模板和数据库初始化配置
- 支持API命令/脚本执行、SQL文件导入
- 可通过环境变量或卷配置自定义Zabbix参数
使用场景
- 企业Docker容器环境的监控与管理
- 服务器、应用程序的统一监控
- 快速部署Zabbix监控系统，减少手动配置时间
- 多组件（Java应用、SNMP设备）的集中监控
配置说明
环境变量
可通过环境变量配置XXL特性和Zabbix参数，常用变量如下：
| 变量 | 默认值 | 描述 |
|---|---|---|
| XXL_zapix | false | 启用/禁用Zapix扩展 |
| XXL_grapher | false | 启用/禁用Grapher扩展 |
| ZS_DBHost | zabbix.db | Zabbix服务器数据库主机 |
| ZS_DBUser | zabbix | 数据库用户名 |
| ZS_DBPassword | zabbix | 数据库密码 |
卷配置
挂载卷自定义配置文件：
-v /host/custom-config/:/etc/custom-config/：覆盖Zabbix server、proxy等配置文件
角色变量
启用/禁用特定组件：
| 变量 | 默认值 | 描述 |
|---|---|---|
| ZS_enabled | true | 启用Zabbix Server |
| ZW_enabled | true | 启用Zabbix Web UI |
| ZJ_enabled | false | 启用Zabbix Java Gateway |
| SNMPTRAP_enabled | false | 启用SNMP trap处理 |
部署示例
快速启动
sh# 创建数据容器 docker run -d -v /var/lib/mysql --name dockbix-db-storage busybox:latest # 启动数据库容器 docker run \ -d \ --name dockbix-db \ -v /backups:/backups \ -v /etc/localtime:/etc/localtime:ro \ --volumes-from dockbix-db-storage \ --env="MARIADB_USER=zabbix" \ --env="MARIADB_PASS=my_password" \ monitoringartist/zabbix-db-mariadb # 启动Dockbix容器 docker run \ -d \ --name dockbix \ -p 80:80 \ -p 10051:10051 \ -v /etc/localtime:/etc/localtime:ro \ --link dockbix-db:dockbix.db \ --env="ZS_DBHost=dockbix.db" \ --env="ZS_DBUser=zabbix" \ --env="ZS_DBPassword=my_password" \ --env="XXL_zapix=true" \ --env="XXL_grapher=true" \ monitoringartist/dockbix-xxl:latest # 等待约30秒初始化，访问http://localhost（默认凭据：Admin/zabbix）
Docker Compose启动
shdocker-compose up -d
故障排除
- 查看容器状态：
docker ps - 查看日志：
docker logs dockbix - 进入容器：
docker exec -ti dockbix /bin/bash
注意事项
- 该镜像仅支持MySQL/MariaDB数据库
- 如需PostgreSQL支持，可参考分叉仓库：https://github.com/luchnck/zabbix-xxl-postgresql
- 生产环境建议使用指定版本标签（如3.4.0）而非latest
- 迁移旧镜像时请先备份数据库数据
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 dockbix-xxl 镜像标签
docker pull docker.xuanyuan.run/monitoringartist/dockbix-xxl:<标签>
DockerHub 原生拉取命令
docker pull monitoringartist/dockbix-xxl:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"