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)

Ищем в базе…

Что это такое?Тема оформления LuCI и панель мониторинга сети в реальном времени для роутеров OpenWrt, написанные с нуля. 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 — отдельный необязательный пакет. Переименование устройств — единственное изменение данных, и оно вынесено в отдельную группу.
Что панель показывает одним взглядом?Общую оценку состояния с проверками аплинка, ЦП, памяти, Wi-Fi, уровня сигнала клиентов и накопителя. Также показывает путь сети от шлюза до точки доступа, текущую пропускную способность и клиентов с понятными именами и оценками качества соединения.
Могу ли я быстро перейти на любую страницу?Да. Ctrl + K или / открывает командную палитру с нечётким поиском по всем страницам, которые можно открыть.
Показывает ли это правила файрвола?Да. Обзор файрвола показывает, что открыто из интернета и какая зона с какой связана, с предупреждениями о рискованных случаях. Он доступен только сеансам, которые уже имеют доступ LuCI к файрволу.
Поддерживает ли это другие языки?Доступны английский и упрощённый китайский. Новые переводы приветствуются и добавляются как файлы po/ в pull request.
Какие есть похожие проекты?OpenClash, UFI-TOOLS, Open-Box, neko-master, TrafficMonitor, bandwhich, brook, gentelella
Автор
anothaDev
Размер
9.6 MB
Звёзды
790
Возраст
1 мес
Коммиты · 90 дней