planetRelay

按配置转发 UDP 数据包，提供来源过滤、流量统计和往返延迟测量。

安装与启动

需要 Linux、Python 3.10+、uv。

git clone --recurse-submodules git@github.com:Renforce-Dynamics/planetRelay.git
cd planetRelay
./scripts/bootstrap.sh

./scripts/run.sh --config configs/entry/entry_relay.yaml

默认在本机转发 PLAT 探测包：50590 → 50591。 持续运行，Ctrl+C 退出；另开终端测量往返延迟：

.venv/bin/planetrelay-latency 127.0.0.1 --count 100 --interval-ms 10

配置路由

新建 configs/entry/entry_relay_site.yaml，将地址改为实际收发端：

extends: entry_relay.yaml
ingress:
  bind_host: 0.0.0.0
  allowed_source_hosts: [192.168.1.10]
target:
  host: 192.168.1.20
routes:
  probe:
    port: 50592
    target_port: 50593

./scripts/run.sh --config configs/entry/entry_relay_site.yaml

示例继承了 PLAT 和 108 字节过滤条件；转发其他协议时一并调整 magic、 packet_size。latest 转发当前接收批次的最新有效包，all 转发所有有效包。 命令时效和丢包处理由接收应用负责。

配置只保存在根目录 configs/；安装包只包含代码。每次启动都显式选择 entry，缺失路径直接报错。

文档与开发

• 路由配置和字段说明
• Rally 现场网络示例

通过 planetConfig 复用配置库， 不依赖 Cadence 或 SDK；任务地址与拓扑放在任务仓库。

开发：./scripts/test.sh 运行测试，./scripts/build.sh 构建安装包。 ./scripts/doctor.sh --config configs/entry/entry_relay.yaml 检查选定配置，不启动 I/O。

工具支持 --venv /path/to/env。由 Renforce Dynamics 开发维护，采用 MIT License。