qnib/zkui

docker-zkui

镜像概述和主要用途

docker-zkui是一个包含Zookeeper UI（zkui）的Docker镜像，zkui是一款用于可视化管理Zookeeper集群的Web工具。该镜像支持两种使用模式：自动连接Consul服务发现中的Zookeeper集群，或手动配置连接外部Zookeeper集群，提供直观的Web界面进行Zookeeper节点管理、数据查看和操作。

核心功能和特性

• 内置zkui工具：集成Zookeeper Web UI（https://github.com/DeemOpen/zkui%EF%BC%89%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%9B%BE%E5%BD%A2%E5%8C%96%E7%AE%A1%E7%90%86%E7%95%8C%E9%9D%A2
• Consul自动发现：默认自动连接Consul中的Zookeeper服务（leader.zookeeper.service.consul,follower.*）
• 外部集群支持：可通过环境变量手动配置连接外部Zookeeper集群
• 多用户权限：提供管理员（读写权限）和普通用户（只读权限）两种角色
• 密码自定义：支持通过环境变量修改管理员和普通用户的登录密码

使用场景和适用范围

适用于需要通过Web界面可视化管理Zookeeper集群的场景，包括：

• 在Consul服务发现环境中自动管理Zookeeper集群
• 独立部署以连接外部Zookeeper集群进行监控和管理
• 开发测试环境中快速搭建Zookeeper可视化管理工具

使用方法和配置说明

连接外部Zookeeper集群

默认情况下，zkui服务会等待Consul中出现Zookeeper服务。若需独立连接外部Zookeeper集群，可通过以下命令启动：

bash
docker run -d --name zkui -p 9090:9090 -e ZKUI_ZK_SERVER=<外部DNS/IP>:2181[,<外部DNS/IP>:2181] qnib/zkui

环境变量配置：

• ZKUI_ZK_SERVER：外部Zookeeper集群地址，格式为<DNS/IP>:2181，多个节点用逗号分隔
• ZKUI_ADMIN_PW：管理员（admin）密码，默认为admin（读写权限）
• ZKUI_USER_PW：普通用户（user）密码，默认为user（只读权限）

安全注意事项：密码会存储在容器元数据中，可通过docker inspect命令查看，因此不适用于高安全性场景。管理员用户拥有数据删除权限，需谨慎使用。

在Consul环境中使用（Docker Compose）

在Consul服务发现环境中，可通过docker-compose启动完整栈：

bash
docker-compose up -d
Creating consul
Creating zookeeper
Creating zkui

启动后，可通过Consul UI（<docker-host>:8500）查看服务状态，所有服务应显示为绿色。

访问Web UI

服务启动后，通过浏览器访问<docker-host>:9090打开zkui Web界面。默认登录凭据：

• 管理员：admin/admin（可通过ZKUI_ADMIN_PW修改密码）
• 普通用户：user/user（可通过ZKUI_USER_PW修改密码）