ImmortalWrt主题定制教程：打造个性化管理界面

2026-02-05 05:20:32作者：瞿蔚英Wynne

你是否厌倦了路由器管理界面千篇一律的样式？ImmortalWrt作为针对中国用户优化的开源路由器系统，提供了丰富的主题定制功能。本文将带你从主题安装、配置修改到自定义CSS，一步步打造专属的路由器管理界面，无需专业开发知识，新手也能轻松上手。

主题安装准备

在开始主题定制前，需确保你的系统已启用主题支持。ImmortalWrt的主题包通常通过LuCI（网页用户界面）相关组件提供，首先需要确认编译配置中包含主题支持模块。

编译配置检查

打开编译配置文件：
```
make menuconfig
```
在配置菜单中，导航到 LuCI → Themes 选项，确保至少选中一个主题包。ImmortalWrt默认包含多个主题，如：
- luci-theme-bootstrap（默认主题）
- luci-theme-argon（现代化深色主题）
- luci-theme-material（简约Material Design风格）
保存配置并退出，配置文件将保存在 .config 中，相关主题配置项格式如下：
```
CONFIG_PACKAGE_luci-theme-argon=y
CONFIG_PACKAGE_luci-theme-material=m
```

主题包管理

若需安装额外主题，可通过 feeds 机制获取最新主题包。编辑 feeds 配置文件：

nano feeds.conf.default

确保包含LuCI源：

src-git luci https://github.com/immortalwrt/luci.git

更新feeds并安装主题：

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

主题切换与基础配置

网页界面切换主题

登录路由器管理界面（默认地址：http://192.168.1.1）
导航至 系统 → 系统 → 语言和界面
在主题下拉菜单中选择已安装的主题
点击 保存&应用，页面将自动刷新为新主题

命令行切换主题

若无法访问网页界面，可通过SSH执行以下命令切换主题：

uci set luci.main.mediaurlbase='/luci-static/argon'  # 切换为argon主题
uci commit luci
/etc/init.d/uhttpd restart

高级主题定制

CSS样式自定义

主题的视觉样式主要通过CSS文件定义，以下是修改主题颜色的示例：

找到主题CSS文件，以argon主题为例：
```
/www/luci-static/argon/css/cascade.css
```
通过SSH连接路由器，使用vi编辑文件：
```
vi /www/luci-static/argon/css/cascade.css
```

修改全局主色调（将蓝色替换为绿色）：

:root {
  --primary-color: #4CAF50; /* 原颜色：#3e7bfa */
  --primary-dark: #388E3C;
  --primary-light: #C8E6C9;
}

保存文件后，按 Ctrl+F5 强制刷新浏览器缓存即可看到效果

自定义主题文件结构

每个LuCI主题通常包含以下目录结构（以argon主题为例）：

luci-theme-argon/
├── htdocs/               # 静态资源
│   └── luci-static/
│       └── argon/
│           ├── css/      # 样式表
│           ├── js/       # JavaScript脚本
│           └── img/      # 图片资源
├── luasrc/               # Lua模板
│   ├── view/
│   │   └── themes/
│   │       └── argon/    # HTML模板文件
│   └── controller/       # 主题控制逻辑
└── Makefile              # 编译配置文件

主题开发示例：修改登录页面背景

准备一张背景图片（建议尺寸1920x1080，格式PNG/JPG），通过SCP上传至路由器：
```
scp background.jpg root@192.168.1.1:/www/luci-static/argon/img/
```

编辑登录页面模板：

vi /usr/lib/lua/luci/view/themes/argon/header.htm

在 <head> 标签内添加自定义样式：

<style>
.login-bg {
  background-image: url('/luci-static/argon/img/background.jpg') !important;
  background-size: cover;
}
</style>

主题备份与分享

备份自定义主题

为防止系统升级丢失自定义设置，建议备份主题文件：

tar -czf argon-custom-theme.tar.gz /www/luci-static/argon/

将备份文件下载到本地保存：

scp root@192.168.1.1:/root/argon-custom-theme.tar.gz ./

主题打包与分享

若你开发了新主题，可通过以下步骤打包为IPK安装包：

编写Makefile文件，示例：

include $(TOPDIR)/rules.mk

LUCI_TITLE:=Argon Custom Theme
LUCI_DEPENDS:=+luci-base
LUCI_PKGARCH:=all

include $(TOPDIR)/feeds/luci/luci.mk

# call BuildPackage - OpenWrt buildroot signature

编译IPK包：

make package/luci-theme-argon-custom/compile V=s

在 bin/packages/ 目录下找到生成的IPK文件，即可分享给其他用户

常见问题解决

主题切换后页面错乱

问题原因：浏览器缓存导致旧CSS文件未更新
解决方法：

强制刷新浏览器（Ctrl+Shift+R）
清除浏览器缓存或使用隐私模式访问

自定义CSS不生效

排查步骤：

检查CSS文件路径是否正确：

ls -l /www/luci-static/argon/css/cascade.css

确认文件权限：

chmod 644 /www/luci-static/argon/css/cascade.css

通过浏览器开发者工具（F12）查看网络请求，确认CSS文件是否加载成功

主题安装失败

若编译时提示主题包不存在，检查feeds配置：

cat feeds.conf.default | grep luci

确保LuCI源已正确配置并更新：

./scripts/feeds update -a
./scripts/feeds install luci-theme-argon

通过本文教程，你已掌握ImmortalWrt主题的安装、切换和深度定制方法。从简单的主题切换到复杂的CSS样式修改，甚至开发自己的主题包，这些技能将帮助你打造真正个性化的路由器管理界面。如果你开发了特别的主题，欢迎在ImmortalWrt社区分享你的作品！

immortalwrt

An opensource OpenWrt variant for mainland China users.

项目地址：https://gitcode.com/GitHub_Trending/im/immortalwrt

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

atomcode

Claude Code 的开源替代方案。连接任意大模型，编辑代码，运行命令，自动验证 — 全自动执行。用 Rust 构建，极致性能。｜ An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get Started

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

412

338

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

Ascend Extension for PyTorch

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端

AI 将任意文档转换为精美可编辑的 PPTX 演示文稿 — 无需设计基础 | 包含 15 个案例、229 页内容