WAN Link、Tunnel、Topology、Probe 与 Relay 设置

WAN Link 的接口候选必须来自 Edge inventory；Relay 候选必须来自平台允许当前租户使用的 Relay Pool。不要手填运行态接口或不存在的 Relay Edge。

WAN Link（wan-links）

作用： 登记 Edge 的运营商链路、接口、容量、成本和可用能力。

前置条件： Edge 必须在线并已上报接口候选。

标准操作： 在对应资源列表选择“新建”，完成必填字段后保存 Draft；返回列表检查状态，再进入变更发布流程。编辑时先读取最新版本，出现并发冲突不要强制覆盖。

设置项	作用	何时填写	格式/单位	默认行为	依赖关系	保存后的影响与风险
edge_id Edge	选择承载该配置的边缘设备。	创建时必填	关联资源	空；不启用可选能力	依赖 edges	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
name 名称	供操作者识别资源；应使用稳定、可搜索且能体现地点或用途的名称。	创建时必填	单行文本；最长 128 字符	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
transport 传输类型	配置 WAN Link 的“传输类型”属性。	创建时必填	单选；可选：Internet（internet）、MPLS（mpls）、Private（private）、Cellular（cellular）	internet	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
admin_enabled 管理启用	关闭后保留配置，但不参与转发。	按需填写	开关	开启	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
selector 受管接口选择器	从所选 Edge 最近上报的 inventory 中选择；Console 自动写入稳定标识。	创建时必填	结构化设置	{"stable_id":"","interface":"","mac_address":"","pci_address":""}	候选来自 Edge inventory	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
selector.stable_id Stable ID	引用或固定Stable ID；必须使用系统中的稳定标识，不要填写显示名称代替。	按需填写	单行文本；示例：推荐使用 Agent 上报的稳定标识	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
selector.interface 接口名	配置 WAN Link 的“接口名”属性。	按需填写	单行文本；最长 64 字符	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
selector.mac_address MAC 地址	填写MAC 地址，用于确定匹配、监听或转发的网络范围；必须与实际地址规划一致。	按需填写	单行文本；示例：00:11:22:33:44:55	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
selector.pci_address PCI 地址	填写PCI 地址，用于确定匹配、监听或转发的网络范围；必须与实际地址规划一致。	按需填写	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
provider 服务商	配置 WAN Link 的“服务商”属性。	按需填写	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
circuit_id 电路 ID	引用或固定电路 ID；必须使用系统中的稳定标识，不要填写显示名称代替。	按需填写	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
srlg SRLG	共享风险链路组，用于路径去相关。	按需填写	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
priority 优先级	控制有序匹配或候选选择顺序；按页面提示确认数值方向。	按需填写	数字；范围：1–不限	100	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
monetary_cost 成本权重	配置 WAN Link 的“成本权重”属性。	按需填写	数字；范围：0–不限	0	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
capacity_up_bps 上行容量	定义上行容量，供容量校验、路径选择或整形使用。	按需填写	数字；单位：Mbps；范围：0–不限	0	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
capacity_down_bps 下行容量	定义下行容量，供容量校验、路径选择或整形使用。	按需填写	数字；单位：Mbps；范围：0–不限	0	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
mtu MTU	配置 WAN Link 的“MTU”属性。	按需填写	数字；范围：1280–9216	1500	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
internet_egress 可用作互联网出口	配置 WAN Link 的“可用作互联网出口”属性。	按需填写	开关	开启	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
relay_allowed 允许 Relay	控制是否允许 Relay；开启前确认依赖和对现网流量的影响。	按需填写	开关	关闭	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
management 管理链路	配置 WAN Link 的“管理链路”属性。	按需填写	开关	关闭	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。

Tunnel（tunnels）

作用： 连接两个 Edge/WAN 端点并承载 Overlay 前缀。

前置条件： 两端 Edge 与 WAN Link 均应存在且可达。

标准操作： 在对应资源列表选择“新建”，完成必填字段后保存 Draft；返回列表检查状态，再进入变更发布流程。编辑时先读取最新版本，出现并发冲突不要强制覆盖。

设置项	作用	何时填写	格式/单位	默认行为	依赖关系	保存后的影响与风险
local_edge_id 本端 Edge	配置 Tunnel 的“本端 Edge”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 edges	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
remote_edge_id 对端 Edge	配置 Tunnel 的“对端 Edge”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 edges	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
local_wan_link_id 本端 WAN Link	配置 Tunnel 的“本端 WAN Link”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 wan-links；会按上游选择动态过滤	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
remote_wan_link_id 对端 WAN Link	配置 Tunnel 的“对端 WAN Link”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 wan-links；会按上游选择动态过滤	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
admin_state 管理状态	决定配置是否允许参与运行；关闭只保留配置。	创建时必填	单选；可选：Up（up）、Down（down）	up	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
local_addresses 本端 Overlay 地址	填写本端 Overlay 地址，用于确定匹配、监听或转发的网络范围；必须与实际地址规划一致。	按需填写	列表	空列表	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
remote_addresses 对端 Overlay 地址	填写对端 Overlay 地址，用于确定匹配、监听或转发的网络范围；必须与实际地址规划一致。	按需填写	列表	空列表	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
allowed_prefixes 允许前缀	填写允许前缀，用于确定匹配、监听或转发的网络范围；必须与实际地址规划一致。	按需填写	列表	空列表	无显式依赖	高风险网络设置；保存为 Draft 后必须 Dry-run、审批并在维护窗口发布。
mtu MTU	配置 Tunnel 的“MTU”属性。	按需填写	数字；范围：1280–9000	1380	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
persistent_keepalive Persistent Keepalive	控制Persistent Keepalive，直接影响故障检测、恢复速度或缓存行为。	按需填写	数字；单位：秒；范围：0–65535	25	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
provider 服务商	配置 Tunnel 的“服务商”属性。	按需填写	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
srlg SRLG	配置 Tunnel 的“SRLG”属性。	按需填写	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
cost 路径成本	配置 Tunnel 的“路径成本”属性。	按需填写	数字；范围：0–不限	0	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。

Topology Profile（topology-profiles）

作用： 定义 Full-mesh、Hub-spoke 或区域拓扑以及隧道容量约束。

前置条件： 先确认 Edge 数量、Hub 候选和每站点容量。

标准操作： 在对应资源列表选择“新建”，完成必填字段后保存 Draft；返回列表检查状态，再进入变更发布流程。编辑时先读取最新版本，出现并发冲突不要强制覆盖。

设置项	作用	何时填写	格式/单位	默认行为	依赖关系	保存后的影响与风险
name 名称	供操作者识别资源；应使用稳定、可搜索且能体现地点或用途的名称。	创建时必填	单行文本；最长 128 字符	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
mode 拓扑模式	选择拓扑模式，决定该资源在匹配或异常时采取的行为。	创建时必填	单选；可选：Full Mesh（full-mesh）、Hub Spoke（hub-spoke）、Regional Mesh（regional-mesh）、Custom（custom）	full-mesh	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
hub_edge_ids Hub Edge	配置 Topology Profile 的“Hub Edge”属性。	创建时必填；仅当 mode 满足条件时显示	多个关联资源；项目数：1–不限	空列表	依赖 edges；受 mode 控制	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
maximum_tunnels_per_edge 每个 Edge 最大 Tunnel	设置每个 Edge 最大 Tunnel的边界，用于防止资源耗尽或定义健康条件。	创建时必填	数字；范围：1–200	32	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
paths_per_edge_pair 每对 Edge 路径数	配置 Topology Profile 的“每对 Edge 路径数”属性。	按需填写	数字；范围：1–不限	2	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
minimum_providers 最少服务商数	配置 Topology Profile 的“最少服务商数”属性。	按需填写	数字；范围：1–不限	1	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
minimum_srlgs 最少 SRLG 数	配置 Topology Profile 的“最少 SRLG 数”属性。	按需填写	数字；范围：1–不限	1	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
allow_relay 允许 Relay	控制是否允许 Relay；开启前确认依赖和对现网流量的影响。	按需填写	开关	关闭	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。

Probe Profile（probe-profiles）

作用： 定义健康探测方式、间隔、超时和抖动窗口。

前置条件： 先确定业务可接受的检测与恢复时间。

标准操作： 在对应资源列表选择“新建”，完成必填字段后保存 Draft；返回列表检查状态，再进入变更发布流程。编辑时先读取最新版本，出现并发冲突不要强制覆盖。

设置项	作用	何时填写	格式/单位	默认行为	依赖关系	保存后的影响与风险
name 名称	供操作者识别资源；应使用稳定、可搜索且能体现地点或用途的名称。	创建时必填	单行文本	空；不启用可选能力	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
type 探测类型	配置 Probe Profile 的“探测类型”属性。	创建时必填	单选；可选：Tunnel Liveness（tunnel-liveness）、Tunnel Quality（tunnel-quality）、Destination（destination）	tunnel-quality	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
interval_ns 探测间隔	控制探测间隔，直接影响故障检测、恢复速度或缓存行为。	创建时必填	时长；单位：毫秒；范围：100–60000	1000000000	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
timeout_ns 超时	控制超时，直接影响故障检测、恢复速度或缓存行为。	创建时必填	时长；单位：毫秒；范围：1–不限	500000000	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
fail_after 连续失败阈值	设置连续失败阈值的边界，用于防止资源耗尽或定义健康条件。	按需填写	数字；范围：1–不限	3	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
recover_after 连续恢复阈值	设置连续恢复阈值的边界，用于防止资源耗尽或定义健康条件。	按需填写	数字；范围：1–不限	3	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
dscp DSCP	配置 Probe Profile 的“DSCP”属性。	按需填写	数字；范围：0–63	0	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
window_size 统计窗口	控制统计窗口，直接影响故障检测、恢复速度或缓存行为。	按需填写	数字；范围：3–4096	20	无显式依赖	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。

Relay Assignment（relay-assignments）

作用： 在直连不可用时为一对 Edge 分配合法中继路径。

前置条件： 平台必须先建立 Relay Pool，租户内必须存在对应 Tunnel/Segment。

标准操作： 在对应资源列表选择“新建”，完成必填字段后保存 Draft；返回列表检查状态，再进入变更发布流程。编辑时先读取最新版本，出现并发冲突不要强制覆盖。

设置项	作用	何时填写	格式/单位	默认行为	依赖关系	保存后的影响与风险
relay_pool_id Relay 候选	仅展示当前租户获授权且满足源/目标拓扑和预留容量的候选。	创建时必填	单行文本	空；不启用可选能力	候选来自平台 Relay Pool	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
source_edge_id 源 Edge	配置 Relay Assignment 的“源 Edge”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 edges	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
destination_edge_id 目标 Edge	配置 Relay Assignment 的“目标 Edge”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 edges	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
relay_edge_id Relay Edge（由候选带入）	选择 Relay 候选后自动写入，不能单独修改。	创建时必填	关联资源	空；不启用可选能力	依赖 edges；由 Relay 候选自动带入	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
ingress_tunnel_id 入口 Tunnel	配置 Relay Assignment 的“入口 Tunnel”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 tunnels；会按上游选择动态过滤	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
egress_tunnel_id 出口 Tunnel	配置 Relay Assignment 的“出口 Tunnel”属性。	创建时必填	关联资源	空；不启用可选能力	依赖 tunnels；会按上游选择动态过滤	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
segment_ids Segment	选择流量和路由所在的隔离域。	创建时必填	多个关联资源；项目数：1–不限	空列表	依赖 segments	保存仅产生 Draft；创建并通过 ChangeSet 后才影响数据面。
allowed_prefixes 允许前缀	填写允许前缀，用于确定匹配、监听或转发的网络范围；必须与实际地址规划一致。	创建时必填	列表；项目数：1–不限	空列表	无显式依赖	高风险网络设置；保存为 Draft 后必须 Dry-run、审批并在维护窗口发布。
reserved_kbps 预留带宽	定义预留带宽，供容量校验、路径选择或整形使用。	创建时必填	数字；单位：kbps；范围：1–不限	1	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。
candidate_priority 候选优先级	配置 Relay Assignment 的“候选优先级”属性。	按需填写	数字；范围：1–16	1	无显式依赖	错误值可能造成丢包、误切换或容量误判；先按小范围验证。保存先产生 Draft。