Openwrt Luci界面开发

鸣涧

Openwrt Luci界面开发

Openwrt已经提供了一个很强大的web管理界面Luci，可以方便的管理路由器。我们在开发智能路由器时，一般就需要在OpenWrt的WEB界面增加内容。

准备工作

编译源码前须运行脚本安装luci相关库

./scripts/feeds update luci
./scripts/feeds install -a -p luci

make menuconfig 开记luci

LuCI  --->
        1. Collections  --->
                <*> luci................... LuCI interface with Uhttpd as Webserver (default)

1.Luci简介

LuCI是OpenWrt上的Web管理界面，LuCI采用了MVC三层架构，使用Lua脚本开发，所以开发LuCI的配置界面不需要编辑任何的Html代码，除非想自己单独去创建网页(View层)，否则我们基本上只需要修改Model层就可以了。

2. 添加选项Test

接下来介绍如何在“System”添加Test选项卡。

在文件系统目录“/usr/lib/lua/luci/controller/admin”下创建test.lua文件，文件内容如下：

1. module("luci.controller.admin.test", package.seeall)
   
2. function index()  
   
3.     entry({"admin", "test"}, alias("admin", "test", "test"), _("Test1"), 30).index = true  
   
4.     entry({"admin", "test", "control"}, cbi("admin_test/control"), _("ControlTest"), 1)  
   
5. end
   

复制代码

/etc/init.d/uhttpd restart 重启http服务之后，刷新界面之后（有时候因为缓存，界面没有及时变化，rm -rf /tmp/luci-* 删除缓存就可以了），界面变成

test.lua中 entry表示添加一个新的模块入口，entry的定义如下，其中后两项都是可以为空：

1. entry(path, target, title=nil, order=nil)

复制代码

“path”是访问的路径，路径是按字符串数组给定的，比如路径按如下方式写“{"admin", "test", "control"}”，那么就可以在浏览器里访问“http://192.168.1.1/cgi-bin/luci/admin/test/control”来访问这个脚本。其中的“admin”表示为管理员添加脚本，“test”即为一级菜单名，“control”为菜单项名。系统会自动在对应的菜单中生成菜单项。比如想在“System”菜单下创建一个菜单项，那么一级菜单名可以写为“system”。

        “target”为调用目标，调用目标分为三种，分别是执行指定方法(Action)、访问指定页面(Views)以及调用CBI Module。
第一种可以直接调用指定的函数，比如点击菜单项就直接重启路由器等等，比如写为“call("function_name")”，然后在该lua文件下编写名为function_name的函数就可以调用了。
第二种可以访问指定的页面，比如写为“template("myapp/mymodule")”就可/usr/lib/lua/luci/model/cbi以调用/usr/lib/lua/luci/view/myapp/mymodule.htm文件了。
第三种主要应用在配置界面，比如写为“cbi("myapp/mymodule")”就可以调用/usr/lib/lua/luci/model/cbi/myapp/mymodule.lua文件了。
title和order是针对管理员菜单的，其中的title即是显示在网页上的内容。这里我们创建“/usr/lib/lua/luci/controller/admin/test.lua”文件，定义我们的入口为“test”。

3添加cbi脚本

由test.lua中cbi指示的目录，在“/usr/lib/lua/luci/model/cbi/admin_test”目录下有control.lua脚本。

1.在/usr/lib/lua/luci/model/cbi在新建admin_test目录

2.在admin_test中新建control.lua文件，添加内容

1. require("luci.sys")
   
2. require("luci.sys.zoneinfo")
   
3. require("luci.tools.webadmin")
   
4. require("luci.fs")
   
5. require("luci.config")
   
6. 
   
7. local m, s, o
   
8. 
   
9. m = Map("test", translate("Test"), translate("This is simple test."))
   
10. m:chain("luci")
    
11. 
    
12. s = m:section(TypedSection, "controlboard", translate("Control Board"))
    
13. s.anonymous = true
    
14. s.addremove = false
    
15. 
    
16. 
    
17. s:tab("led", translate("Control LED"))
    
18. s:tab("beep", translate("Control Beep"))
    
19. --s:tab("adc", translate("Control Adc"))
    
20. 
    
21. --
    
22. -- LED
    
23. --
    
24. o = s:taboption("led", ListValue, "lednum", translate("LED NUM:"))
    
25. o.default = 0
    
26. o.datatype = "uinteger"
    
27. o:value(0, translate("LED0"))
    
28. o:value(1, translate("LED1"))
    
29. o:value(2, translate("LED2"))
    
30. 
    
31. o = s:taboption("led", ListValue, "ledstatus", translate("LED STATUS:"))
    
32. o.default = 1    --off status
    
33. o.datatype = "uinteger"
    
34. o:value(0, translate("LED ON"))
    
35. o:value(1, translate("LED OFF"))
    
36. 
    
37. 
    
38. --
    
39. -- BEEP
    
40. --
    
41. o = s:taboption("beep", ListValue, "beepstatus", translate("BEEP STATUS:"))
    
42. o.default = 1    --off status
    
43. o.datatype = "uinteger"
    
44. o:value(0, translate("ON"))
    
45. o:value(1, translate("OFF"))
    
46. 
    
47. o = s:taboption("beep", Value, "beepfreq", translate("BEEP FREQ:"))
    
48. o.datatype = "uinteger"

复制代码

该脚本表示读取/etc/config下的test文件，因此我们需要在/etc/config/中添加test文件。并在文件中添加：

config controlboard

重启uhttpd服务后，刷新后界面为：

鸣涧

OpenWRT 安装 LUCI

每次ssh登陆OpenWRT安装新软件时，都必须更新opkg

opkg update

安装LUCI
opkg install luci
安装luci中文语言包， 不同OpenWRT版本中语言包的名称并不相同，比如15.05.1版本中。 进入 https://downloads.openwrt.org/ch ... nand/packages/luci/ 查找语言包的ipk 为 'luci-i18n-ahcp-zh-cngit-16.018.33482-3201903-1_all.ipk' ,所以可以通过以下命令安装：

opkg install luci-i18n-ahcp-zh-cn
其他版本类似。 opkg安装源的url位置可以在 /etc/opkg.conf 中看到。

启动LUCI
/etc/init.d/uhttpd enable   将uhttpd加入开机启动
/etc/init.d/uhttpd start    启动uhttpd服务
此时既可以在浏览器中进行路由器配置。

打开 http://192.168.1.1 试下吧

配置网络
在浏览器中输入 http://192.168.1.1,点击浏览。将会出现如下界面：

OpenWRT管理页面-wizju.com

用户名：root

密码：上一节#配置root密码 所设置的密码

点击登录，如果密码输入正确则进入管理后台。如下图所示

OpenWRT管理后台首页

开始网络配置，如上图所示，请从上方导航条中选择 【网络】->【接口】，进入接口设置页面。

OpenWRT LuCI接口设置

如上图，因为我们已经通过命令行设置了网络连接，所以接口可以看到有LAN、WAN以及WAN6。

LAN是设置局域网内的相关属性，可以设置内网的IP，桥接的端口。比如我们默认使用192.168.1.1访问，可以修改为172.168.1.1，生效后内网的ip就会变掉。LAN口的协议为【静态地址】

OpenWRT Luci Lan口设定

OpenWRT Luci Lan口设定

WAN就是设置联网的主要设定，(当然lan、wan这些名称都是可以修改的。为了表示清晰还是不要修改的好）。WAN口的协议为根据接入方式的不同一般为【PPPoe（拨号上网方式)】或【静态地址（已经分配了静态地址）】或【DHCP客户端】这几种。上一节中命令行配置为拨号上网方式.显示如下

OpenWRT LuCI WAN口配置

简单来说，LuCI的配合方式同一般路由器的web管理页面的网络配置功能类似。如果经常配置路由器上网的话，LuCI的配置上手也很快。

参考：
https://wiki.openwrt.org/doc/howto/luci.secure