鸣涧 发表于 2022-7-28 18:52:44

Openwrt Luci界面开发

Openwrt Luci界面开发

Openwrt已经提供了一个很强大的web管理界面Luci,可以方便的管理路由器。我们在开发智能路由器时,一般就需要在OpenWrt的WEB界面增加内容。
准备工作
编译源码前须运行脚本安装luci相关库./scripts/feeds update luci
./scripts/feeds install -a -p luci
make menuconfig 开记luciLuCI--->
      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文件,文件内容如下:module("luci.controller.admin.test", package.seeall)
function index()
    entry({"admin", "test"}, alias("admin", "test", "test"), _("Test1"), 30).index = true
    entry({"admin", "test", "control"}, cbi("admin_test/control"), _("ControlTest"), 1)
end

/etc/init.d/uhttpd restart 重启http服务之后,刷新界面之后(有时候因为缓存,界面没有及时变化,rm -rf /tmp/luci-* 删除缓存就可以了),界面变成
test.lua中 entry表示添加一个新的模块入口,entry的定义如下,其中后两项都是可以为空: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文件,添加内容require("luci.sys")
require("luci.sys.zoneinfo")
require("luci.tools.webadmin")
require("luci.fs")
require("luci.config")

local m, s, o

m = Map("test", translate("Test"), translate("This is simple test."))
m:chain("luci")

s = m:section(TypedSection, "controlboard", translate("Control Board"))
s.anonymous = true
s.addremove = false


s:tab("led", translate("Control LED"))
s:tab("beep", translate("Control Beep"))
--s:tab("adc", translate("Control Adc"))

--
-- LED
--
o = s:taboption("led", ListValue, "lednum", translate("LED NUM:"))
o.default = 0
o.datatype = "uinteger"
o:value(0, translate("LED0"))
o:value(1, translate("LED1"))
o:value(2, translate("LED2"))

o = s:taboption("led", ListValue, "ledstatus", translate("LED STATUS:"))
o.default = 1    --off status
o.datatype = "uinteger"
o:value(0, translate("LED ON"))
o:value(1, translate("LED OFF"))


--
-- BEEP
--
o = s:taboption("beep", ListValue, "beepstatus", translate("BEEP STATUS:"))
o.default = 1    --off status
o.datatype = "uinteger"
o:value(0, translate("ON"))
o:value(1, translate("OFF"))

o = s:taboption("beep", Value, "beepfreq", translate("BEEP FREQ:"))
o.datatype = "uinteger"
该脚本表示读取/etc/config下的test文件,因此我们需要在/etc/config/中添加test文件。并在文件中添加:config controlboard
重启uhttpd服务后,刷新后界面为:


鸣涧 发表于 2022-7-28 18:53:06

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

页: [1]
查看完整版本: Openwrt Luci界面开发