LuCI 应用与常用插件

OpenWrt 有两个面孔：一个是命令行，另一个是 LuCI 网页管理界面。绝大多数人日常打交道的是后者。LuCI 本身是一个模块化的 Web 应用，界面上的每一个功能页面都对应一个 luci-app-* 插件。本篇讲清楚 LuCI 的组成、值得装的常用插件，以及安装插件后的验证方法。

LuCI 的模块化结构

LuCI 的命名来自 Lua Configuration Interface，早期用 Lua 语言编写，现在核心界面已经迁移到 JavaScript，但名字保留了下来。它的设计哲学是：只装你需要的功能。一个刚刷好的 OpenWrt，LuCI 界面可能只有系统、网络、状态几个基础页面；每安装一个 luci-app-xxx，界面上就会多出对应的菜单项，通常挂在 Services（服务）或 Network（网络）菜单下。

这种设计的好处是节省闪存。路由器不是台式机，8MB 闪存的设备装不了几个插件就得精打细算。坏处是新手容易困惑：明明听说 OpenWrt 功能强大，怎么刷完看起来什么都没有？答案就是功能都需要按需安装。这就像一台新电脑，系统只带基础软件，其余的自己装。

判断一个插件是否已经装好，最直接的方法有两个。一是在命令行执行 opkg list-installed | grep luci-app，看已安装清单里有没有；二是在浏览器里刷新管理页面，看对应菜单是否出现。如果命令行显示已安装但菜单没出现，多半是缓存问题，退出重新登录一次 usually 就能解决。

常用插件分类清单

OpenWrt 官方源里有数百个 luci-app 插件，第三方源里更多。这里按用途整理一份家庭场景下最实用的清单，全部来自官方源或知名开源项目，可以放心安装。

选插件的原则是按需安装、够用就好。SQM 这类插件运行时要占用 CPU 资源做数据包调度，老旧单核路由器开启后会明显影响转发性能，得不偿失。具体如何取舍，开箱前先想清楚自己的硬件配置。

安装与卸载的完整流程

假设我们要装动态域名插件，操作流程如下。第一步更新软件源索引，这是一切的前提：

opkg update
opkg install luci-app-ddns ddns-scripts

注意第二条命令里同时写了两个包名。luci-app-ddns 只提供网页界面，真正干活的是 ddns-scripts 服务脚本，opkg 会自动解析依赖并一起装上，写在一起只是表达更清晰。安装过程中的输出信息建议读一遍，opkg 会逐行报告正在安装哪些包、配置了哪些服务。

安装插件之后，有三步验证。第一，刷新 LuCI 页面，去 Services 菜单找 Dynamic DNS；第二，如果插件带后台服务，用 /etc/init.d/ddns enable 设置开机自启；第三，用 /etc/init.d/ddns start 手动启动一次，观察日志有没有报错。这三步走完，一个插件才算真正配齐。想直接深入 DDNS 配置细节的，可以看 DDNS 动态域名 主题里的专门讲解。

卸载是反向操作，但有一个坑：opkg remove 默认会保留配置文件，如果想彻底清干净，需要加 --force-removal-of-dependent-packages 参数（谨慎使用）或者手动删除 /etc/config 下对应的配置。保留配置的好处是重装后设置还在，坏处是某些插件残留配置会让新版本行为异常，需要具体问题具体分析。

界面主题与个性化

除了功能插件，LuCI 还支持主题切换。官方自带 OpenWrt 主题和 Bootstrap 主题，在 System（系统）→ System → Language and Style 里切换。第三方主题里 luci-theme-argon 最流行，圆角卡片式设计，观感现代很多，装法同样是 opkg install luci-theme-argon。

汉化包也值得一提。官方固件通常预装 luci-i18n-base-zh-cn，界面就是全中文的；如果刷的是精简版固件，需要手动安装：

opkg update
opkg install luci-i18n-base-zh-cn

某些插件的语言包是单独的，比如 luci-i18n-ddns-zh-cn，装了插件发现页面是英文，补对应语言包即可。

开机自启与服务管理

很多插件背后都有一个后台服务，装完插件只是第一步，还要告诉系统这个服务是否随开机启动。OpenWrt 的服务由 procd 统一管理，每个服务在 /etc/init.d 下有一个同名控制脚本，命令格式非常统一：

/etc/init.d/服务名 start      # 立即启动
/etc/init.d/服务名 stop       # 停止
/etc/init.d/服务名 restart    # 重启
/etc/init.d/服务名 enable     # 设为开机自启
/etc/init.d/服务名 disable    # 取消开机自启
/etc/init.d/服务名 enabled    # 查询是否已启用自启

这套命令可以作为通用检查手段：装完某个插件后，如果 /etc/init.d 下根本没有对应脚本，说明它只是纯界面工具，不需要（也无法）启动后台进程；如果有脚本，启用自启之后再重启一次路由器，开机后看服务是否自动跑起来，跑起来了才算配置闭环。LuCI 界面里 System → Startup 页面列出的正是这些 init 脚本，勾选状态和 enable/disable 命令完全等价。

另外还有两个命令在排障时特别好用。一是 /etc/init.d/服务名 running，检查服务当前是否在运行；二是 logread 命令，查最近的服务日志，服务启动失败的原因十有八九都写在里面。养成查日志的习惯，比反复盲改配置高效得多。

插件管理的进阶技巧

当你装的插件多起来，会逐渐碰到几个共性问题。

第一个是空间规划。查看当前安装的插件占用了多少空间，可以用 du -sh /usr/lib/lua 或直接 df -h 看 /overlay 使用量。发现空间紧张时，优先清理那些装了却从来没配过的插件，它们光占地方不起作用。

第二个是配置备份。更换固件或恢复出厂前，在 System → Backup / Flash Firmware 里生成备份压缩包，里面包含 /etc/config 的全部内容，重刷后恢复，所有插件配置就都回来了。这步操作看似简单，能在关键时刻省下大量重新配置的时间，具体备份策略和《SSH 密钥登录》里讲过的配置文件迁移是同一套思路。

第三个是判断插件是否值得常驻。有些插件只是配置工具，配置完服务就能独立运行，插件本身不占运行资源；有些插件带监控统计功能，比如 luci-app-statistics 依赖 collectd 后台持续采集数据，开起来就会一直吃内存和 CPU。区分这两类，看 /etc/init.d/ 下是否有对应的启用项、以及 ps 输出里有没有相关进程。

最后说一个很多人不知道的功能：LuCI 界面原生支持上传本地 ipk 文件安装。System → Software 页面下方有个 Upload Package 区域，从电脑选好 .ipk 文件点上传，opkg 会自动处理依赖并安装，效果和命令行完全一致。离线环境或者插件不在任何源里的时候，这个入口非常实用。上传前请自行确认文件来源可信，路由器不像电脑有杀毒软件兜底，装错文件的代价要高得多。

延伸阅读

• 《opkg 包管理与软件源》：回到本系列第一篇，系统了解 opkg 的日常操作。
• 《依赖冲突的处理》：装插件报依赖错误时的诊断与处理手册。
• 《DDNS 动态域名》：本篇提到的 ddns 插件的完整配置教程。