OpenWRT Luci界面开发实战：5分钟搞定自定义Web页面（附完整代码）

OpenWRT Luci界面开发实战：5分钟搞定自定义Web页面（附完整代码）

你是否曾经面对OpenWRT的Web管理界面，想要添加一个属于自己的功能页面，却感觉无从下手？看着那些陌生的Lua文件和复杂的目录结构，是不是瞬间就头大了？别担心，这几乎是每个初次接触Luci开发的工程师都会遇到的“新手墙”。今天，我们就来彻底打破这堵墙，用最直接、最实战的方式，让你在五分钟内，从一个完全不懂Luci的新手，到成功部署并访问自己的第一个自定义页面。我们不谈冗长的理论，只聚焦于“文件放哪里”、“代码怎么写”、“如何生效”这三个最核心的痛点，并提供可以直接复制粘贴的完整代码模板。

1. 理解Luci的“高速公路”与“收费站”

在动手之前，我们需要花一分钟建立一个最简化的心智模型。你可以把Luci框架想象成一个已经建好的高速公路网络。作为开发者，你的目标不是去铺设新的公路，而是在现有的路口（菜单）设立一个指向你目的地的“收费站”（页面入口），并准备好目的地的“建筑”（页面内容）。

Luci采用经典的MVC架构，但对于快速上手而言，我们只需要关注两个最关键的角色：

• Controller（控制器）： 它就是高速公路的**“路口指示牌”**。它的作用是告诉系统：“在某个菜单的某个位置，有一个新的页面，请把它显示出来。” 这个指示牌本身不包含页面内容，只负责导航。
• View（视图） 或 Model（模型）： 这就是目的地的**“建筑”**。View 对应静态的展示页面（比如一个纯信息的仪表盘），而 Model（通常与CBI结合）则对应动态的、可以与配置文件交互的表单页面（比如修改网络设置的页面）。

我们的工作流程因此变得极其清晰：

1. 立指示牌：在Controller中写一条entry语句，定义页面出现在哪里、叫什么名字。
2. 盖房子：在View或Model目录下创建对应的页面文件（.htm或.lua）。
3. 刷新路网：让系统重新加载这些配置。

下面，我们就分步拆解，用代码说话。

2. 实战第一步：创建一个静态欢迎页面

我们的第一个目标是，在系统管理（System）菜单下，增加一个名为“我的面板”的页面，点击后显示“Hello， Developer！”。

2.1 定位并修改控制器文件

首先，我们需要找到“System”这个路口的指示牌集合。在OpenWRT系统中，Luci的核心文件位于 /usr/lib/lua/luci/。

提示：以下所有操作均通过SSH连接到你的OpenWRT设备进行。请确保你具有相应的权限。

我们需要编辑的控制器文件是：

/usr/lib/lua/luci/controller/admin/system.lua

使用 vi 或 nano 打开这个文件。你会看到里面已经有很多 entry 语句，它们定义了“System”下的所有子页面（如System、Administration、Software等）。

我们在文件的合适位置（例如，在其他entry语句附近）添加我们的新指示牌。添加以下一行Lua代码：

entry({"admin", "system", "mydashboard"}, template("admin_system/mydashboard"), _("我的面板"), 90)

让我们拆解这行代码的每个部分：