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。具体说明如下：
2.1 interface网络接口配置
包括loopback、lan和wan接口, 其主要选项有: ifname 接口名称 proto 接口协议, 可选 static(静态ip)、dhcp(动态ip)、ppp、pppoe等。 type 接口类型，如果设置为“bridge”，将建立一个包含ifname所述接口的网桥。 macaddr 接口的MAC地址