ZP

zepgram/pi-dashboard

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

21 stars 1 forks 质量 79 趋势 30MIT

实时树莓派监控仪表盘:实时指标和历史,Docker,服务健康,WireGuard,REST API和内置MCP服务器。一个容器,没有数据库。

概览

Raspberry Pi 家庭服务器(或任何 Linux 设备)的实时监控仪表盘:一个容器,无数据库,一个 REST API 和内置的 MCP 服务器。 - :CPU(每核、频率、超频)、内存、温度、负载、磁盘、网络速率、顶级进程。- :过去一小时和过去24小时的CPU、内存、温度、负载和网络数据,存储在内存中并跨越重启时传输。- :电压不足和降频状态,会话最小/最大温度。- :每个容器,包含状态、健康状态、CPU和内存,但未启用内存Cgroup。- :HTTP、HTTPS、TCP、Redis、DNS和网络接口检查,并自动发现主机监听的内容。- :连接的客户端,最后一次握手,传输。- :可配置的警告和关键阈值,吐槽和可选声音。- 由API密钥保护,AI助手可以读取机器状态。- :三种密度(普通、紧凑型、终端极致),五种颜色主题,键盘快捷键,可安装在手机上。

概述(AI 翻译)

Raspberry Pi 家用服务器(或任何 Linux 主机)的实时监控仪表盘:一个 容器,无数据库,使用REST API和内置MCP服务器。

特色

  • 实时指标:CPU(每核、频率、超频)、内存、温度、负载, 磁盘、网络速率、顶级进程。
  • 历史:过去一小时和过去24小时的CPU、内存、温度、负载和 网络,存储在内存中,并在重启时传递。
  • 树莓派特性:电压不足和节流状态,会话最小/最大 温度。
  • Docker:每个容器,包含状态、健康状态、CPU和内存,但未启用 记忆C组。
  • 服务健康:HTTP、HTTPS、TCP、Redis、DNS 和网络接口检查,包括 主机自动发现监听的内容。
  • WireGuard:连接客户端,最后一次握手,传输。
  • 警报:可配置警告和临界阈值、吐司和可选声音。
  • REST API 由 API 密钥保护,并设有 MCP 服务器,使 AI 助手能够读取 机器的状态。
  • 界面:三种密度(普通、紧凑型、极致终端),五种色彩主题, 键盘快捷键,可以安装在手机上。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Pi Dashboard

Real-time monitoring dashboard for a Raspberry Pi home server (or any Linux box): one container, no database, a REST API and a built-in MCP server.

Features

  • Live metrics: CPU (per core, frequency, overclock), memory, temperature, load, disks, network rates, top processes.
  • History: the last hour and the last 24 hours of CPU, memory, temperature, load and network, kept in memory and carried across restarts.
  • Raspberry Pi specifics: under-voltage and throttling status, session min/max temperature.
  • Docker: every container with state, health, CPU and memory, without enabling the memory cgroup.
  • Service health: HTTP, HTTPS, TCP, Redis, DNS and network-interface checks, with auto-discovery of what listens on the host.
  • WireGuard: connected clients, last handshake, transfer.
  • Alerts: configurable warning and critical thresholds, toast and optional sound.
  • REST API protected by an API key, and an MCP server so an AI assistant can read the state of the machine.
  • Interface: three densities (normal, compact, ultra for kiosks), five colour themes, keyboard shortcuts, installable on a phone. No external request: it works on a network without Internet access.
  • Settings are stored server-side and shared by every device.

Quick start (Docker)

The image is built for linux/arm64 and linux/amd64.

mkdir -p pi-dashboard/data && cd pi-dashboard
curl -O https://raw.githubusercontent.com/zepgram/pi-dashboard/main/docker-compose.yml
docker compose up -d

The dashboard is at http://your-pi-ip:3001.

services:
  pi-dashboard:
    image: usernamedigital/pi-dashboard:latest
    container_name: pi-dashboard
    restart: unless-stopped
    environment:
      - PORT=3001
      - SETTINGS_CONFIG=/app/data/settings.json
      - ADMIN_TOKEN=           # optional: protects configuration changes
      - CORS_ORIGINS=*
    volumes:
      - ./data:/app/data                               # settings, API key hash, history
      - /proc:/host/proc:ro                            # host metrics
      - /sys:/host/sys:ro
      - /:/host/root:ro                                # disks, OS release, pending updates
      - /var/run/docker.sock:/var/run/docker.sock:ro   # containers
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "pi-dashboard": { "type": "http", "url": "http://your-pi:3001/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }