readme-cn.md

tproxy

English | 简体中文 | 日本語

为啥写这个工具

当我在做后端开发或者写 go-zero 的时候，经常会需要监控网络连接，分析请求内容。比如：

1. 分析 gRPC 连接何时连接、何时重连
2. 分析 MySQL 连接池，当前多少连接，连接的生命周期是什么策略
3. 也可以用来观察和分析任何 TCP 连接

安装

$ GOPROXY=https://goproxy.cn/,direct go install github.com/kevwan/tproxy@latest

或者使用 docker 镜像：

$ docker run --rm -it -p <listen-port>:<listen-port> -p <remote-port>:<remote-port> kevinwan/tproxy:v1 tproxy -l 0.0.0.0 -p <listen-port> -r host.docker.internal:<remote-port>

arm64 系统:

$ docker run --rm -it -p <listen-port>:<listen-port> -p <remote-port>:<remote-port> kevinwan/tproxy:v1-arm64 tproxy -l 0.0.0.0 -p <listen-port> -r host.docker.internal:<remote-port>

Windows:

$ scoop install tproxy

用法

$ tproxy --help
Usage of tproxy:
  -d duration
    	the delay to relay packets
  -down int
    	Downward speed limit(bytes/second)
  -l string
    	Local address to listen on (default "localhost")
  -p int
    	Local port to listen on, default to pick a random port
  -q	Quiet mode, only prints connection open/close and stats, default false
  -r string
    	Remote address (host:port) to connect
  -s	Enable statistics
  -t string
    	The type of protocol, currently support http2, grpc, redis and mongodb
  -up int
    	Upward speed limit(bytes/second)

示例

分析 gRPC 连接

$ tproxy -p 8088 -r localhost:8081 -t grpc -d 100ms

• 侦听在 localhost 和 8088 端口
• 重定向请求到 localhost:8081
• 识别数据包格式为 gRPC
• 数据包延迟100毫秒

分析 MySQL 连接

$ tproxy -p 3307 -r localhost:3306

查看网络状况（重传率和RTT）

$ tproxy -p 3307 -r remotehost:3306 -s -q

查看连接池（总连接数、最大并发连接数、最长生命周期等）

$ tproxy -p 3307 -r :3306 -s -q

欢迎 star！⭐

如果你正在使用或者觉得这个项目对你有帮助，请 star 支持，感谢！