OpenWrt UCI 学习笔记

已于 2023-11-29 11:02:51 修改
阅读量1.5w 收藏 11
点赞数 3
CC 4.0 BY-SA版权
文章标签： openwrt
于 2017-04-12 10:29:41 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/rainforest_c/article/details/70139962

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
暂时不懂有什么作用。。。

rainforest_c
关注
7-Openwrt uci system
Creator_Ly的博客
01-07 753
openwrt的很多配置文件都是通过uci接口来进行查看修改的，虽然我们可以通过直接打开config/下面的配置文件进行修改，但是有个统一的接口为何不用呢，又方便又不会错。 https://wiki.openwrt.org/doc/uci config_load system 通过. /lib/functions.sh进行包含内容 config_load() { [ -n "$IPKG...
openWrt(4) - uci
mx_jun的博客
07-11 364
我们以 network 为例。
OpenWrt项目UCI配置介绍
酌沧
05-12 1801
UCI（Unified Configuration Interface）是 OpenWrt 项目中使用的一种配置管理系统。它旨在为嵌入式设备提供一个统一且易于理解的配置接口。UCI 主要用于简化 OpenWrt 系统的各种配置过程，使得管理网络、服务和其他系统参数变得更加方便。
openwrt之UCI 增删改查（add/get/set /add_list...）
最新发布
BUG_MeDe的博客
05-08 544
可以把每一个config数组，从上到下可以看成[第一个home0，最后一个home0]，其次[home1 ...]，UCI命令允许我们通过@home0[0]这样的方式操作第0个数组，其次也可以使用负数，如将上面的@home0[-1]:表示操作的最后一个home0。使用add增加的config的name字段是匿名的，我们看到的cfgxxxx是uci自动分配的。本文是在此基础上，介绍一下UCI配置文件的相关命令是如何操作的。本文介绍了UCI命令的一些用法，可以使用UCI命令生成一个简单的配置文件。
OpenWrt 系统UCI详解(Lua、C语言调用uci接口实例)
u011029104的专栏
01-14 6326
uci"是"UnifiedInterface”(统一配置界面)的缩写,用于OpenWrt整个系统的配置集中化。很多后台服务有自己的配置文件，并且配置文件格式都不相同，OpenWrt系统中需要开启各种服务，为了解决配置不兼容的问题，统一采用uci格式的配置文件。当然统一的前提是需要各个模块做好适配，所以要想把某个服务集成到OpenWrt系统中，需要增加一个转换层，用于uci配置到服务配置的转换，通常这个工作放在init脚本中处理。以samba服务器为例，
openwrt之Uci
lighthouse_s的博客
05-30 1273
uci delete 配置文件名.section名.option名=option值 //section的类型名没有在命令中使用uci delete 配置文件名.section名.option名 //section的类型名没有在命令中使用。uci del_list 配置文件名.section名.list的option名=list 的option值。test指的是section的名字。option 指的是一个选项 ，name指的是选项的名称， value指的是选项的值。
uci学习
bestboyxie的专栏
08-25 603
uci配置管理的工具 通过help我们可以看到提供了一下的功能； 除了uci还可以使用libuci来开发应用程序解析uci；不知道效率如何。可以拿一个大的文件来实验； 今日的目标就是 成功玩会uci； uci的文件语法 config 'section-type' 'section'         option  'key'       'value'
ubuntu执行uci出现 uci: error while loading shared libraries: lib
wgl307293845的博客
11-22 1045
问题描述 ubuntu下测试uci出现如下错误 root@virtual-machine:/home//uci# uci uci: error while loading shared libraries: libuci.so: cannot open shared object file: No such file or directory 解决方案 修改/etc/ld.so.conf文件，在文件末尾增加/usr/local/lib路径，然后执行ldconfig立即生效 echo /us
OpenWrt-uci命令系统
suyc
04-24 1862
OpenWrt-uci命令系统 本文转载于：http://developer.t-firefly.com/thread-1035-1-1.html 感谢作者 代祥军 目录：1.UCI命令 2.UCI的文件和流程 3.UCI 的文件语法 4.UCI 命令读写配置
web应用目录结构与环境配置
Less Is More
08-22 526
web应用目录结构与环境配置 web应用目录结构与环境配置 1、环境配置 安装JDK： web服务器配置 2、web应用目录结构 1、环境配置 &nbsp;&nbsp;环境配置主要是包括安装JDK环境,web服务器配置。 安装JDK： &nbsp;&nbsp;到官网下载JDK，配置JAVA_HOME环境变量，PATH环境变量，CLASSPATH环境变量三个环境变量...
OpenWRT之UCI系统
热门推荐
Mr_Bobcp的博客
08-05 1万+
Luci介绍 Luci是 Lua Configuration Interface的简称 −目录 共同原则 配置文件 文件语法 命令行实用工具 例子: 导出整个配置 查看所有配置项的值 查看特定配置项的值 查询网络接口的状态 添加防火墙规则 UCI系统 "uci"是"Unified Configuration Interface"(统一配置界面)的缩写,意在OpenWrt整个系统的配置集中化。 系统配置应容易，更直接且在此有文档描述，从而使你的生活更轻松！ （它是White Ru
Openwrt UCI入门操作
qq_60504871的博客
07-21 4373
很多后台服务有自己的配置文件，并且配置文件格式都不相同，OpenWrt系统中需要开启各种服务，为了解决配置不兼容的问题，统一采用uci格式的配置文件。常用的有ucishow、uciset、uciget等，如ucishownetwork。option对应的结构体（选项结构体）对应配置文件里节中的option或者list。package对应的结构体如下（包结构体）它对应一个配置文件内容。section对应的结构体（节结构体）它对应配置文件中的节。3.UCI-C使用方法。.........
OpenWrt上UCI库的使用(C语言调用)
有理论，有实验，有结论，可为一篇文章
10-15 8682
文章目录1 LUCI 配置文件简介2 简单的基本关系3 结构体介绍4 部分API介绍5 代码实战 1 LUCI 配置文件简介 LUCI 的配置文件一般存储在 /etc/config 目录下。比如网络配置文件则是 /etc/config/network，无线的配置文件是 /etc/config/wireless。更多配置文件的含义参考官方 WIKI. 2 简单的基本关系 这里画一个图让大家大致了解配置文件的内容和 uci 的几个基本结构之间的对应关系。（例举文件为 uhttpd 的配置文件） 3 结构
[openwrt] UCI @WifiInfo[0]
linbounconstraint的专栏
07-04 651
https://www.cnblogs.com/tfanalysis/p/3688080.html https://wiki.openwrt.org/doc/uci#configuration.files
openwrt之uci使用
Eric
12-19 1616
“uci”是“Unified Configuration Interface”(统一配置界面)的缩写,意在OpenWrt整个系统的配置集中化。 用法: uci [<options>] <command> [<arguments>] 命令: batch export [<config>] import [<config>] changes [<config>] commit [<conf.
openwrt--uci指令的使用
qq_28689569的博客
01-08 4339
UCI的介绍
OpenWrt系统配置UCI
hzlarm的博客
11-10 9091
UCI简介 MVC(Model-View-Control)模式是经典的Web开发编程模式。 openWrt也是采用该设计模式，模型层采用统一配置接口UCI，是Unified Configuration Interface的缩写，翻译成中文就是统一配置接口，用途就是为OpenWrt提供一个集中控制的接口。OpenWrt实现的这个工具，能够让你的不管是Lua还是PHP程序，或者SHELL程序或C程序...
转载和积累系列 - OpenWrt常用命令
自娱自乐的代码人
12-18 1万+
uci set network.lan.ipaddr=[lan ip]     使用pppoe设置  Shell代码   uci set network.wan.proto=pppoe    //设置wan口类型为pppoe   uci set network.wan.username=[上网帐户]   uci set network.wan.password=[上网密码]    //
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值