---
url: /configuration/networks/members.md
description: 把整口或 VLAN trunk 子口接入网段桥
---

# 成员

`members` 把宿主机现有接口接进网段桥。整口直接归一个网段；trunk 则按网段 ID 创建 VLAN 子口。

```yaml check
networks:
  lab:
    id: 10
    address: [10.10.0.1/24]
    capture: false
    members:
      - eth2
      - trunk: eth1

dns:
  servers:
    default: {type: udp, address: 127.0.0.1:53}
  final: default
```

## 字段

### members

* 类型：接口名或映射的数组。
* 默认：空。
* 行为：字符串 `eth2` 表示整口；`{trunk: eth1}` 表示 `eth1.<id>` VLAN 子口。
* 限制：同一网段不能重复；整口不能同时属于多个网段；成员不能是配置中的另一座桥或 capture 的 lan/wan 口。

### members\[].trunk

* 类型：接口名。
* 必填：映射形式必须写。
* 行为：父口只在子口创建/删除时读取，不会把自己整个接进桥。
* 限制：父口与 ID 生成的子口名必须合法；子口别名和 VLAN 身份会回读确认。

## 说明

::: warning 宿主机接口会被改什么
整口会被设置 `master`；删配置时只解除 `nomaster`，不恢复进桥前的状态。trunk 父口本身不改，mayami 创建/删除带 `mayami:<网段>:trunk` 别名的 VLAN 子口。运行期已有地址、已有其他 master 或承担默认路由的口会被拒绝接入。
:::

运行时创建并插入桥的 veth、tap 不需要写进 `members`。成员 MTU 小于桥 MTU 时记录警告，但不替管理员改成员 MTU。

## 相关

* [网段总览](/configuration/networks/)
* [external](/configuration/networks/external)
