rust-work/INCUBATOR.md

代理工具孵化记录

状态：孵化中 | 更新：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)

   ssh-proxy exec -n flux_dev -c "docker ps" -F json
   

3. ssh-proxy 动态添加服务器 (P2)

   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 推荐使用方式

# 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 密钥

   ssh-keygen -t rsa -b 2048 -f ~/.ssh/id_rsa_pem -m PEM -N ""
   

mysql-proxy

• 暂无

---

待优化

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