rtr client 开发

deploy/frr/README.md

@@ -0,0 +1,64 @@
+# FRR Minimal RTR Client Config
+
+中文文档: [README.zh.md](./README.zh.md)
+
+This folder provides a minimal FRR setup for black-box interop testing
+against this repository's RTR server defaults.
+
+Server defaults in this repo:
+- TCP: `0.0.0.0:323`
+- TLS: `0.0.0.0:324`
+
+Reference:
+- `src/main.rs`
+
+## Files
+
+- `daemons.example`: sample `/etc/frr/daemons`
+- `frr.conf.example`: sample `/etc/frr/frr.conf`
+
+## How to apply on an FRR host
+
+1. Copy `daemons.example` to `/etc/frr/daemons`.
+2. Copy `frr.conf.example` to `/etc/frr/frr.conf`.
+3. Restart FRR:
+
+```bash
+sudo systemctl restart frr
+```
+
+## Verify
+
+```bash
+vtysh -c "show rpki configuration"
+vtysh -c "show rpki cache-server"
+vtysh -c "show rpki cache-connection"
+vtysh -c "show rpki prefix-table"
+```
+
+If `show rpki cache-connection` is connected and `show rpki prefix-table`
+contains VRPs, the RTR client path is working.
+
+## Docker quick start
+
+From repository root:
+
+```bash
+docker compose -f deploy/frr/docker-compose.yml up -d
+docker exec -it frr-rpki-client vtysh -c "show rpki cache-connection"
+docker exec -it frr-rpki-client vtysh -c "show rpki prefix-table"
+```
+
+Stop:
+
+```bash
+docker compose -f deploy/frr/docker-compose.yml down
+```
+
+## Notes
+
+- This setup targets RTR over TCP (`rpki cache tcp`).
+- Keep protocol-level conformance checks in Rust tests and
+  `src/bin/rtr_debug_client`.
+- `network_mode: host` expects your RTR server to be reachable at
+  `127.0.0.1:323` from the Docker host.

deploy/frr/README.zh.md

@@ -0,0 +1,71 @@
+# FRR 最小化 RTR 客户端配置
+
+本目录提供一个 FRR 最小配置，用于和本仓库 RTR Server 做黑盒互通测试。
+
+本仓库默认 RTR 监听地址：
+- TCP：`0.0.0.0:323`
+- TLS：`0.0.0.0:324`
+
+参考实现：
+- `src/main.rs`
+
+## 文件说明
+
+- `daemons.example`：示例 `/etc/frr/daemons`
+- `frr.conf.example`：示例 `/etc/frr/frr.conf`
+
+## 在 FRR 主机上应用
+
+1. 复制 `daemons.example` 到 `/etc/frr/daemons`
+2. 复制 `frr.conf.example` 到 `/etc/frr/frr.conf`
+3. 重启 FRR：
+
+```bash
+sudo systemctl restart frr
+```
+
+## 验证命令
+
+```bash
+vtysh -c "show rpki configuration"
+vtysh -c "show rpki cache-server"
+vtysh -c "show rpki cache-connection"
+vtysh -c "show rpki prefix-table"
+```
+
+当 `show rpki cache-connection` 显示已连接，且 `show rpki prefix-table` 出现 VRP 时，说明 RTR 客户端链路工作正常。
+
+## Docker 快速启动
+
+在仓库根目录执行：
+
+```bash
+docker compose -f deploy/frr/docker-compose.yml up -d
+docker exec -it frr-rpki-client vtysh -c "show rpki cache-connection"
+docker exec -it frr-rpki-client vtysh -c "show rpki prefix-table"
+```
+
+停止：
+
+```bash
+docker compose -f deploy/frr/docker-compose.yml down
+```
+
+## 可测试范围
+
+- FRR 作为 RTR Client 与本仓库 Server 的 TCP 建链能力
+- FRR 侧基础会话状态可见性（`cache-server` / `cache-connection`）
+- VRP 下发与导入是否成功（`prefix-table` 是否有条目）
+- 基于服务端数据变化触发的前缀表更新（可通过替换 `data` 后观察）
+- 黑盒互通回归：用于确认“路由器客户端视角”功能可用
+
+## 不覆盖范围
+
+- 不替代协议级单元测试/集成测试（PDU 细节、异常路径、边界条件）
+- 不替代 `src/bin/rtr_debug_client` 的逐报文调试能力
+- 默认示例以 TCP 为主，TLS/mTLS 需按你的证书与 FRR 配置单独扩展
+
+## 说明
+
+- 当前示例主要针对 RTR over TCP（`rpki cache tcp`）
+- `network_mode: host` 模式下，容器内访问 `127.0.0.1:323` 指向 Docker Host，请确保本机 RTR Server 可达

deploy/frr/daemons.example

@@ -0,0 +1,7 @@
+# Minimal FRR daemons config for RPKI testing
+
+zebra=yes
+bgpd=yes
+
+# Enable bgpd RPKI module
+bgpd_options=" -A 127.0.0.1 -M rpki"

deploy/frr/docker-compose.yml

@@ -0,0 +1,10 @@
+services:
+  frr-rpki-client:
+    image: quay.io/frrouting/frr:10.2.2
+    container_name: frr-rpki-client
+    restart: unless-stopped
+    network_mode: host
+    privileged: true
+    volumes:
+      - ./frr/daemons.example:/etc/frr/daemons:ro
+      - ./frr/frr.conf.example:/etc/frr/frr.conf:ro

deploy/frr/frr.conf.example

@@ -0,0 +1,22 @@
+frr version 10.2
+frr defaults traditional
+hostname rpki-lab
+service integrated-vtysh-config
+!
+debug rpki
+!
+rpki
+ rpki polling_period 10
+ rpki timeout 10
+ rpki retry_interval 10
+ rpki expire_interval 7200
+ rpki cache tcp 127.0.0.1 323 preference 1
+ exit
+!
+router bgp 65001
+ bgp router-id 192.0.2.1
+ !
+ address-family ipv4 unicast
+ exit-address-family
+!
+line vty