网络基础知识 /etc/config/network

• 这是一个典型家庭路由器的默认OpenWrt网络堆栈
• 您的设备可能在功能或方案数值上略有不同
• 注意，标签“WAN”和“LAN”的含义可能不同，这取决于它们的上下文

中央网络配置由uci network 子系统处理, 存储在文件 /etc/config/network中. uci子系统负责定义 switch VLANs, interface configurations 和 network routes.

在任何网络配置更改(通过uci或其他方式)之后，你需要输入以下内容来重载网络配置:

service network reload

如果您安装的版本没有提供service命令，则可以使用:

/etc/init.d/network reload

多亏了netifd (网络接口守护进程), 更改后的接口将自动重启生效。 重启路由器不是必须的，但这也是强制配置重载的另一种方式。

这是一个TL-WR1043ND的默认network uci子系统配置示例

# uci show network
network.loopback=interface
network.loopback.ifname='lo'
network.loopback.proto='static'
network.loopback.ipaddr='127.0.0.1'
network.loopback.netmask='255.0.0.0'
network.globals=globals
network.globals.ula_prefix='fd27:70fa:5c1d::/48'
network.lan=interface
network.lan.type='bridge'
network.lan.ifname='eth0.1'
network.lan.proto='static'
network.lan.netmask='255.255.255.0'
network.lan.ip6assign='60'
network.lan.ipaddr='192.168.1.1'
network.wan=interface
network.wan.ifname='eth0.2'
network.wan.proto='dhcp'
network.wan6=interface
network.wan6.ifname='eth0.2'
network.wan6.proto='dhcpv6'
network.@switch[0]=switch
network.@switch[0].name='switch0'
network.@switch[0].reset='1'
network.@switch[0].enable_vlan='1'
network.@switch_vlan[0]=switch_vlan
network.@switch_vlan[0].device='switch0'
network.@switch_vlan[0].vlan='1'
network.@switch_vlan[0].ports='1 2 3 4 5t'
network.@switch_vlan[1]=switch_vlan
network.@switch_vlan[1].device='switch0'
network.@switch_vlan[1].vlan='2'
network.@switch_vlan[1].ports='0 5t'

会生成如下配置在文件 /etc/config/network中

# cat /etc/config/network
 
config interface 'loopback'
        option ifname 'lo'
        option proto 'static'
        option ipaddr '127.0.0.1'
        option netmask '255.0.0.0'
 
config globals 'globals'
        option ula_prefix 'fd27:70fa:5c1d::/48'
 
config interface 'lan'
        option type 'bridge'
        option ifname 'eth0.1'
        option proto 'static'
        option netmask '255.255.255.0'
        option ip6assign '60'
        option ipaddr '192.168.1.1'
 
config interface 'wan'
        option ifname 'eth0.2'
        option proto 'dhcp'
 
config interface 'wan6'
        option ifname 'eth0.2'
        option proto 'dhcpv6'
 
config switch
        option name 'switch0'
        option reset '1'
        option enable_vlan '1'
 
config switch_vlan
        option device 'switch0'
        option vlan '1'
        option ports '1 2 3 4 5t'
 
config switch_vlan
        option device 'switch0'
        option vlan '2'
        option ports '0 5t'

执行以下操作查看接口列表:

ubus list network.interface.*

要查看关于特定接口(UCI名称而不是物理接口)的所有信息，输入:

ifstatus lan

路由器的最小网络配置通常包括至少两个 interfaces (lan 和 wan) 和一个 switch 节(如果适用的话).

globals 节包含了影响一般网络配置的接口独立选项。

interface类型的节声明逻辑网络作为IP地址配置的容器, aliases, routes, 物理接口名和 startfirewall_rules - 它们在OpenWrt配置概念中起着核心作用。

一个最小的接口声明由以下几行组成:

uci:

network.wan=interface
network.wan.ifname='eth0.2'
network.wan.proto='dhcp'

config file:

config 'interface' 'wan'
        option 'proto' 'dhcp'
        option 'ifname' 'eth0.2'

• wan是唯一的logical interface name
• dhcp表示interface protocol, DHCP是一种例子
• eth0.2是与本节相关联的physical interface

接口协议可能是以下之一:

基于已使用的 interface protocol 可能还需要其他几个选项配合，来构成一个完整的接口声明. 下面列出了每种协议的相应选项。 如果使用了相应的协议，在 “是否必须” 列中标记为 “是” 的选项 必须 在接口部分中定义， 标记为 “否” 的选项 可以 定义也可以省略。

如果一个接口部分没有定义协议(或者定义为 none ), 其他设置将被完全忽略。 结果就是，如果接口部分提到一个物理网络接口 (例如 eth0), 即使连接了电缆这个接口也将是down的 (配置 proto 为 'none' 接口是 up 的)。

See wan_interface_protocols for documentation on the protocol-specific options available for each WAN protocol.

The options _orig_ifname and _orig_bridge may be seen in /etc/config/network when managed by LuCI and were used to keep previous information across edits. They were moved out of ''/etc/config/network'' in March, 2018.

For many users, the default switch configuration is sufficient. Should the user need to configure the switch differently, LuCI, UCI, or direct editing of /etc/config/network may be used to achieve different configurations. Prior to any reconfiguration of the switch, an understanding of the default configuration is important. As an example, some devices have a single switch-connected interface, and other have two or more.

See also:

• swconfig
• VLAN
• Switch Documentation (Older content, but does give discuss single-interface configuration)

The identifier for the switch(es) may be obtained using

# swconfig list
Found: switch0 - ag71xx-mdio.0

With the identifier known, the configuration can be viewed

# swconfig dev switch0 show
Global attributes:
	enable_vlan: 1
	enable_mirror_rx: 0
	enable_mirror_tx: 0
	mirror_monitor_port: 0
	mirror_source_port: 0
	arl_age_time: 300
	arl_table: address resolution table
[...]

There are three types of switch-related configuration stanzas, switch, switch_vlan, and switch_port.

Not all options are available on all hardware. Some limitations may be found with swconfig dev <dev> help. After making changes, check the output of swconfig to determine if the configuration was accepted by the switch hardware.

: The list of options may be incomplete. The details of each option need additional discovery and documentation, including checking of the underlying code. The source of restrictions on value ranges has yet to be identified. Valid values should be confirmed in the code.

Network配置可以通过运行/etc/init.d/network restart重新生效。

单个接口可以用 ifup name启动 或者用 ifdown name 关闭，其中name对应于config interface节的logical interface name. ifup暗含了先调用ifdown 所以在重载interface时不需要同时调用这两个。

请注意，wireless interfaces是由外部管理的，而ifup可能会破坏与现有bridges的关系. 在这种情况下，为了重新建立网桥连接，需要在ifup之后运行wifi up。

参见: Scripting interface