rpki/README.md
2026-03-30 10:03:43 +08:00

5.2 KiB
Raw Blame History

RPKI RTR Server

默认运行平台Ubuntu/Linux。

RTR Server

RTR Server 运行时从 CCR 目录中扫描最新的 .ccr 文件作为输入源。当前 main 路径不再读取 vrps.txt / aspas.txt / router-keys.txt,而是统一从 CCR 快照加载:

  • VRP
  • VAP / ASPA

相关实现位置:

环境变量

变量名 说明 示例
RPKI_RTR_ENABLE_TLS 是否额外启用 TLS 监听。支持 true/false1/0yes/noon/off true
RPKI_RTR_TCP_ADDR TCP 监听地址。 0.0.0.0:323
RPKI_RTR_TLS_ADDR TLS 监听地址。 0.0.0.0:324
RPKI_RTR_DB_PATH RocksDB 路径。 ./rtr-db
RPKI_RTR_CCR_DIR CCR 目录路径;程序会扫描其中最新的 .ccr 文件。 ./data
RPKI_RTR_TLS_CERT_PATH TLS 服务端证书路径。 ./certs/server-dns.crt
RPKI_RTR_TLS_KEY_PATH TLS 服务端私钥路径。 ./certs/server-dns.key
RPKI_RTR_TLS_CLIENT_CA_PATH 用于校验 router 客户端证书的 CA 证书路径。 ./certs/client-ca.crt
RPKI_RTR_MAX_DELTA 最多保留多少条 delta。 100
RPKI_RTR_PRUNE_DELTA_BY_SNAPSHOT_SIZE 是否启用“累计 delta 估算 wire size 不小于 snapshot 时,继续裁剪最老 delta”的策略。 false
RPKI_RTR_STRICT_CCR_VALIDATION 是否对 CCR 中的非法 VRP / VAP 采用严格模式;true 表示整份 CCR 拒绝,false 表示跳过非法项并告警。 false
RPKI_RTR_REFRESH_INTERVAL_SECS 刷新 CCR 目录并重新加载最新 .ccr 的间隔,单位秒。 300
RPKI_RTR_MAX_CONNECTIONS 最大并发 RTR 客户端连接数。 512
RPKI_RTR_NOTIFY_QUEUE_SIZE Serial Notify 广播队列大小。 1024
RPKI_RTR_TCP_KEEPALIVE_SECS TCP keepalive 时间,单位秒;设为 0 表示禁用。 60
RPKI_RTR_WARN_INSECURE_TCP 纯 TCP 模式下是否输出不安全警告。 true
RPKI_RTR_REQUIRE_TLS_SERVER_DNS_NAME_SAN 严格模式TLS 服务端证书不包含 subjectAltName dNSName 时拒绝启动。 false

说明

  • 纯 TCP 模式只应部署在受信任、可控网络中。
  • TLS 模式要求客户端证书认证。
  • 当前输入源是 CCR 目录,不再是单独的文本 VRP / ASPA / Router Key 文件。
  • 刷新时会重新扫描 RPKI_RTR_CCR_DIR,并选取文件名排序最新的 .ccr 文件。
  • RPKI_RTR_STRICT_CCR_VALIDATION=falseCCR 中的非法 VRP / VAP 会被跳过并输出 warningtrue 时整份 CCR 更新失败。
  • RPKI_RTR_TCP_KEEPALIVE_SECS=0 表示关闭 keepalive非零值表示在整个连接生命周期内启用 keepalive。
  • RPKI_RTR_PRUNE_DELTA_BY_SNAPSHOT_SIZE=true 时,除了 RPKI_RTR_MAX_DELTA 的固定条数裁剪外,还会在累计 delta 估算 wire size 不小于 snapshot 时继续删除最老 delta。

启动示例

Bash

纯 TCP 模式:

sh ./scripts/start-rtr-server-tcp.sh

TLS / mutual TLS 模式:

sh ./scripts/start-rtr-server-tls.sh

手动启动

纯 TCP

export RPKI_RTR_ENABLE_TLS=false
export RPKI_RTR_TCP_ADDR=0.0.0.0:323
export RPKI_RTR_DB_PATH=./rtr-db
export RPKI_RTR_CCR_DIR=./data
export RPKI_RTR_PRUNE_DELTA_BY_SNAPSHOT_SIZE=false
export RPKI_RTR_STRICT_CCR_VALIDATION=false
export RPKI_RTR_TCP_KEEPALIVE_SECS=60
export RPKI_RTR_WARN_INSECURE_TCP=true

cargo run --bin rpki

TLS / mutual TLS

export RPKI_RTR_ENABLE_TLS=true
export RPKI_RTR_TCP_ADDR=0.0.0.0:323
export RPKI_RTR_TLS_ADDR=0.0.0.0:324
export RPKI_RTR_DB_PATH=./rtr-db
export RPKI_RTR_CCR_DIR=./data
export RPKI_RTR_PRUNE_DELTA_BY_SNAPSHOT_SIZE=false
export RPKI_RTR_STRICT_CCR_VALIDATION=false
export RPKI_RTR_TLS_CERT_PATH=./certs/server-dns.crt
export RPKI_RTR_TLS_KEY_PATH=./certs/server-dns.key
export RPKI_RTR_TLS_CLIENT_CA_PATH=./certs/client-ca.crt
export RPKI_RTR_TCP_KEEPALIVE_SECS=60
export RPKI_RTR_WARN_INSECURE_TCP=true
export RPKI_RTR_REQUIRE_TLS_SERVER_DNS_NAME_SAN=true

cargo run --bin rpki

示例脚本:

CCR 输入说明

当前会从 RPKI_RTR_CCR_DIR 指向的目录中扫描最新 .ccr 文件,并从中提取:

  • VRP
  • VAP / ASPA

测试样例可参考:

RTR Debug Client

调试用 RTR client 位于:

说明文档位于:

Client 启动示例

连接纯 TCP RTR server

cargo run --bin rtr_debug_client -- 127.0.0.1:323 1 reset

连接 TLS RTR server

cargo run --bin rtr_debug_client -- \
  127.0.0.1:324 1 reset \
  --tls \
  --ca-cert ./certs/client-ca.crt \
  --server-name localhost \
  --client-cert ./certs/client-good.crt \
  --client-key ./certs/client-good.key

如果要在收到错误后继续自动轮询,可以加:

--keep-after-error