Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

10.4. 静态网络配置

您可以通过 Assisted Installer web 控制台或 API 为每个主机定义静态网络配置。当您创建新 ISO 或更新现有 ISO 时，辅助安装程序将设置应用到发现 ISO。

在 web 控制台中使用 API 或 YAML 视图时，创建一个或多个 NMState YAML 文件，并将每个主机 MAC 地址映射到其对应的网络接口名称。

Web 控制台中的 Form 视图 不需要这些步骤。

10.4.1. nmstate 配置示例
复制链接

NMState YAML 文件指定主机所需的静态网络配置，包括接口详情、IP 地址、路由和 DNS 设置。Assisted Installer 在主机发现过程中将逻辑接口名称（例如 eth0）替换为实际名称。

以下示例显示了您可以复制和调整的 NMState YAML 配置。有关更多示例，请参阅 NMState 文档。

有关在 Assisted Installer web 控制台或 API 中配置静态网络的详情，请参考"添加资源"。

标准 NMState 配置示例

本例演示了带有默认路由和 DNS 服务器的标准静态网络配置。 

dns-resolver:
  config:
    server:
    - 192.168.126.1
interfaces:
- ipv4:
    address:
    - ip: 192.168.126.30
      prefix-length: 24
    dhcp: false
    enabled: true
  name: eth0
  state: up
  type: ethernet
- ipv4:
    address:
    - ip: 192.168.141.30
      prefix-length: 24
    dhcp: false
    enabled: true
  name: eth1
  state: up
  type: ethernet
routes:
  config:
  - destination: 0.0.0.0/0
    next-hop-address: 192.168.126.1
    next-hop-interface: eth0
    table-id: 254
标记的 VLAN 示例

按如下所示替换标准 YAML 的相关部分，以在物理网络接口(NIC)之上定义标记的 VLAN 接口。

重要

这个示例和下一个示例只显示 YAML 文件的一部分，它不用于原样使用。错误地使用它们可能会导致机器丢失网络连接。 

interfaces:
  - ipv4:
      address:
      - ip: 192.168.143.15
        prefix-length: 24
      dhcp: false
      enabled: true
    ipv6:
      enabled: false
    name: eth0.404
    state: up
    type: vlan
    vlan:
      base-iface: eth0
      id: 404
      reorder-headers: true
网络绑定示例

按如下方式替换标准 YAML 的相关部分，以使用 active-backup 模式为冗余配置网络绑定。 

interfaces:
- ipv4:
    address:
    - ip: 192.168.138.15
      prefix-length: 24
    dhcp: false
    enabled: true
    ipv6:
      enabled: false
    link-aggregation:
      mode: active-backup
      options:
        miimon: "140"
      port:
      - eth0
      - eth1
    name: bond0
    state: up
    type: bond

10.4.2. MAC 到 NIC 映射示例
复制链接

每个主机需要其 MAC 地址和对应网络接口卡(NIC)之间的映射。这个映射有两个主要目的：

  • 要识别应用 YAML 文件的正确节点。
  • 要替换逻辑/临时接口名称，如 eth0 或 ens3，如果 YAML 文件尚未使用物理网络接口名称或 标识符：mac-address。

当使用 Assisted Installer API 进行安装时，您可以在 NMState YAML 文件中定义 MAC-to-NIC 映射配置。

如果您使用 web 控制台的 YAML 视图进行安装，则不需要这个映射。相反，您可以在 MAC 中手动指定到接口名称映射字段的映射。详情请查看 "Additional resources"。

带有逻辑接口名称的 MAC 接口映射示例

在本例中，映射标识节点并替换临时接口名称。

  • YAML 文件： 

    dns-resolver:
  config:
    server:
    - 192.168.126.1
interfaces:
- ipv4:
    address:
    - ip: 192.168.126.30
      prefix-length: 24
    dhcp: false
    enabled: true
  name: eth0
  state: up
  type: ethernet
- ipv4:
    address:
    - ip: 192.168.141.30
      prefix-length: 24
    dhcp: false
    enabled: true
  name: eth1
  state: up
  type: ethernet
routes:
  config:
  - destination: 0.0.0.0/0
    next-hop-address: 192.168.126.1
    next-hop-interface: eth0
    table-id: 254

  • MAC 映射： 

    mac_interface_map: [
    {
      mac_address: 02:00:00:2c:23:a5,
      logical_nic_name: eth0
    },
    {
      mac_address: 02:00:00:68:73:dc,
      logical_nic_name: eth1
    }
]

使用 标识符的 MAC 接口映射示例：mac-address 接口名称

在本例中，NMState YAML 配置包含 标识符：mac-address。这意味着映射只需要指定单个 MAC 地址来识别一个节点。

  • YAML 文件： 

    dns-resolver:
  config:
    server:
    - 192.168.126.1
interfaces:
  - name: eth0
    type: ethernet
    state: up
    identifier: mac-address
    mac-address: 1e:bd:23:e9:fb:94
    ipv4:
      enabled: true
      dhcp: true
    ipv6:
      enabled: true
      dhcp: true
      autoconf: true
routes:
  config:
  - destination: 0.0.0.0/0
    next-hop-address: 192.168.126.1
    next-hop-interface: eth0
    table-id: 254

  • MAC 映射： 

    mac_interface_map: [
    {
      mac_address: 1e:bd:23:e9:fb:95,
      logical_nic_name: test
    },
]
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2026 Red Hat返回顶部