luci-theme-vantage README

项目的 README,来自 github.com/anothaDev/luci-theme-vantage。合并为一个 markdown 文件:README.md。

Vantage logo

Vantage

A theme and live dashboard for LuCI, OpenWrt's web interface. Log in and see who's connected, how busy your connection is, and what needs fixing. For OpenWrt 25.12 and 24.10.

OpenWrt 25.12 and 24.10 LuCI theme + app License: GPL-3.0-or-later

Website · Install · Screenshots · Changelog


A ten-second tour of Vantage: the dark dashboard with live charts and the network path, a client's details, Ctrl K search, and the switch from dark to light

The video and screenshots use recorded data with addresses and names replaced. The larger access point further down is generated.

What you get

Two packages that work together or alone: the theme doesn't need the dashboard, and the dashboard on its own works under any LuCI theme.

The dashboard (luci-app-vantage) is the page you land on after login.

The theme (luci-theme-vantage) restyles every LuCI page.

Nothing loads from the internet: Vantage uses system fonts and its own icons, with no CDNs or frameworks. The one exception is Check for updates under Appearance, and only when you click it. The dashboard's only write is device names, and it never reads Wi-Fi keys. See Security.

Install

These steps are for OpenWrt 25.12 (apk). On 24.10, follow the 24.10 steps. Both packages are architecture-independent, so the same files install on any router.

From the signed repository. Run this on the router. It stops before installing anything if the key's hash doesn't match. You only need to do it once; later versions come with apk upgrade.

key=$(mktemp) &&
wget -O "$key" https://anothadev.github.io/luci-theme-vantage/vantage-signing.pem &&
echo "c8a6c83eeb49ca2407932fb5e95785776128cef87db75ebaea0fe4171eee2157  $key" | sha256sum -c - &&
cp "$key" /etc/apk/keys/vantage-signing.pem &&
echo 'https://anothadev.github.io/luci-theme-vantage/25.12/packages.adb' >> /etc/apk/repositories.d/customfeeds.list &&
apk update &&
apk add luci-theme-vantage luci-app-vantage

From release files. Download them from a release or build your own, then run this in the same folder. 192.0.2.1 stands for your router's address.

f=$(awk '/ luci-(theme|app)-vantage-.*\.apk$/ {print $2}' SHA256SUMS) &&
grep -E ' luci-(theme|app)-vantage-.*\.apk$' SHA256SUMS | sha256sum -c - &&
ssh [email protected] 'mkdir -m 700 /tmp/vantage' &&
scp -O $f [email protected]:/tmp/vantage/ &&
ssh [email protected] 'apk add --no-network --allow-untrusted /tmp/vantage/*.apk; s=$?; rm -r /tmp/vantage; exit $s'

Log out of LuCI and back in, and the dashboard is your landing page. A fresh install switches to the theme for you. An upgrade keeps the theme you chose, and removing the theme switches LuCI back to Bootstrap.

The install guide covers the rest: requirements, verifying packages, installing just one of them, upgrades, uninstalling, building Vantage into your own firmware, troubleshooting, and a ready-made prompt for installing with a coding agent.

Screenshots

The Vantage dashboard in dark mode: six health cards with their own icons and edge charts, the signal card flagging a weak client, the network path from the gateway through the access point to its radios and SSIDs, live throughput in download and upload colours, and radio cards

Dashboard in light mode with every check passing Client inspector drawer open over the clients table
Light mode: health checks, network path and live throughput Client details: experience score, signal and link info
Command palette listing pages and Appearance actions that match a search Network path of a quad-radio access point with ten SSIDs and a Wired branch of six ports
Ctrl+K search over pages and Appearance options A larger access point (generated): four radios, ten networks, six wired ports
LuCI Status Overview page restyled by the theme Channel Analysis page showing neighbouring networks
LuCI's Status page under the theme, with a combined memory bar LuCI's Channel Analysis page (neighbouring networks are generated)
The theme's login page with moving packet traces on a dark grid Dashboard on a phone-sized screen
Login page with grid packets, a starfield or nothing Phone layout with the bottom bar and Wi-Fi/Wired switch

Security

Vantage is built to read your router, not change it. The full rules are in the spec.

One known exception: LuCI's own header adds its L.env script to every page, including the menu tree on logged-out 404 pages. That's upstream behaviour, tracked in docs/luci-contract.md.

Compatibility

OpenWrt Status
25.12 Built with the 25.12 SDK and tested
24.10 Signed .ipk packages, built with the 24.10 SDK and tested on a 24.10.8 router without Wi-Fi (install)

Languages

Vantage is available in English and Simplified Chinese (dashboard translation by @ntbowen). Each language installs as its own packages, for example apk add luci-i18n-vantage-zh-cn luci-i18n-vantage-theme-zh-cn; see Languages in the install guide.

Translations are very welcome. In a fork, run dev/i18n/update.sh --add <lang>, translate the two new .po files and open a pull request that touches only po/ files. Translations has the details.

Build

With podman and the official OpenWrt SDK image:

dev/build/sdk-build.sh 25.12.4          # builds HEAD into dist/25.12.4/

The same commit and SDK always produce byte-identical packages, and each package is checked against the source before it reaches dist/. Signing and the other details are in the install guide.

Develop

You don't need a router to work on Vantage. The replay in dev/replay/ serves the full LuCI interface from a recording or hand-written fixtures, with the theme and app loaded from this repository, so you can reload to see an edit. --demo swaps real addresses and names for documentation values, which is how the screenshots were made.

node dev/replay/server.js --mirror ../vantage-mirror --port 8106 --demo \
    --theme-dir luci-theme-vantage/htdocs/luci-static/vantage --theme vantage \
    --app-dir luci-app-vantage

CONTRIBUTING.md has the setup and the checks to run, docs/SPEC.md describes the product, and docs/luci-contract.md lists what LuCI expects from a theme. Coding agents should read AGENTS.md.

Contributing

Issues and pull requests are welcome; see CONTRIBUTING.md. For a bug report, include your OpenWrt version (cat /etc/openwrt_release), your browser, and screenshots with personal data removed: no real IP addresses, MACs or SSIDs. Report security problems privately as described in SECURITY.md, not in a public issue.

Past releases are in CHANGELOG.md, and planned work is in docs/ROADMAP.md.

License

GPL-3.0-or-later. See LICENSE and luci-theme-vantage/NOTICE.

luci-theme-vantage (anothaDev/luci-theme-vantage)

正在搜索数据库…

这是什么?一个为 OpenWrt 路由器从零开始打造的 LuCI 主题和实时网络仪表盘。LuCI 是 OpenWrt 的网页管理界面,Vantage 替换了它的外观,并新增了一个仪表盘。
它只是一个主题,还是会增加其他功能?它包含两个软件包。luci-theme-vantage 重新设计路由器的网页界面,可以单独使用。luci-app-vantage 新增一个实时仪表盘作为首页,可以配合任何主题使用。
我该如何在路由器上安装它?在 OpenWrt 25.12 上,使用 apk 从已签名的软件源安装。在 24.10 上,使用 opkg 从已签名的 .ipk 软件包安装。然后退出 LuCI 并重新登录,仪表盘就会成为首页。
安装前我需要准备什么?一台运行 OpenWrt 25.12 或 24.10 并已安装 LuCI 的路由器。这些软件包与架构无关,同样的文件可用于任何目标平台。
这个软件在 OpenWrt 24.10 上经过完整测试了吗?没有完全测试。24.10 版本只在一台没有 Wi-Fi 的路由器上测试过,因此其无线相关页面的真机测试比 25.12 版本少。
能在手机上使用吗?可以。在手机上,图标导航栏会变成底部栏和底部弹出面板,小屏幕上的表格则会转为卡片显示。
这个仪表盘会把我的网络数据发送到别处,或者修改设置吗?仪表盘是只读的,数据中不包含 Wi-Fi 密钥和 RADIUS 密钥。反向 DNS 是单独的可选软件包。重命名设备是唯一的写入操作,并且放在独立的分组中。
仪表盘一眼能看到什么?一个健康状况结论,检查上行链路、CPU、内存、Wi-Fi、客户端信号和存储。还会显示从网关到接入点的网络路径、实时吞吐量,以及带有易读名称和体验评分的客户端。
我能快速跳转到任意页面吗?可以。按 Ctrl + K 或 / 即可打开命令面板,模糊搜索所有你能打开的页面。
它能显示防火墙规则吗?可以。防火墙概览会显示哪些端口对互联网开放,以及哪些区域之间可以互相访问,并对有风险的情况发出警告。只有已拥有 LuCI 防火墙访问权限的会话才能看到此内容。
它支持其他语言吗?支持英文和简体中文。欢迎提供新的翻译,可通过拉取请求以 po/ 文件的形式添加。
作者
anothaDev
大小
9.6 MB
星标
790
时长
1个月
提交 · 90 天