
实时树莓派监控仪表盘:实时指标和历史,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
安装
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" }
}
}
}