OpenWrt UCI 学习笔记

UCI (Unified Configuration Interface, 统一配置接口) 是OpenWrt的集中配置管理工具,关于UCI的具体介绍可以查看官方文档—The UCI System

可以通过ubuntu安装UCI或使用openwrt的板子来获得UCI测试环境

##UCI文件格式
UCI文件使用下例所示的固定格式:

package 'example'

config 'example' 'test'
        option   'string'      'some value'
        option   'boolean'     '1'
        list     'collection'  'first item'
        list     'collection'  'second item'
  • package 'example'中的’example’实际上就是UCI文件的文件名,例如/etc/config/network对应 package ‘network’,但是这个语句不会存在文件中,需要通过命令uci export network查看。
  • config 'example' 'test'语句定义了一个type为example,名字为test的section。section可以只有type而没有名字,这类section称为匿名的section,后文会有说明。
  • option 'string' 'some value'语句定义了section下的一个option,该option标识为string,值为some value。
  • list 'collection' 'first item'语句定义了section下的一个list,list与option不同之处在于list可以有多个值,该例子中的list collection有first item和second item两个值。

普通节点示例
[外链图片转存中…(img-AOfKrXZc-1701226929259)]

匿名节点示例
[外链图片转存中…(img-gVwXAmYk-1701226929261)]

##UCI命令

root@OpenWrt:/lib/config# uci
Usage: uci [<options>] <command> [<arguments>]

Commands:
	batch
	export     [<config>]
	import     [<config>]
	changes    [<config>]
	commit     [<config>]
	add        <config> <section-type>
	add_list   <config>.<section>.<option>=<string>
	del_list   <config>.<section>.<option>=<string>
	show       [<config>[.<section>[.<option>]]]
	get        <config>.<section>[.<option>]
	set        <config>.<section>[.<option>]=<value>
	delete     <config>[.<section[.<option>]]
	rename     <config>.<section>[.<option>]=<name>
	revert     <config>[.<section>[.<option>]]
	reorder    <config>.<section>=<position>

Options:
	-c <path>  set the search path for config files (default: /etc/config)
	-d <str>   set the delimiter for list values in uci show
	-f <file>  use <file> as input instead of stdin
	-m         when importing, merge data into an existing package
	-n         name unnamed sections on export (default)
	-N         don't name unnamed sections
	-p <path>  add a search path for config change files
	-P <path>  add a search path for config change files and use as default
	-q         quiet mode (don't print error messages)
	-s         force strict mode (stop on parser errors, default)
	-S         disable strict mode
	-X         do not use extended syntax on 'show'

请在/etc/config目录下创建一个文件network,内容如下

config interface 'lan'
        option ifname 'eth2'
        option proto 'static'
        option ipaddr '192.168.1.1'
        option netmask '255.255.255.0'
        option ip6addr 'fec0::1/64'

batch
批处理uci命令,命令不包含字符串"uci"

例如要批处理以下两个命令
uci set test.test1=test2
uci set test.test1.test3=test4

只需要把这两个命令去掉uci后放到文档a.txt里面
cat a.txt
set test.test1=test2
set test.test1.test3=test4

然后执行
uci batch < a.txt

commit
提交uci修改,当命令uci changes有返回结果时表示有uci修改待提交,可以通过命令uci commit完成提交,即写入到配置文件。
uci commit可以提交具体的package,例如uci commit network表示只提交network部分的修改。

export
导出配置文件为可读的格式

root@OpenWrt:/etc/config# uci export network
package network

config interface 'lan'
        option ifname 'eth2'
        option proto 'static'
        option ipaddr '192.168.1.1'
        option netmask '255.255.255.0'
        option ip6addr 'fec0::1/64'

import
导入配置文件为UCI格式

root@OpenWrt:/etc/config# uci import
>package test
>config test1 test2
>option test3 test4
>ctrl + D

执行上述命令后会得到文件’test’

root@OpenWrt:/etc/config# cat test

config test1 'test2'
        option test3 'test4'

changes
追踪修改但未提交的动作

add
添加一条匿名的section

root@OpenWrt:/etc/config# uci add network test
root@OpenWrt:/etc/config# uci export network
package network

config interface 'lan'
        option ifname 'eth2'
        option proto 'static'
        option ipaddr '192.168.1.1'
        option netmask '255.255.255.0'
        option ip6addr 'fec0::1/64'

config test

add_list
添加一条list

root@OpenWrt:/etc/config# uci add_list network.lan.ip2=1.2.3.4
root@OpenWrt:/etc/config# uci export network
package network

config interface 'lan'
        option ifname 'eth2'
        option proto 'static'
        option ipaddr '192.168.1.1'
        option netmask '255.255.255.0'
        option ip6addr 'fec0::1/64'
        list ip2 '1.2.3.4'

config test

del_list
删除一条list,由于list可以存在多个值,所以必须指定删除的值

root@OpenWrt:/etc/config# uci del_list network.lan.ip2=1.2.3.4
root@OpenWrt:/etc/config# uci export network
package network

config interface 'lan'
        option ifname 'eth2'
        option proto 'static'
        option ipaddr '192.168.1.1'
        option netmask '255.255.255.0'
        option ip6addr 'fec0::1/64'

config test

show
用压缩格式显示all, package, section或option的值,依参数而定

uci show 					--- show all
uci show network			--- show network
uci show network.lan		--- show network.lan
uci show network.lan.ipaddr	--- show network.lan.ipaddr
root@OpenWrt:/etc/config# uci show network
network.lan=interface
network.lan.ifname=eth2
network.lan.proto=static
network.lan.ipaddr=192.168.1.1
network.lan.netmask=255.255.255.0
network.lan.ip6addr=fec0::1/64
network.lan.ip2=
network.@test[0]=test

get
获取指定section或option的值,与uci show等号两边对应

root@OpenWrt:/etc/config# uci get network.lan
interface
root@OpenWrt:/etc/config# uci get network.lan.ifname
eth2

set
为指定section或option赋值(不存在则创建该对象),格式可以参考uci show的结果

root@OpenWrt:/etc/config# uci set network.lan.ipaddr=10.0.0.1
root@OpenWrt:/etc/config# uci show network
network.lan=interface
network.lan.ifname=eth2
network.lan.proto=static
network.lan.netmask=255.255.255.0
network.lan.ip6addr=fec0::1/64
network.lan.ip2=
network.lan.ipaddr=10.0.0.1
network.@test[0]=test

delete
删除指定section或option

root@OpenWrt:/etc/config# uci delete network.lan.ip2
root@OpenWrt:/etc/config# uci delete network.@test[0]
root@OpenWrt:/etc/config# uci show network
network.lan=interface
network.lan.ifname=eth2
network.lan.proto=static
network.lan.netmask=255.255.255.0
network.lan.ip6addr=fec0::1/64
network.lan.ipaddr=10.0.0.1

rename
重命名section或option

root@OpenWrt:/etc/config# uci rename network.lan.ipaddr=ip
root@OpenWrt:/tmp/etc/config# uci show network
network.lan=interface
network.lan.ifname=eth2
network.lan.proto=static
network.lan.netmask=255.255.255.0
network.lan.ip6addr=fec0::1/64
network.lan.ip=10.0.0.1

revert
撤销修改(执行uci commit之前)

reorder
暂时不懂有什么作用。。。

### OpenWRT UCI 使用介绍 UCI(Unified Configuration Interface),即统一配置接口,是OpenWrt引入的一套用于管理和修改系统配置参数的工具集[^1]。这套工具使得用户能够通过一种简单而标准的方式去调整路由器的各项设置,包括但不限于网络配置、无线配置以及系统信息配置。 #### 主要特点 - **集中化管理**:所有的配置项都集中在`/etc/config/`目录下的多个文件中; - **易于使用**:提供了一组命令行工具来简化对这些配置文件的操作; - **跨平台兼容性**:不仅支持shell脚本调用,还提供了C语言API供开发者集成到应用程序里[^2]; #### 配置结构解析 每一个`.conf`结尾的文件代表一类特定的服务或功能模块,并遵循如下格式: ```plaintext config 'section_type' ['instance_name'] option 'option_key' 'value' ``` 这里`section_type`定义了一个逻辑单元比如wan口连接或者dhcp服务实例;而`option_key=value`则是具体选项及其对应的取值。 #### 实际操作指南 为了展示如何利用UCI来进行实际配置工作,下面给出几个常见的例子: ##### 查看现有配置 可以通过执行简单的命令查看当前已有的设定情况: ```bash uci show network.lan ``` 这条语句将会返回有关LAN端口的所有属性列表。 ##### 修改IP地址分配模式 假设想要把局域网内的设备由静态指定改为自动获取,则可按照以下步骤完成更改: ```bash uci set network.lan.proto='dhcp' uci commit network ``` 上述两条指令先是设置了协议类型为动态主机配置协议(DHCP),接着提交变更使之生效。 ##### 添加新的WiFi接入点 对于希望创建额外Wi-Fi热点的情况来说,可以参照此流程: ```bash uci add wireless wifi-iface uci set wireless.@wifi-iface[-1].device='radio0' uci set wireless.@wifi-iface[-1].network='lan' uci set wireless.@wifi-iface[-1].mode='ap' uci set wireless.@wifi-iface[-1].ssid='NewSSIDName' uci set wireless.@wifi-iface[-1].encryption='psk2+ccmp' uci set wireless.@wifi-iface[-1].key='YourPasswordHere' uci commit wireless ``` 这段代码片段展示了怎样新增一个名为`NewSSIDName`的安全型访问节点。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值