# 代理工具孵化记录

> 状态：孵化中 | 更新：2026-03-19

---

## 工具列表

| 工具 | 端口 | 状态 | 项目目录 |
|------|------|------|----------|
| mysql-proxy | 3307 | 可用 | `mysql-proxy` |
| ssh-proxy | 3308 | 可用 | `ssh-proxy` |

---

## 新增功能

### 2026-03-19

1. **请求日志** (P0)
   - 设置环境变量启用：`MYSQL_PROXY_LOG` / `SSH_PROXY_LOG`
   - 日志格式：JSON，每行一条记录

2. **ssh-proxy CLI JSON 输出** (P1)
   ```bash
   ssh-proxy exec -n flux_dev -c "docker ps" -F json
   ```

3. **ssh-proxy 动态添加服务器** (P2)
   ```bash
   ssh-proxy add-server -n myserver -H 192.168.1.100 -u root -p password
   # 或 API
   curl -X POST http://127.0.0.1:3308/servers/add \
     -H "Content-Type: application/json" \
     -d '{"name":"myserver","host":"192.168.1.100","user":"root","password":"secret"}'
   ```

4. **API 错误友好提示**
   - 错误时返回 `usage` 字段，引导正确使用

### 2026-03-18

- mysql-proxy 动态添加连接 API
- ssh-proxy Windows 路径修复
- ssh-proxy 读取错误日志修复

---

## 实测性能

| 操作 | 代理 | 直连 | 提升 |
|------|------|------|------|
| mysql 首次查询 | ~150ms | ~500ms | 3x |
| mysql 复用会话 | ~50ms | ~500ms | 10x |
| ssh 首次执行 | ~900ms | ~1500ms | 1.7x |
| ssh 复用会话 | ~100-200ms | ~1500ms | 7-15x |

---

## AI 推荐使用方式

```bash
# MySQL 查询 (AI 友好)
curl -X POST http://127.0.0.1:3307/query \
  -H "Content-Type: application/json" \
  -d '{"conn":"flux_dev","sql":"SELECT VERSION()"}'

# SSH 执行 (AI 友好)
curl -X POST http://127.0.0.1:3308/exec \
  -H "Content-Type: application/json" \
  -d '{"server":"flux_dev","command":"docker ps"}'
```

**优势**：
- JSON 格式，易于解析
- 会话复用，响应快
- 错误提示友好

---

## 已知问题

### ssh-proxy

1. **ssh2 不支持 ed25519 密钥**
   - 错误: `[Session(-19)] Callback returned error`
   - 解决: 使用 PEM 格式 RSA 密钥
   ```bash
   ssh-keygen -t rsa -b 2048 -f ~/.ssh/id_rsa_pem -m PEM -N ""
   ```

### mysql-proxy

- 暂无

---

## 待优化

*由 AI 在实际使用过程中根据遇到的问题填写*