跳到主要内容

稳定版里程碑

routerd 以 vYYYYMMDD.HHmm 格式频繁发布版本，其中经过评估可供正式环境使用的版本，会在每个里程碑时选定为「稳定版里程碑」。初次部署时，请使用本页所列的版本。

当前推荐版本​

项目内容
版本v20260627.1533
定位推荐稳定版（post-1107 SAM baseline 加上 operator 输出整理）
运行实绩AWS/Azure/OCI/PVE single-topology baseline 136 秒收敛，matrix 12/12，全部 leaf MobilityPool Ready，provider pending/failed 0，cleanup state 0
二进制静态链接（CGO_ENABLED=0），通过 CI 和 Release 工作流

推荐 v20260627.1533 的理由​

v20260627.1533 在 v20260627.1107 的 SAM baseline 上整理了 routerctl mobility explain 与 routerctl action list 的 operator 输出。PVE substrate 采用 qnap-backed live ISO/config media、DHCP/QGA 管理与 ens19 capture interface 后，AWS/Azure/OCI/PVE fresh single-topology baseline 已通过。

release manifest 记录在 docs/releases/manifests/v20260627.1533.yaml。

Pair-stable addressing（#330, #331）​

SAMTransportProfile 新增 spec.addressingMode: pair-stable，使用 inner prefix 和 canonical peer key 的 fnv64a 哈希实现确定性的 /31 slot 分配。

  • 紧凑配置编写。 leaf 节点不再需要 topologyNodeRefs，消除了逐节点重复的拓扑声明。svnet1 配置减少约 100 行。
  • 拓扑变更稳定性。 添加或删除节点不会重新分配现有 peer 的地址（与依赖排序顺序的 edge-index 不同）。
  • 向后兼容。 现有的 edge-index（默认）配置不受影响。
  • 碰撞检测。 routerd validate / routerctl validate 在配置时检测 /31 slot 哈希碰撞。

从 v20260608.0642 继承的事项​

继承 v20260608.0642 的全部特性：ADR 0014 CLI 重新设计、DNS VRRP VIP 支持、forcefrag prerouting 修复、BGP peer watch 稳定化及所有先前的生产安全修复。

已知观测（非发布阻塞项）​

  • install.sh 后 routerd-bgp 可能仍以旧 inode 运行。 这是设计如此。install.sh 在升级时不自动重启 routerd-bgp，以便已建立的 BGP 会话和 ECMP 在 routerd 二进制更新后存活。
  • 未声明 ManagementAccess 的配置中 routerctl doctor mgmt 显示 SKIP。 这是运行配置的选择，非发布缺陷。
升级注意
  • 从 v20260528.2308 升级时： ADR 0014 变更了 CLI verb 体系。routerd apply → routerctl apply、routerd validate → routerctl validate 等。如果服务单元或脚本中使用了旧命令，请重写。install.sh 会自动部署新的服务单元，因此 systemd 管理的单元会自动更新。
  • 务必先 cd 到解压后的发布目录再执行 install.sh。
  • 从 v20260523.1542 及更早版本升级时： disabled: 字段（请用 enabled: false）和 --controller-chain* / --observe-interval 标志已删除。
  • DNS 解析器服务单元化： 解析器以 routerd-dns-resolver@<name>.service 运行。首次升级时会有短暂的 DNS 中断。

「稳定版」的含义与注意​

API 仍为 v1alpha1

「稳定版里程碑」表示该版本的质量达到了生产可用的水准，但不承诺 API（资源 schema）的向后兼容。

  • routerd 的资源 API 目前为 v1alpha1。版本间可能出现破坏性变更。
  • 升级时请勿依赖向后兼容。请以**按照新 schema 重写配置（YAML）**为前提进行。
  • 策略上不提供迁移兼容层。各版本的变更请查阅变更日志。

安装与升级​

安装步骤请参阅安装与升级。建议以推荐的里程碑版本为升级起点。