welcome to see widora.cn

This is an old revision of the document!

UCI是(Unified Configuration Interface)的缩写，即统一配置接口，UCI是Openwrt提供的一套软件包参数配置管理系统，其目的是让系统和软件包的配置更加简单，并且易于集中管理。UCI的配置文件全部放置在/etc/config目录下，其中最常用和最重要的配置文件包括wireless(无线配置)、network(网络配置)、firewall(防火墙配置)和system(系统配置)。配置文件可以直接修改或用uci命令进行修改，具体语法可以参考wiki.openwrt.org。

1. 无线配置文件 /etc/config/wireless

wireless用来配置wifi无线设备和接口，典型的wireless配置文件如下：

 config wifi-device 'radio0'
      option type 'ralink'
      option variant 'mt7628'
      option country 'CN'
      option hwmode '11bgn'
      option htmode 'HT20'
      option channel '11'
      option disabled '0'
 config wifi-iface 'ap'
      option device 'radio0'
      option mode 'ap'
      option network 'lan'
      option ifname 'ra0'
      option ssid '本机热点SSID'
      option encryption 'psk-mixed'
      option key 'xxxxxxxxx'
      option hidden '1'
 config wifi-iface 'sta'
      option device 'radio0'
      option mode 'sta'
      option ifname 'apcli0'
      option ssid '上级热点SSID'
      option key 'xxxxxxxxx'
      option network 'wan'
      option disabled '0'

其中包含了wifi设备配置和wifi接口配置。具体说明如下：

1.1 wifi设备配置

包含了1个wifi 设备'radio0', 其主要选项有:

country      应用的国家
hwmode       无线协议，可选11a、11b、11g、11na、11ng等, 对应IEEE 802.11标准
htmode       有效带宽，可选HT20和HT40
channel      信道，可选 1 ~ 14
disable      是否关闭，1(关闭) 或0(开启)

1.2 wifi接口配置

包含了'ap'和'sta' 2个wifi 接口配置, 其主要选项有:

device       关联的wifi设备名称
mode         wifi工作模式，可选ap或sta。 ap--wifi热点模式，允许终端无线接入; sta--终端模式。
network      网络设备类型，对应/etc/config/network中的接口段，通常为lan或wan。
ifname       网络接口名称，和/etc/config/network中的接口名称一致。
ssid         wifi无线网络名称 (ap模式时为本机热点名称，sta模式时为上级接入点的名称)
encryption   加密方式，可选none, psk, psk2 和 psk-mixed。
key          密钥，至少8个字符长度。 encryption为none时无效。
hidden       是否隐藏wifi无线网络名称， 1(隐藏) 或0(显示)

2. 网络配置文件 /etc/config/network

network文件用来配置网络接口，典型的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 'fd7a:843a:14df::/48'
 config interface 'lan'
      option force_link '1'
      option macaddr 'ff:ff:ff:ff:ff:ff'
      option type 'bridge'
      option ipaddr '192.168.1.1'
      option netmask '255.255.255.0'
      option ip6assign '60'
      option proto 'static'
      option ifname 'eth0'
 config switch
      option name 'switch0'
      option reset '1'
      option enable_vlan '0'
 config interface 'wan'
      option proto 'dhcp'
      option ifname 'apcli0'

通常包含1个本地回环接口loopback、1个局域网接口lan 、1个外网接口wan 和 1个交换段switch。具体说明如下：