170 lines
3.9 KiB
Markdown
170 lines
3.9 KiB
Markdown
# 代理工具孵化记录
|
||
|
||
> 状态：孵化中 | 更新：2026-03-24
|
||
|
||
---
|
||
|
||
## 工具列表
|
||
|
||
| 工具 | 端口 | 状态 | 项目目录 |
|
||
|------|------|------|----------|
|
||
| mysql-proxy | 3307 | 可用 | `mysql-proxy` |
|
||
| ssh-proxy | 3308 | 可用 | `ssh-proxy` |
|
||
| mongo-proxy | 3309 | 可用 | `mongo-proxy` |
|
||
| redis-proxy | 3310 | 可用 | `redis-proxy` |
|
||
|
||
---
|
||
|
||
## 新增功能
|
||
|
||
### 2026-03-24
|
||
|
||
1. **redis-proxy** (新工具)
|
||
- Redis HTTP 代理，会话复用
|
||
- 支持 run/get/set/del/keys/info
|
||
- CLI 模式 + HTTP API 双模式
|
||
- 连接: flux_dev
|
||
|
||
2. **mongo-proxy** (新工具)
|
||
- MongoDB HTTP 代理，会话复用
|
||
- 支持 find/insert/update/delete/aggregate/count
|
||
- CLI 模式 + HTTP API 双模式
|
||
- 连接: suke_dev, suke_pro
|
||
|
||
### 2026-03-21
|
||
|
||
1. **ssh-proxy 断线重连** (P0)
|
||
- exec 方法检测到会话失效时自动清除并重连
|
||
- 修复 get_or_create_session TOCTOU 竞态条件
|
||
|
||
2. **日志智能分级** (P1)
|
||
- 慢请求告警: >3s WARN, >10s ERROR
|
||
- 退出码识别: exitCode 0/1/-1 视为正常，>=2 或 127 标记 ERROR
|
||
- UTF-8 安全截断
|
||
|
||
3. **服务器配置扩展** (P1)
|
||
- 新增 server1 (一号机)、server2 (二号机)、ai_sg (新加坡 AI 机器)
|
||
- 共 5 台服务器
|
||
|
||
4. **代码优化** (P2)
|
||
- 移除未使用的 async-trait 依赖
|
||
- 用 time crate 替换 40 行手写日期计算
|
||
- 清理未使用字段
|
||
|
||
### 2026-03-20
|
||
|
||
1. **ssh-proxy russh 迁移** (P0)
|
||
- 从 ssh2 迁移到 russh，原生支持 ed25519 密钥
|
||
- 修复了 ed25519 认证失败问题
|
||
- 使用 async/await 原生 API
|
||
|
||
### 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 推荐使用方式
|
||
|
||
> **优先使用 CLI 模式**，命令简洁
|
||
|
||
```bash
|
||
# MySQL 查询 (CLI 优先)
|
||
mysql-proxy cli -c flux_dev -e "SELECT VERSION()"
|
||
|
||
# MySQL JSON 输出
|
||
mysql-proxy cli -c flux_dev -e "SHOW TABLES" -F json
|
||
|
||
# MySQL 执行 DML
|
||
mysql-proxy cli -c flux_dev -e "UPDATE users SET status=1" -x
|
||
|
||
# SSH 执行 (CLI 优先)
|
||
ssh-proxy exec -n flux_dev -c "docker ps"
|
||
|
||
# SSH JSON 输出
|
||
ssh-proxy exec -n flux_dev -c "docker ps" -F json
|
||
|
||
# 列出服务器
|
||
ssh-proxy servers
|
||
mysql-proxy connections
|
||
```
|
||
|
||
**HTTP API (复杂场景)**：
|
||
```bash
|
||
# MySQL
|
||
curl -X POST http://127.0.0.1:3307/query \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"conn":"flux_dev","sql":"SELECT VERSION()"}'
|
||
|
||
# SSH
|
||
curl -X POST http://127.0.0.1:3308/exec \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"server":"flux_dev","command":"docker ps"}'
|
||
```
|
||
|
||
**降级方案** (代理不可用)：
|
||
```bash
|
||
mysql -h<host> -u<user> -p<password> -D<database> -e "<SQL>"
|
||
ssh <user>@<host> "<command>"
|
||
```
|
||
|
||
**优势**：
|
||
- CLI 命令简洁，AI 友好
|
||
- JSON 格式输出，易于解析
|
||
- 会话复用，响应快
|
||
- 错误提示友好
|
||
|
||
---
|
||
|
||
## 已知问题
|
||
|
||
### ssh-proxy
|
||
|
||
- 暂无 (ed25519 已支持)
|
||
|
||
### mysql-proxy
|
||
|
||
- 暂无
|
||
|
||
---
|
||
|
||
## 待优化
|
||
|
||
*由 AI 在实际使用过程中根据遇到的问题填写*
|