# pres-dubbo

**Repository Path**: prestest/dubboTestTool

## Basic Information

- **Project Name**: pres-dubbo
- **Description**: 测试dubbo接口的小工具
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/prestest/dubboTestTool
- **GVP Project**: No

## Statistics

- **Stars**: 29
- **Forks**: 14
- **Created**: 2020-05-09
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dubbo Test Tool

基于 Flask + ZooKeeper 的 Dubbo 接口测试工具，支持通过 ZooKeeper 自动发现服务或直接通过 IP:端口调用。

## 功能特性

- 🔍 **自动服务发现** - 从 ZooKeeper 获取 Dubbo 服务列表
- 🔎 **实时搜索** - 支持服务和方法的模糊搜索
- 📝 **参数编辑** - 可视化 JSON 参数编辑，带语法高亮
- 🌐 **本地调试** - 支持直接 IP:端口 调用，无需 ZooKeeper
- ⚡ **开箱即用** - 配置保存在浏览器，无需后端配置
- 📋 **一键复制** - 响应结果支持快速复制

## 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/prestest/dubboTestTool
cd dubboTestTool
```

### 2. 安装依赖

**使用 uv（推荐）：**

```bash
uv venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .
```

**使用 pip：**

```bash
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .
```

### 3. 启动服务

```bash
python app.py
```

访问 http://localhost:5555

## 使用指南

### 首次使用

1. 打开页面后，点击左侧「设置」按钮
2. 输入 ZooKeeper 地址（如 `zk.example.com:2181`）
3. 点击保存，配置将保存在浏览器本地

### 调用 Dubbo 服务

1. **选择服务** - 在左侧服务列表中搜索并点击选择
2. **选择方法** - 在方法下拉框中搜索并选择要调用的方法
3. **输入参数** - 在参数框中输入 JSON 格式的参数
4. **点击调用** - 或使用快捷键 `Ctrl/Cmd + Enter`

### 参数格式

```json
// 简单参数
"user123", 456

// 对象参数
{
  "name": "zhangsan",
  "age": 12,
  "class": "com.example.User"
}

// 多个参数用逗号分隔
"param1", {"key": "value"}, 123
```

### 本地调试

访问 `/local` 页面，直接输入 IP、端口、服务名和方法名进行调用，无需 ZooKeeper。

## 项目结构

```
dubboTestTool/
├── app.py                  # Flask 应用入口
├── utils/
│   ├── zookeeper_client.py # ZooKeeper 客户端
│   └── dubbo_client.py     # Dubbo 调用封装
├── templates/              # HTML 模板
├── static/                 # 静态资源
│   ├── style.css          # 样式文件
│   └── app.js             # 前端交互
└── pyproject.toml          # 项目配置
```

## 技术栈

- **后端**: Flask + Kazoo + prestool
- **前端**: 原生 JavaScript + CSS（无框架依赖）
- **协议**: Dubbo Telnet

## License

MIT