baize 使用指南

字段	类型	默认值	说明
server_addr	string	""	服务端监听 IP 地址（本机）
client_addrs	string	""	允许的客户端 IP 地址，多个用逗号分隔
tos	int	0	IP TOS/DSCP 值
client_port_range	string	""	客户端源端口范围，格式 min,max
server_port_range	string	""	服务端监听端口范围，格式 min,max
rate_in_span	int64	0	每个 span 内的发包速率
span	string	"0s"	统计时间窗口
delay	string	"0s"	统计处理延迟
msg_len	int	0	消息体大小
verbose	bool	false	丢包时打印详细端口信息

基本部署：仅 Client

{
  "log_dir": "/var/log/baize",
  "client": {
    "client_addr": "10.0.0.1",
    "server_addrs": "10.0.0.2",
    "rate_in_span": 5000,
    "span": "1s",
    "delay": "3s"
  }
}

基本部署：仅 Server

{
  "log_dir": "/var/log/baize",
  "server": {
    "server_addr": "10.0.0.2",
    "client_addrs": "10.0.0.1",
    "rate_in_span": 5000,
    "span": "1s",
    "delay": "3s"
  }
}

互探模式：双向监控

两台机器各自运行 baize，互为 Client 和 Server，实现双向网络质量监控：

# 机器 A (10.0.0.1) 的配置
{
  "pprof_addr": ":6060",
  "log_dir": "/var/log/baize",
  "log_max_age_days": 7,
  "client": {
    "client_addr": "10.0.0.1",
    "server_addrs": "10.0.0.2",
    "rate_in_span": 5000,
    "span": "1s",
    "delay": "3s",
    "msg_len": 1024,
    "tos": 64
  },
  "server": {
    "server_addr": "10.0.0.1",
    "client_addrs": "10.0.0.2",
    "rate_in_span": 5000,
    "span": "1s",
    "delay": "3s",
    "msg_len": 1024,
    "tos": 64
  }
}

高精度探测：多端口 + 高速率

{
  "client": {
    "client_addr": "10.0.0.1",
    "server_addrs": "10.0.0.2",
    "client_port_range": "43500,43599",
    "server_port_range": "43600,43609",
    "rate_in_span": 10000,
    "span": "1s",
    "delay": "3s",
    "msg_len": 1024,
    "tos": 128
  }
}

多目标探测

{
  "client": {
    "client_addr": "10.0.0.1",
    "server_addrs": "10.0.0.2,10.0.0.3,10.0.0.4",
    "rate_in_span": 5000,
    "span": "1s",
    "delay": "3s"
  }
}

调试模式：开启 pprof + verbose

{
  "pprof_addr": ":6060",
  "log_dir": "/var/log/baize",
  "client": {
    "client_addr": "10.0.0.1",
    "server_addrs": "10.0.0.2",
    "rate_in_span": 5000,
    "span": "1s",
    "delay": "3s",
    "verbose": true
  }
}

启动后可通过 pprof 分析运行时状态：

# 查看 goroutine 状态
go tool pprof http://localhost:6060/debug/pprof/goroutine

# 查看 CPU profile
go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30

# 查看内存分配
go tool pprof http://localhost:6060/debug/pprof/heap

当配置了 log_dir 时，baize 会将日志写入文件并自动管理轮转和清理：

日志文件命名

/var/log/baize/
├── baize.log          # symlink → 指向当天日志
├── baize.log.20260601 # 6月1日日志
├── baize.log.20260602 # 6月2日日志
├── baize.log.20260603 # 6月3日日志
└── baize.log.20260604 # 6月4日日志（当天）

轮转机制

• 按天轮转：每天零点后首次写入时自动创建新日志文件。
• symlink 更新：baize.log 始终指向当天日志文件，方便实时查看（tail -f baize.log）。
• 自动清理：超过 log_max_age_days 的日志文件在轮转时自动删除。

配置示例

{
  "log_dir": "/var/log/baize",
  "log_max_age_days": 7
}

Q: baize 和 bitflip 该选哪个?

临时探测用 bitflip（命令行参数，开箱即用）；长期持续监控用 baize（配置文件驱动，内置日志轮转和 pprof）。

Q: 可以在同一台机器上同时运行 Client 和 Server 吗?

可以。baize 支持在配置文件中同时配置 client 和 server，它们会在同一进程中以独立 goroutine 运行。注意端口范围不能冲突。

Q: 配置文件修改后需要重启吗?

是的，baize 不支持热加载配置。修改配置文件后需要重启进程。推荐使用 systemd 等进程管理工具：

sudo systemctl restart baize

Q: 如何优雅停止 baize?

发送 SIGINT (Ctrl+C) 或 SIGTERM 信号。程序会取消所有 goroutine 并等待 1 秒让在途报文回来后退出。如果使用 systemd，systemctl stop baize 会发送 SIGTERM。

Q: 为什么 Client 需要 sudo?

Client 需要设置 socket 的 IP_TOS 选项来标记 DSCP 值，某些系统需要特权才能设置非默认 TOS。

Q: 如何查看运行时性能数据?

配置 pprof_addr 后，可通过 Go pprof 工具分析 goroutine、CPU、内存等性能数据。详见"使用示例 - 调试模式"章节。

Q: server_addrs 和 client_addrs 支持多个地址吗?

支持，用逗号分隔。例如 "server_addrs": "10.0.0.2,10.0.0.3"。Client 会向所有列出的 Server 发送探测。

Q: duration 格式支持哪些?

使用 Go 的 time.ParseDuration 格式，如 "1s"、"5s"、"1m"、"1h"。无效格式会被忽略并打印警告日志。

Q: 日志文件会无限增长吗?

不会。日志按天轮转，超过 log_max_age_days（默认 7 天）的日志会在轮转时自动删除。