systemd.netdev 中文手册

匹配主机名(hostname)或"machine ID"。 详见 systemd.unit(5) 中的 "ConditionHost=" 选项。

检查系统是否运行在虚拟化环境中， 亦可进一步检查系统是否运行在特定的虚拟化环境中。 详见 "ConditionVirtualization=" 选项(参见 systemd.unit(5) 手册)。

检查是否设置了特定的内核引导选项(若以感叹号(!)开头则表示未设置)。 详见 "ConditionKernelCommandLine=" 选项(参见 systemd.unit(5) 手册)。

检查内核版本(uname -r)是否匹配给定的表达式。 若以感叹号(!)开头则表示不匹配。详见 "ConditionKernelVersion=" 选项(参见 systemd.unit(5) 手册)。

检查是否运行在特定的硬件架构上。 详见 "ConditionArchitecture=" 选项(参见 systemd.unit(5) 手册)。

对虚拟设备的描述

将要创建的虚拟设备的名称。 这是必须设置的选项。

将要创建的虚拟设备的类型。 这是必须设置的选项。 必须设为一个前述"支持的虚拟网络设备类型"表格中"类型"字段的值。

设置虚拟设备的最大传输单元。可以使用以1024为基准的 K, M, G 后缀。 对于 "tun" 或 "tap" 设备来说，此选项不支持在 "[NetDev]" 小节中使用。 正确的做法是在对应的 systemd.network(5) 文件的 "[Link]" 小节中使用。

设置虚拟设备的MAC地址。对于 "tun" 或 "tap" 设备， 此选项不支持在 "[NetDev]" 小节中使用。 正确的做法是在对应的 systemd.network(5) 文件的 "[Link]" 小节中使用。 对于"vlan" 设备，若未设置此项，则从物理接口继承MAC地址。 对于其他虚拟设备来说，若未设置此项，则基于设备名称与 machine-id(5) 生成一个。

根桥(root bridge)/指定桥(designated bridge)每隔多少秒发送一次"Hello包"。 根桥(Root Bridge)使用"Hello包"通告整个桥接局域网中的所有其他网桥："我是根桥"。 指定桥(designated bridge)是到根桥累计路径花费最小的网桥， 负责收发本网段数据，并且随时准备接替失效的根桥(Root Bridge)。

"Hello包"的最长有效期，必须大于 HelloTimeSec= 值。 从收到最后一个"Hello包"开始计时，如果超过此处设置的时间仍未收到根桥发出的"Hello包"， 那么指定桥(designated bridge)将会接替失效的根桥(Root Bridge)， 并使用"Hello包"通告整个桥接局域网中的所有其他网桥："我是根桥"。

从监听与学习状态切换为转发状态前 延迟多少秒

从某MAC地址收到数据包之后， 将在转发数据库中保留此MAC地址多长时间。

该桥的优先级。必须是一个 0 到 65535 之间的整数。 数字越小优先级越高。优先级最低的桥将被选为"根桥"。

接受一个以正整数形式表示的16位掩码， 以允许转发带有 802.1D 保留地址(01:80:C2:00:00:0X)的本地链路帧。 具体算法是使用"AND"逻辑计算指定掩码与 2^X 的幂(其中"X"是MAC地址最后一个字节的低半截)。 例如将此选项设为 8 表示 允许将帧地址转发到 01:80:C2:00:00:03 (802.1X PAE)

新增端口的默认 VLAN ID ， 可设为 1–4094 之间的一个整数，或者特殊值 "none" 表示禁用 PVID

控制内核 IFLA_BR_MCAST_QUERIER 属性的布尔值。 设为 yes 表示允许内核从一个全零源地址发送常规ICMP查询(也就是允许ICMP组播)。 此特性可以加速网络启动时的聚合(convergence)， 但却会导致某些理解组播的交换机作出错误行为以及胡乱转发ICMP组播包。 若未设置，则使用内核的默认值。

控制内核 IFLA_BR_MCAST_SNOOPING 属性的布尔值。 设为 yes 表示启用 IGMP snooping 监控主机与组播路由(multicast router)之间的IGMP(Internet Group Management Protocol)流量。 若未设置，则使用内核的默认值。

控制内核 IFLA_BR_VLAN_FILTERING 属性的布尔值。 设为 yes 表示以 VLAN-filtering 模式启动网桥。若未设置，则使用内核的默认值。

控制是否使用生成树协议(Spanning Tree Protocol)的布尔值。 若未设置，则使用内核的默认值。

使用的 VLAN ID ，必须是一个 0 ~ 4094 之间的整数。 这是必须设置的选项。

是否支持通用VLAN注册协议(Generic VLAN Registration Protocol)。 该协议允许自动学习网络上的各个 VLAN 。接受一个布尔值。 若未设置，则使用内核的默认值。

是否支持多VLAN注册协议(Multiple VLAN Registration Protocol)。 该协议是一个标准的二层协议，以前被称为 GVRP(GARP VLAN Registration Protocol)，用于自动配置交换机上的 VLAN 。 它最初由 802.1ak 定义，后来被 802.1Q-2005 进行了修正。 接受一个布尔值。若未设置，则使用内核的默认值。

是否支持 VLAN 松散绑定模式。 该模式仅从父级向关联的VLAN传递操作状态，但是VLAN设备的状态保持不变。 接受一个布尔值。若未设置，则使用内核的默认值。

接受一个布尔值，设为 yes 表示让 VLAN 设备表现的像一个真正的物理设备一样。 若未设置，则使用内核的默认值。

要使用的 MACVLAN 模式。可设为 "private", "vepa", "bridge", "passthru" 之一。

要使用的 IPVLAN 模式。可设为 "L2","L3", "L3S" 之一。

要使用的 IPVLAN 标记。可设为 "bridge","private", "vepa" 之一。

VXLAN 网络标识符(VXLAN Segment ID) 。取值范围是 1-16777215 。

目标IP地址

本地IP地址

vxlan 接口的服务类型(Type Of Service)字段的值(一个字节)。

vxlan 数据包的生存期(Time To Live)字段的值(允许的跳数)。 一般设为一个 0–255 之间的整数(特殊值 0 表示继承内部协议的 TTL 值)。 特殊值 "inherit" 表示继承外部协议的 TTL 值。

接受一个布尔值。设为 yes 表示允许动态MAC地址学习， 从而允许发现远端的MAC地址。

内核学习到的转发数据库(Forwarding Database)记录的 生存期(秒数)。

转发数据库(Forwarding Database)允许容纳的最大记录数量。

接受一个布尔值。设为 yes 表示允许桥接的 VXLAN 隧道端点代替远程的 DVOE(Distributed Overlay Virtual Ethernet)客户端 应答来自本地网桥的ARP请求。默认值为 no 。 [译者注]DVOE隧道协议是IBM专有的分布式虚拟以太网技术，使用VXLAN帧格式进行封装， 优点是不需要底层物理设备支持组播。

接受一个布尔值。设为 yes 表示 开启二层 LLADDR 缓存未命中通知。

接受一个布尔值。设为 yes 表示 开启三层 IP 地址未命中通知。

接受一个布尔值。设为 yes 表示 开启路由短路(route short circuiting)。

接受一个布尔值。设为 yes 表示开启计算 VXLAN/IPv4 UDP 校验和。

接受一个布尔值。设为 yes 表示开启发送 VXLAN/IPv6 零校验和(也就是不计算校验和)。

接受一个布尔值。设为 yes 表示开启接收 VXLAN/IPv6 零校验和(也就是不计算校验和)。

接受一个布尔值。设为 yes 表示开启远程传递 VXLAN 校验和减负(checksum offload)。

接受一个布尔值。设为 yes 表示开启远程接收 VXLAN 校验和减负(checksum offload)。

接受一个布尔值。设为 yes 表示开启横跨网络节点的组策略扩展安全标签机制。 详见 VXLAN Group Policy 文档。默认值是 no 。

默认UDP目标端口(基于每个设备)。 若未设置或者设为空字符串， 则表示使用Linux内核默认值 4789 。 应该设为 4789 以遵循 IANA 分配的标准值。

允许使用的UDP源端口范围。 接收端可以根据不同的UDP源端口值， 对 VXLAN 流进行负载均衡。 默认允许使用全部的常规UDP源端口， 但可以使用此选项限制允许使用的UDP源端口范围。

传出数据包的流标签。 取值范围是 0-1048575 。

虚拟网络标识符(VNI, Virtual Network Identifier)。取值范围是 0-16777215 。这是一个必需设置的选项。

传出数据包的单播目标IP地址

传出数据包中服务类型(Type Of Service)字段的值。取值范围是 1-255 。

传出数据包中生存期(Time To Live)字段的值(允许的跳数)。取值范围是 1-255 。

接受一个布尔值。设为 yes 表示计算 IPv4 UDP 校验和。

接受一个布尔值。设为 yes 表示不计算 IPv6 UDP 校验和。

接受一个布尔值。设为 yes 表示允许传入的 IPv6 UDP 数据包不含校验和(校验和字段为全零)。

UDP目标端口。 若未设置或者设为空字符串，则表示使用默认值 6081 。

传出数据包的流标签

隧道数据包使用的静态本地地址。 它必须是本机另一个接口上的地址。

隧道的远程端点

隧道接口的服务类型(Type Of Service)字段的值。 有关TOS的详细解释可参见 Type of Service in the Internet Protocol Suite 文档。

隧道数据包中生存期(Time To Live)字段的值(允许的跳数)。 一般设为一个 0–255 之间的整数(特殊值 0 表示继承 TTL 值)。 IPv4 隧道的默认值是零(继承)、 IPv6 隧道的默认值是 64 。

接受一个布尔值。设为 yes 表示 为隧道开启路径MTU发现(自动探测路径中的最大传输单元，避免IP分片)。

IPv6头(see RFC 2460)中 流标签(see RFC 6437)字段的值(20-bit)。 节点使用流标签来标记某个流中的所有数据包。 此选项仅对IPv6隧道有意义。 将流标签设为零表示 数据包尚未被标记。 取值范围是 0–0xFFFFF 之间的一个整数。 特殊值 "inherit" 表示使用原来的流标签。

接受一个布尔值。 设为 yes 表示在IPv6隧道数据包解封过程中， 差分服务码点 DSCP(Differentiated Service Code Point) 字段将从外部头复制到内部头。 DSCP 是IP数据包头中的一个字段，用于为不同的网络流分配不同的服务级别(类似于优先级)， 主要用于提供 QoS 支持。默认值是 "no" [推荐阅读]DSCP与IP优先级

设置隧道数据包"Tunnel Encapsulation Limit"选项的值， 也就是限制最多允许对隧道数据包进行多少次嵌套封装。 数据包的"Tunnel Encapsulation Limit"选项值为 0 ， 表示 该数据包在退出当前隧道之前不能进入另一个隧道(详见 RFC 2473)。 取值范围是 0–255 与特殊值 "none" ，默认值是 4 。

一次性为 InputKey= 与 OutputKey= 选项指定同一个"Key"。 Key= 的值可以是一个数字或 IPv4 地址那样的点分四元组。 It is used as mark-configured SAD/SPD entry as part of the lookup key (both in data and control path) in ip xfrm (framework used to implement IPsec protocol). 详见 ip-xfrm — transform configuration 手册。 此选项仅用于 VTI/VTI6 隧道(思科私有技术)。

指定用于输入的"Key"。选项值与 Key= 相同。 此选项仅用于 VTI/VTI6 隧道(思科私有技术)。

指定用于输出的"Key"。选项值与 Key= 相同。 此选项仅用于 VTI/VTI6 隧道(思科私有技术)。

"ip6tnl" 隧道可以使用下列三种模式之一： "ip6ip6"(IPv6 over IPv6)、 "ipip6"(IPv4 over IPv6)、 "any"(两者之中任意一个)。

接受一个布尔值。设为 yes 表示隧道不需要 .network 文件，直接创建为 "tunnel@NONE"。 默认值为 "false" 。

接受一个布尔值。设为 yes 表示允许在 ip6tnl 设备上传输远程端点为本机地址的隧道流量。 若未设置则表示使用内核默认值。

接受一个布尔值。表示是否配置 FooOverUDP= 隧道。 默认值为 no 。详见 Foo over UDP

封装所使用的UDP目标端口。 这是必须设置的选项，并且没有默认值。

封装所使用的UDP源端口。默认值 0 表示由网络栈自行决定。

与 "[FooOverUDP]" 小节中的同名选项接受的值完全相同。

为在IPv4上快速部署IPv6(又称 6rd)重新配置隧道。 此选项的值是由ISP分配的IPv6前缀。 此选项仅用于 SIT 隧道。

接受一个布尔值。设为 yes 表示将隧道配置为 ISATAP(Intra-Site Automatic Tunnel Addressing Protocol)隧道。 此选项仅用于 SIT 隧道。若未设置则表示使用内核默认值。

接受一个布尔值。设为 yes 表示隧道数据包将被串行化(数据包之间不会出现乱序)。此选项仅用于 ERSPAN 隧道。 若未设置则表示使用内核默认值。

设置接口的 ERSPAN 索引字段的值(一个与 ERSPAN 流量的源端口和方向关联的整数)， 必须设为一个 1-1048575 范围内的整数。这是一个必需设置的选项。

指定到达UDP端口的数据包的协议号。必须设为一个 1-255 范围内的整数。 这是必须设置的选项，并且没有默认值。

指定在UDP数据包中存储各种网络协议数据包的封装机制。可以设为如下值： "FooOverUDP" 提供了最简单的、无修饰的 UDP 封装机制， 也就是简单地将数据包直接封装在UDP负载中。 "GenericUDPEncapsulation" 是一种通用的可扩展封装机制， 允许对任何IP协议数据包及可选数据(作为封装的一部分)进行封装。 详见 Generic UDP Encapsulation 文档。 默认值为 "FooOverUDP"

指定IP封装数据包的目标端口。注意，数据包在到达目的地前，将被首先剥除外层封装， 然后再被手工反馈进入网络堆栈，并提前发送到实际目的地。 这是必须设置的选项。

创建此以太网隧道时所使用的网口名称。 这是必须设置的选项。

peer 的MAC地址。 若未设置， 则自动生成一个(生成方法与上文 [NetDev] 小节中的 MACAddress= 选项相同)。

创建虚拟网络设备时使用的对等接口名称。 这是必须设置的选项。

设为 yes 表示 将所有数据包都排入该设备的队列。 默认值 no 表示 仅允许将固定数量的数据包排入该设备的队列， 而其余的数据包则全部排入 "qdisc" 队列。

设为 yes 表示 使用多个文件描述符(队列)并行处理数据包的发送与接收。 默认值 no 表示 仅使用一个文件描述符(队列)处理数据包的发送与接收。

设为 yes 表示 给数据包预先填充四个额外的字节 (两个标记字节、两个协议字节)。 默认值 no 表示不填充， 也就是将数据包视为纯粹的IP包。

设为 yes 表示 为 tap 设备开启 IFF_VNET_HDR 标记， 以允许发送与接收更大的 GSO(Generic Segmentation Offload)包， 从而可以显著提升吞吐量。 默认值 no 表示 关闭 IFF_VNET_HDR 标记。

设置 /dev/net/tun 设备的属主

设置 /dev/net/tun 设备的属组

接口的私钥(经过 Base64 编码)。 使用 wg genkey 命令生成(参见 wg(8) 手册)。 这是必须设置的选项。 注意，因为这是秘密信息，必须严防外泄， 所以务必将 .netdev 文件的所有者设为 "root:systemd-network" 并将文件权限设为 "0640" 。

UDP监听端口。 必须设为一个 1-65535 之间的整数，或特殊值 "auto"(表示根据接口名称自动生成)。 默认值为 "auto"

设置传出数据包的防火墙标签。必须设为一个 1-4294967295 之间的整数。

接口的公钥(经过 Base64 编码)。使用 wg pubkey 命令(参见 wg(8) 手册) 从一个给定的私钥生成， 通常通过带外传输给配置文件的作者。 这是必须设置的选项。

接口的预共享密钥。这不是一个必须设置的选项。 使用 wg genpsk 命令生成。 此选项在已经存在的公钥加密中 又额外混合了一个对称加密层， 以抵御今后可能出现的量子计算机破解。 注意，因为这是秘密信息，必须严防外泄， 所以务必将 .netdev 文件的所有者设为 "root:systemd-networkd" 并将文件权限设为 "0640" 。

接受一个 逗号分隔的 IPv4/IPv6 地址(带有CIDR掩码)列表。 表示仅允许与列表中的IP地址建立隧道。 "0.0.0.0/0" 用于匹配所有 IPv4 地址、 "::/0" 用于匹配所有 IPv6 地址。

设置一个 "IP地址:端口"或"主机名:端口"格式的端点。 在配置期间，此端点将会被自动更新为 来自对端已验证数据包的最新源IP地址和端口。

设置一个 1-65535 之间的间隔秒数， 表示每隔多久向对等端发送一个已验证的空数据包， 以确保有状态防火墙或NAT映射持续有效。 例如，位于NAT之后的接口很少发送流量， 但它随时会从对等端接收流量， 如果将保持持久连接的间隔设为25秒， 那么该接口就可以从持久连接的状态中受益。 设为 0 或 "off" 表示禁用持久连接保持。默认值为 off 。 大多数用户不需要这个。

设置网卡绑定模式。 此选项相当于设置 bond 模块的 mode 属性。可用值如下： "balance-rr"(默认值), "active-backup", "balance-xor", "broadcast", "802.3ad", "balance-tlb", "balance-alb"

设置选择 slave 设备时使用的传输哈希策略(分发策略)。 仅对 "balance-xor", "802.3ad", "balance-tlb" 模式有意义。 此选项相当于设置 bond 模块的 xmit_hash_policy 属性。可用值如下： "layer2"(默认值), "layer3+4", "layer2+3", "encap2+3", "encap3+4"

此选项仅对 "802.3ad" 模式有意义。 设置 slave 设备发送LACPDU(Link Aggregation Control Protocol Data Unit)包的频率。 此选项相当于设置 bond 模块的 lacp_rate 属性。可用值如下： "slow" 表示每30秒发送一次LACPDU包； "fast" 表示每一秒发送一次LACPDU包； 默认值是 "slow"

设置监控 MII(Media Independent Interface) 连接的间隔时长，默认单位是毫秒。 此选项相当于设置 bond 模块的 miimon 属性。 设置的值最终会被四舍五入到最接近的毫秒。 默认值"0"表示禁用监控。

当检测到链路处于"Up"状态时，延迟多久再启用它，默认单位是毫秒。 此选项相当于设置 bond 模块的 updelay 属性。 此处设置的值将被向下取整到 MIIMonitorSec= 的整数倍。 默认值是"0"

当检测到链路处于"Down"状态时，延迟多久再禁用它，默认单位是毫秒。 此选项相当于设置 bond 模块的 downdelay 属性。 此处设置的值将被向下取整到 MIIMonitorSec= 的整数倍。 默认值是"0"

此选项仅对 "balance-tlb" 与 "balance-alb" 模式有意义。 设置发送ARP学习包的时间间隔(默认单位是秒)。 此选项相当于设置 bond 模块的 lp_interval 属性。 取值范围是 1–0x7fffffff ；默认值是 1 (秒)。

设置 "802.3ad" 聚合的选择逻辑。 此选项相当于设置 bond 模块的 ad_select 属性。可设为下列值之一： "stable"(默认值), "bandwidth", "count"

设置 "802.3ad" 主机(Actor)系统优先级。此选项相当于设置 bond 模块的 ad_actor_sys_prio 属性。取值范围是 1-65535 ，默认值是 65535 。

设置 "802.3ad" "port-key" 的用户定义部分。此选项相当于设置 bond 模块的 ad_user_port_key 属性。取值范围是 0-1023 ，默认值是 0 。

设置 "802.3ad" 主机(Actor)用于发送LACPDU包的系统MAC地址。不能设为NULL或多播地址。此选项相当于设置 bond 模块的 ad_actor_system 属性。默认值是主机(Actor)的主MAC地址。

此选项仅对 "active-backup" 模式有意义。 相当于设置 bond 模块的 fail_over_mac 属性。 可设为下列值之一： "none"(默认值) 表示在失败切换时，只更改新激活的 slave 的MAC地址，而不更改 bond 的MAC地址。 "active" 表示保持各个 slave 的MAC地址不变，在失败切换时，仅将 bond 的MAC地址修改为新激活的 slave 的MAC地址。 "follow" 表示在失败切换时，不但将新激活的 slave 的MAC地址修改为 bond 的MAC地址，而且将下线的原 slave 的MAC地址修改为新激活的 slave 的原有MAC地址。

此选项相当于设置 bond 模块的 arp_validate 属性。 设置是否应该验证接收到的ARP请求与应答正确性(Validation)， 以及是否应该仅使用接收到的ARP流量进行连接监控(反对这么做)(Filtering)。 可设为下列值之一： "none" 既不 Validation 也不 Filtering ； "active" 仅对处于活动状态的 slave 执行 Validation ； "backup" 仅对处于备用状态的 slave 执行 Validation ； "all" 对所有 slave 执行 Validation ；

设置ARP连接监控的频率(时间间隔)，默认单位是毫秒。 此选项相当于设置 bond 模块的 arp_interval 属性。默认值"0"表示禁用ARP连接监控。

设置当 ARPIntervalSec= 大于零的时候， 用作ARP连接监控目标的IP地址。 要想ARP连接监控正常工作，必须至少设置一个目标IP地址。 此选项相当于设置 bond 模块的 arp_ip_target 属性。 值是一个点分十进制格式表示的IPv4地址。 最多设置16个目标IP地址。 默认值为空。

此选项仅影响 "active-backup" 模式中 开启了 ARPValidate= 的 slave 设备。 设置有多少个用作ARP连接监控目标的IP地址(ARPIPTargets=)可达的时候，一个 slave 设备才会被认为是处于"Up"状态。 此选项相当于设置 bond 模块的 arp_all_targets 属性。可设为下列值之一： "any", "all"

设置重新选择 primary slave 的策略。 此选项的目的在于 防止在 primary slave 与其他 slave 设备之间出现反转。 此选项相当于设置 bond 模块的 primary_reselect 属性。 可设为下列值之一： "always"(默认值), "better", "failure"

发生失败切换事件后，发送多少次IGMP成员报告(membership report)。 此选项相当于设置 bond 模块的 resend_igmp 属性。 发生失败切换事件后会立即发送一次成员报告， 如果此选项大于 1 ，那么随后每隔 200ms 重新发送一次，直到用完所有次数。 取值范围是 0–255 ，默认值是 1 。 0 表示禁止发送IGMP成员报告(membership report)。

设置在同一个 slave 设备上发送多少个包之后就切换到下一个 slave 设备。 此选项相当于设置 bond 模块的 packets_per_slave 属性。 取值范围是 0–65535 ，设为 0 表示随机选择 slave 设备。默认值是 1 。 此选项仅对 "balance-rr" 模式有意义。

发生失败切换事件后， 发送多少次端点通知(无故ARP/主动IPv6邻居通告)。 此选项相当于设置 bond 模块的 num_grat_arp/num_unsol_na 属性。 发生失败切换事件后会立即发送一次端点通知， 如果此选项大于 1 ，那么随后每隔 ARPIntervalSec= 或 MIIMonitorSec= 间隔重新发送一次，直到用完所有次数。取值范围是 0–255 ，0 表示禁止发送，默认值是 1 。 此选项仅对 "active-backup" 模式有意义。

设置应该转发还是丢弃 在不活动端口上接收到的重复帧。 "yes"表示转发。默认值"no"表示丢弃。 通常应该丢弃(也就是设为"no")， 仅在确实知道为什么要转发的时候才需要设为"yes"。 此选项相当于设置 bond 模块的 all_slaves_active 属性。

接受一个布尔值。设置是否允许动态打乱流顺序。此选项仅对 "balance-tlb" 模式有意义。 默认值 yes 表示允许打乱流顺序以获得更好的负载均衡效果，但是会导致数据包的顺序被打乱(需要重排)。此选项相当于设置 bond 模块的 tlb_dynamic_lb 属性。

设置至少有几个 slave 连接已经激活，才能激活上层的 bond 连接。 此选项相当于设置 bond 模块的 min_links 属性。默认值是零。