Debian 10.3
OpenWrt 22.03.5
MT7620
背景
OpenWrt
的 LuCI
,其前端由 JS+HTML+CSS
组成,后端则主要使用 Lua
。我们不得不在一个 Linux
环境进行代码的开发和调试。
安装VSCode
由于部分Linux发行版会出现安装失败的情况,我在这里推荐一个出错最少的方法,那就是 Snap
:
bash
# 更新 apt 软件源列表
sudo apt update
# 安装 Snap 支持(如果你的系统还未安装 snapd)
sudo apt install snapd
# 启动 Snapd 并等待自动重启
sudo systemctl enable --now snapd.socket
# 安装 Visual Studio Code(经典模式,以获得更好的兼容性)
sudo snap install --classic code
# 完成后,可以直接在终端输入 `code` 来启动 VSCode code
部分发行版还是无法通过命令行直接运行,不用慌,我们可以手动链接过去,我们先找到 Snap 帮我们安装的code,一般在 /snap/bin/code
,我们执行:
sh
# 创建符号链接至 /usr/bin/ 目录,以便全局访问
sudo ln -s /snap/bin/code /usr/bin/code
这样,我们再在命令行运行 code
就可以打开了。
下载LuCI源码
从 LuCI的官方github地址 可以发现,开发的大佬们不爱打tag。上一次打tag还是14年,所以我们只能看看分支,发现了openwrt-22.03
:
当然你也可以选择其它稳定分支,和你的OpenWrt的版本一致即可。所以我们运行:
bash
git clone --branch openwrt-22.03 https://github.com/openwrt/luci.git
安装 lua
我们确定Lua版本有个办法,那就是登录你的OpenWrt路由器,在命令行里查看:
bash
root@OpenWrt:/# lua -v
Lua 5.1.5 Copyright (C) 1994-2012 Lua.org, PUC-Rio (double int32)
我们发现是 Lua 5.1.5
,好吧,那就安装
bash
wget https://www.lua.org/ftp/lua-5.1.5.tar.gz
tar zxf lua-5.1.5.tar.gz
cd lua-5.1.5
sudo make linux test
这里,我们会遇到一个错误,那就是:
log
fatal error: readline/readline.h: No such file or directory #include <readline/readline.h>
解决办法就是安装这个库:
bash
sudo apt-get update
sudo apt-get install libreadline-dev
然后我们进行安装
bash
sudo make install
这样,我们在命令行运行 lua -v
就能得到一个正常的结果了。
LuCI 整体结构介绍
整个项目非常复杂,我们如果想读懂,就不得不依赖官方给出的一些Markdown
文件。 我们先看这个文件 docs/Modules.md
,只看一个非常简单的目录结构的部分:
Categories
The LuCI modules are divided into several category directories, namely:
- applications (Single applications or plugins for other modules or applications)
- i18n (Translation files)
- libs (Independent libraries)
- modules (Collections of applications)
- themes (Frontend themes) Each module goes into a subdirectory of any of this category-directories.
这个结构看起来非常复杂,但是其实重点只有一个,那就是所有的应用程序都在 applications
下。其他的,可以暂时不用关注。
致谢
- 感谢 阿里巴巴 通义千问 ,在探索期间提供的帮助。