Skip to content

Веб-дашборд

vminfo --web запускает легковесные HTTP API и дашборд только для чтения с переключаемыми темами.

Запуск сервера

bash
vminfo --web

Адрес по умолчанию:

text
http://127.0.0.1:20021

Произвольный адрес:

bash
vminfo --web --bind 0.0.0.0 --port 8080 --interval 1s

Также можно запустить TUI вместе с дашбордом:

bash
vminfo --web --tui

Авторизация

По умолчанию дашборд и API доступны локально и без авторизации.

При включённом --token:

bash
vminfo --web --token
vminfo --web --token my-secret
  • пустой --token автоматически генерирует URL-безопасный токен
  • --token my-secret использует фиксированный токен
  • при первом успешном заходе через /?token=... устанавливается cookie для последующих запросов
  • /healthz остаётся открытым для локальных проверок
  • /, /api/v1/* и /ws требуют токен или cookie авторизации
  • режим с защитой токеном не открывает разрешающий Access-Control-Allow-Origin: *
  • поднятие WebSocket требует, чтобы origin браузера совпадал с хостом дашборда

Удалённый доступ

При привязке к 0.0.0.0 включайте --token, если только дашборд не открыт исключительно для доверенной частной сети.

Эндпоинты

ЭндпоинтНазначение
GET /healthzОткрытая проверка здоровья
GET /api/v1/snapshotПолный снимок рантайма
GET /api/v1/cpuДанные CPU
GET /api/v1/memoryДанные памяти и swap
GET /api/v1/diskДанные файловой системы и дискового ввода-вывода
GET /api/v1/networkИтоги по сети и данные интерфейсов
GET /api/v1/processesСписок процессов
GET /api/v1/systemМетаданные хоста
GET /api/v1/healthОценка здоровья и предупреждения
POST /api/v1/net/diagЗапуск сетевой диагностики (dns / port / ping / ip)
GET /wsЖивой поток снимков

Полные примеры тел запросов и параметры запроса см. в справочнике HTTP API.

Темы

В дашборд встроены переключаемые темы из шапки: Auto, Neon, Light, Terminal и Synthwave. «Auto» повторяет цветовую схему ОС.

Шрифт JetBrains Mono встроен в бинарник, поэтому дашборд полностью самодостаточен — он рендерится задуманным моноширинным шрифтом и работает офлайн без внешних запросов шрифтов.

最近更新

Выпускается по лицензии MIT.