CSR配置字典之EthGroup类
更新时间： 2026/05/11
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | EthGroup类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2026/05/11 |
| 最后更新 | 2026/05/11 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026/05/11 | 初始版本 | 创建EthGroup类配置字典 | 全新文档 | bmc_network组件组 |
🎯 类概览
EthGroup 类
| 属性 | 值 |
|---|---|
| 类名称 | EthGroup |
| 功能描述 | 网口组配置管理，支持组ID、名称、网口、VLAN、IP地址等配置 |
| 所属SIG组 | hardware |
| 所属组件 | bmc_network |
| 责任人 | 基础服务组 |
| 最后更新 | 2026/05/11 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
EthGroup 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
GroupId | U8 | - | U8 | - | 网口组ID | 配置组ID | 9 | CSR | 软件 |
Name | String | - | String | - | 网口组名称 | 配置组名称 | "VethGroup" | CSR | 软件 |
ActiveEthId | U8 | - | U8 | - | 当前激活的网口号，例如eth2的话此处网口号为2 | 配置激活网口 | 2 | CSR | 软件 |
VLANId | U16 | - | [1, 4094] | - | VLANId，0表示VLAN关闭，反之为开启，范围为1-4094 | 配置VLAN | 2 | CSR | 软件 |
VLANEnabled | Boolean | - | true/false | - | VLAN使能状态 | 配置VLAN使能状态 | true | CSR | 软件 |
IpPolicy | U8 | - | U8 | - | ip生成策略：0：根据默认IP地址,1：根据槽位和基准IP地址生成 | 配置策略 | 0 | CSR | 软件 |
AssociatedPortType | U8 | - | U8 | - | 网口组关联的网口类型，1：NCSI port；2：DEDICATED port | 配置网口类型 | 1 | CSR | 软件 |
Channel | U8 | - | U8 | - | 网口对应lan通道的channel number | 配置通道 | 1 | CSR | 软件 |
NetMode | U8 | - | U8 | - | 网口组关联的网口类型，1：NCSI port；2：DEDICATED port | 配置网口组关联的网口类型 | 1 | CSR | 软件 |
Status | Boolean | - | Boolean | - | 该IP是否在工作状态中 | 监控该IP是否在工作状态中 | true | CSR | 软件 |
OutType | U8 | - | U8 | - | 网口组的类型:1:对内,2:对外,3:veth,4:计算节点近端维护内部网络,5:计算节点近端维护外出网络,6:SMM板浮动IP网络,7:SMM板出对板的内部网络,8:专用网口近端运维网络,9:机柜管理板内网,10: 机柜节点内网 | 配置网口组的类型 | 7 | CSR | 软件 |
EthGroup 类 - 可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
EthAlias | U8 | 255 | U8 | - | 激活网口别名，有别名时取值最大为254，255表示没有别名网口 | 配置激活网口别名 | 3 | CSR | 软件 |
IpMode | String | "Static" | "DHCP"/"Static" | - | IPv4模式(DHCP/Static),默认配置Static式 | 配置IPv4模式 | "Static" | CSR | 软件 |
Ipv6Mode | String | "Static" | "DHCP"/"Static" | - | IPv6地址，DHCPv6:自动获取,Static:手动配置,默认配置Static | 配置IPv6模式 | "DHCPv6" | CSR | 软件 |
InnerNetWork | String | - | String | - | 内网网络标识 | 配置内网 | - | CSR | 软件 |
IpAddr | String | - | String | - | IPv4地址 | 配置IPv4地址 | "0.0.0.0" | CSR | 软件 |
BaseIpAddr | String | - | String | - | 基准IPv4地址,和IpAdd作比较，判断是否根据槽位号生成过Ip | 配置基准IP | - | CSR | 软件 |
SubnetMask | String | - | String | - | 子网掩码 | 配置掩码 | "255.255.255.0" | CSR | 软件 |
DefaultGateway | String | - | String | - | IPv4网关 | 配置IPv4网关 | "0.0.0.0" | CSR | 软件 |
BackupIpAddr | String | - | String | - | 备份IPv4地址 | 配置备份IPv4地址 | "0.0.0.0" | CSR | 软件 |
BackupSubnetMask | String | - | String | - | 备份IPv4子网掩码 | 配置备份IPv4子网掩码 | "255.255.255.0" | CSR | 软件 |
Ipv6Addr | String | - | String | - | 当前网口的IPv6地址 | 配置当前网口的IPv6地址 | - | CSR | 软件 |
PrefixLength | S32 | - | S32 | - | 当前网口的Ipv6前缀长 | 配置当前网口的Ipv6前缀长 | 64 | CSR | 软件 |
Ipv6DefaultGateway | String | - | String | - | 当前网口的Ipv6默认网关 | 配置当前网口的Ipv6默认网关 | - | CSR | 软件 |
BFDEnable | Boolean | true | true/false | - | 内网是否使用BFD检测 | 配置BFD开关 | true | CSR | 软件 |
📝 配置示例
网口组配置
json
{
"EthGroup": {
"GroupId": "group1",
"Name": "PrimaryGroup",
"ActiveEthId": "eth0",
"VLANEnabled": false,
"IpMode": "Static",
"IpAddr": "0.0.0.0",
"SubnetMask": "255.255.255.0",
"DefaultGateway": "0.0.0.0",
"NetMode": "Fixed",
"Channel": 1,
"BFDEnable": true,
}
}🔧 使用指南
配置步骤
配置组标识：设置 GroupId、Name 确定网口组
配置网络参数：设置 IpMode、IpAddr、SubnetMask、DefaultGateway
配置VLAN：设置 VLANEnabled 和 VLANId
配置IPv6：设置 Ipv6Mode、Ipv6Addr、PrefixLength
配置BFD：设置 BFDEnable 控制双向转发检测
注意事项
BFDEnable=true 时启用BFD检测，用于快速检测链路故障
网口组内的所有网口共享相同的网络配置
IpMode 和 NetMode 需要匹配使用场景
故障排查
BFD检测失败：检查 BFDEnable 配置和BFD服务状态
网口组通信异常：检查 IpAddr、SubnetMask、DefaultGateway 配置