📋 文档信息

项目	内容
文档标题	EthernetInterfaces类配置字典
版本	v1.0
创建日期	2026/05/11
最后更新	2026/05/11
维护状态	✅ 活跃维护

📋 变更历史记录

文档变更记录

版本	发布日期	变更类型	变更内容	影响范围	维护人员
v1.0	2026/05/11	初始版本	创建EthernetInterfaces类配置字典	全新文档	bmc_network组件组

🎯 类概览

EthernetInterfaces 类

属性	值
类名称	`EthernetInterfaces`
功能描述	以太网接口综合配置管理，支持网络模式、MAC地址、NCSI、VLAN、端口等配置
所属SIG组	hardware
所属组件	bmc_network
责任人	基础服务组
最后更新	2026/05/11
状态	🟢 正常运行

📊 属性定义详表

EthernetInterfaces 类 - 必选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`Id`	String	-	String	-	以太网接口标识	配置接口ID	`"eth0"`	CSR	软件
`EthName`	String	-	String	-	以太网接口名称	配置网口名称	`"eth2"`	CSR	软件
`NetMode`	String	-	"Fixed"/"Automatic"	-	网络模式	配置网络模式	`"Fixed"`	CSR	软件
`Mac`	String	-	String	-	MAC地址	配置MAC地址	`"22:22:22:22:22:22"`	CSR	软件
`IpVersion`	String	-	"IPv4"/"IPv6"/"IPv4AndIPv6"	-	IP协议类型	配置IP协议类型	`"IPv4AndIPv6"`	CSR	软件
`NcsiEnable`	Boolean	-	true/false	-	NCSI使能状态	配置NCSI使能状态	`true`	CSR	软件
`PortId`	U8-	-	U8	-	当前激活端口	配置当前激活端口	`1`	CSR	软件
`VLANId`	U16	-	U16	-	VLAN ID	配置VLAN ID	`1`	CSR	软件
`DefaultFactoryIpMode`	String	-	"Static"/"DHCP"	-	出厂默认IPv4模式	配置出厂默认IPv4模式	`"Static"`	CSR	软件
`DefaultFactoryIpv6Mode`	String	-	"Static"/"DHCPv6"	-	默认出厂IPV6模式	配置出厂IPV6	`"DHCPv6"`	CSR	软件
`DefaultFactoryIpVersion`	String	-	"IPv4"/"IPv6"/"IPv4AndIPv6"	-	出厂默认网络模式	配置出厂默认网络模式	`"IPv4AndIPv6"`	CSR	软件
`Ipv6DynamicRouteRAPreferred`	Boolean	-	true/false	-	是否使用RA报文前缀和长度替代IPv6动态路由信息	配置是否使用RA报文前缀和长度替代IPv6动态路由信息	`true`	CSR	软件
`DedicatedSupported`	Boolean	-	true/false	-	单板是否支持专用网口	配置单板是否支持专用网口	`true`	CSR	硬件
`NcsiEthNum`	U8	-		U8	该网卡端口的NCSI连接的Eth口，如，0：表示连接在Eth0上 1：表示连接在Eth1上	配置网卡端口的NCSI连接的Eth口	`1`	CSR	硬件
`AggregationSupported`	Boolean	-	true/false	-	单板是否支持网络汇聚功能	配置单板是否支持网络汇聚功能	`true`	CSR	硬件
`DedicatedVlanSupported`	Boolean	-	true/false	-	单板是否支持专用网口VLAN的功能	配置单板是否支持专用网口VLAN的功能	`true`	CSR	硬件
`NcsiPowerDomain`	U8	-	U8	-	当前NCSI绑定的网卡的电源域，0:Standby, 1:Vcc	配置当前NCSI绑定的网卡的电源域	`0`	CSR	硬件

EthernetInterfaces 类 - 可选属性

属性名	类型	默认值	取值范围	动态关联	描述	使用场景	举例	来源	分类
`MasterSmmLinkNetId`	U8	1	1：SMM1，2：SMM2	-	机框平面主板使用的链路	配置机框平面主板使用的链路	`1`	CSR	软件
`LinkLocalAddress`	String[]	-	String[]	-	SLAAC地址	配置SLAAC地址	`"0:0:0:0:0:0:0:0/64"`	CSR	软件
`DefaultFactoryIpAddr`	String	-	String	-	默认出厂IPV4地址	配置默认出厂IPV4地址	`0.0.0.0`	CSR	软件
`DefaultFactoryIpv6Addr`	String	-	String	-	默认出厂IPV6地址	配置出厂IPV6	`"0:0:0:0:0:0:0:0"`	CSR	软件
`Status`	Boolean	true	Boolean	-	该IP是否在工作状态中	配置该IP是否在工作状态中	`true`	CSR	软件
`Channel`	U8	1	U8	-	网口对应lan通道的channel number	配置通道号	`1`	CSR	软件
`MinVLANId`	U16	1	U16	-	VLAN取值范围下限值	配置VLAN范围下限值	`1`	CSR	软件
`MaxVLANId`	U16	4094	U16	-	VLAN取值范围上限值	配置VLAN范围上限值	`4094`	CSR	软件
`MTUSize`	U16	1500	[576, 9000]	-	最大传输单元大小	配置MTU	`1500`	CSR	软件

📝 配置示例

以太网接口配置

json

{
  "EthernetInterfaces": {
    "Id": "eth0",
    "NetMode": "Fixed",
    "Mac": "00:00:00:00:00:00",
    "IpVersion": "IPv4AndIPv6",
    "NcsiEnable": true,
    "PortId": 1,
    "Status": true,
    "Channel": 1,
    "VLANEnable": false,
    "VLANId": 1,
    "LinkLocalAddress": "",
    "DefaultFactoryIpAddr": "",
    "DedicatedSupported": true,
    "DefaultFactoryIpMode": "DHCP",
    "DefaultFactoryIpv6Mode": "DHCPv6",
    "NcsiEthNum": 0,
    "AggregationSupported": true,
    "DedicatedVlanSupported": true,
    "NcsiPowerDomain": 1s
  }
}

🔧 使用指南

配置步骤

配置网口标识：设置 Id 和 EthName 确定接口
配置网络模式：设置 NetMode 和 IpVersion
配置VLAN：设置 VLANEnable、VLANId、MinVLANId、MaxVLANId
配置NCSI：设置 NcsiEnable 和 PortId
配置MTU：设置 MTUSize 控制最大传输单元

注意事项

MTU 默认值为 1500，可根据网络环境调整
VLAN ID 范围为 1-4094
NCSI 模式下需要配置 PortId
MAC 地址需要全局唯一

故障排查

网口不通：检查 Status、NetMode、IpVersion 配置
VLAN 配置失败：检查 VLANId 是否在 MinVLANId 和 MaxVLANId 范围内
MTU 问题：检查 MTUSize 是否适合当前网络环境

📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

EthernetInterfaces 类 ​

📊 属性定义详表 ​

EthernetInterfaces 类 - 必选属性 ​

EthernetInterfaces 类 - 可选属性 ​

📝 配置示例 ​

以太网接口配置 ​

🔧 使用指南 ​

配置步骤 ​

注意事项 ​

故障排查 ​

📋 文档信息

📋 变更历史记录

文档变更记录

🎯 类概览

EthernetInterfaces 类

📊 属性定义详表

EthernetInterfaces 类 - 必选属性

EthernetInterfaces 类 - 可选属性

📝 配置示例

以太网接口配置

🔧 使用指南

配置步骤

注意事项

故障排查