Dubbo Admin 镜像文档

概述

Dubbo Admin 是一款专为 Dubbo 服务设计的可视化管理控制台，旨在提供直观的服务监控与管理界面。该工具全面支持 Dubbo3 版本，并向下兼容 2.7.x、2.6.x 及 2.5.x 等旧版本，帮助用户高效管理 Dubbo 微服务架构。

核心功能与特性

• 版本兼容性：完全支持 Dubbo3，同时兼容 2.7.x、2.6.x、2.5.x 等历史版本。
• 服务可视化：提供直观的服务信息展示界面，包括服务注册状态、元数据、调用关系等关键数据。
• 灵活配置：支持通过配置文件自定义注册中心、配置中心及元数据地址。
• 多环境部署：可通过 Docker 快速部署，适配开发、测试及生产环境需求。

适用场景

• 开发调试：实时查看服务注册状态与接口信息，辅助 Dubbo 服务开发调试。
• 测试验证：监控服务调用链路，验证服务集成正确性与稳定性。
• 生产运维：可视化管理生产环境 Dubbo 服务，支持服务治理与配置调整。

详细使用方法

前提条件

• 已安装 Docker 环境。
• 已部署 Dubbo 注册中心（如 ZooKeeper、Nacos 等），且地址可被容器访问。

Docker 部署步骤

1. 获取官方镜像

Dubbo Admin 官方镜像托管于 Docker Hub，可直接拉取使用：

docker pull apache/dubbo-admin

2. 配置服务参数

创建本地配置文件 application.properties，配置注册中心、配置中心及元数据地址（示例使用 ZooKeeper）：

# 注册中心地址
admin.registry.address=zookeeper://<zk-ip>:2181
# 配置中心地址
admin.config-center=zookeeper://<zk-ip>:2181
# 元数据报告地址
admin.metadata-report.address=zookeeper://<zk-ip>:2181

替换 <zk-ip> 为实际注册中心 IP 地址，确保容器可访问。

3. 启动容器

通过以下命令启动 Dubbo Admin 容器，挂载本地配置文件目录：

docker run -it --rm \
  -v /本地配置文件目录:/config \
  -p 38080:38080 \
  apache/dubbo-admin

• -v /本地配置文件目录:/config：将包含 application.properties 的本地目录挂载至容器内配置目录。
• -p 38080:38080：映射容器端口 38080 至宿主机，用于访问控制台界面。

访问与登录

容器启动后，通过浏览器访问 http://localhost:38080 打开控制台。默认登录用户名和密码均为 root。

配置说明

核心配置参数

application.properties 支持以下关键配置项：

• admin.registry.address：注册中心地址，格式为 协议://地址:端口（如 zookeeper://127.0.0.1:2181）。
• admin.config-center：配置中心地址，格式同上。
• admin.metadata-report.address：元数据报告地址，格式同上。

配置示例

使用 Nacos 作为注册中心时，配置文件示例：

admin.registry.address=nacos://192.168.1.100:8848
admin.config-center=nacos://192.168.1.100:8848
admin.metadata-report.address=nacos://192.168.1.100:8848

其他部署方式

Dubbo Admin 还支持通过 Helm（Kubernetes）、Kubernetes manifests 或源码编译部署，详情参见 官方文档。

许可证

Dubbo Admin 基于 Apache 2.0 许可证开源，详情参见 LICENSE。