Pulse

---

🚀 概述

Pulse 是一款现代化的统一仪表板，用于监控您在 Proxmox、Docker 和 Kubernetes 环境中的基础设施。它将来自所有系统的指标、告警以及 AI 驱动的洞察整合到一个简洁美观的界面中。

Pulse 专为家庭实验室用户、系统管理员和 MSP 设计，旨在提供“单一视图”的管理体验，而无需复杂的企业级监控堆栈。

✨ 功能

核心监控

• 统一监控：在一个地方查看 PVE、PBS、PMG、Docker 和 Kubernetes 的健康状态和指标
• 智能告警：通过 Discord、Slack、Telegram、电子邮件等多种方式接收通知
• 自动发现：自动检测网络中的 Proxmox 节点
• 指标历史：持久化存储，可配置保留策略
• 备份浏览器：可视化备份任务和存储使用情况

AI 驱动

• 聊天助手（BYOK）：用自然语言提问关于您的基础设施的问题
• 巡检（BYOK）：按计划执行的后台健康检查，生成检查结果
• 告警分析（Pro 版）：告警触发时的可选 AI 分析
• 成本跟踪：按提供商和型号跟踪使用情况和成本

多平台支持

• Proxmox VE/PBS/PMG：全面的监控与管理
• Kubernetes：通过代理实现完整的 K8s 集群监控
• Docker/Podman：容器及 Swarm 服务监控
• OCI 容器：Proxmox 9.1 及以上版本原生容器支持

安全与运维

• 设计安全：凭据静态加密，严格的 API 权限控制
• 一键更新：支持部署的轻松升级
• OIDC/SSO：单点登录认证
• 注重隐私：无遥测数据，所有数据均保留在您的服务器上

⚡ 快速入门

方法 1：Proxmox LXC（推荐）

在您的 Proxmox 主机上运行以下命令，即可创建一个轻量级 LXC 容器：

curl -fsSL https://github.com/rcourtman/Pulse/releases/latest/download/install.sh | bash

注意：此命令会安装 Pulse 服务器。代理的安装则使用在 设置 → 代理 → 安装命令 中生成的命令（该命令由您的 Pulse 服务器上的 /install.sh 提供）。

方法 2：Docker

docker run -d \
  --name pulse \
  -p 7655:7655 \
  -v pulse_data:/data \
  --restart unless-stopped \
  rcourtman/pulse:latest

访问仪表板地址：http://<your-ip>:7655。

📚 文档

• 安装指南：Docker、Kubernetes 和裸机环境的详细安装说明。
• 配置：设置身份验证、通知及高级选项。
• 安全：了解 Pulse 的安全模型及最佳实践。
• API 参考：将 Pulse 与您自己的工具集成。
• 架构：系统高层设计与数据流。
• 故障排除：常见问题解决方案。
• 代理安全：关于校验和验证更新及验证的详细信息。
• Docker 监控：Docker 代理的设置与管理。

🌐 社区集成

社区维护的集成与插件：

• Home Assistant 插件：将 Pulse Agent 和 Pulse 服务器作为 Home Assistant 插件运行。

🚀 Pulse Pro

Pulse Pro 解锁了 自动修复和高级 AI 分析 —— Pulse Patrol 对所有人开放，需使用自有大模型（BYOK）。

功能	免费版	Pro 版
实时仪表板	✅	✅
阈值告警	✅	✅
AI 聊天（BYOK）	✅	✅
Pulse Patrol（BYOK）	✅	✅
告警触发的 AI 分析	—	✅
Kubernetes AI 分析	—	✅
自动修复 + 自主模式	—	✅
集中式代理配置文件	—	✅
高级报表（PDF/CSV）	—	✅
审计 Webhook（SIEM 集成）	—	✅
优先支持	—	✅

Pulse Patrol 按照您的计划运行（每 10 分钟至每 7 天不等，默认 6 小时），能够发现：

• 接近容量上限的 ZFS 池
• 默默失败的备份任务
• 卡在重启循环中的虚拟机
• 集群节点间的时间漂移
• 容器健康检查失败的情况

Pulse Patrol 使用您配置的自有大模型（BYOK），完全在您的服务器上运行。

技术亮点：

• 跨系统上下文（节点、虚拟机、备份、容器及指标历史）
• 结合您提供的大模型进行的 LLM 分析，以及告警触发的深度分析（Pro 版）
• 可选的自动修复功能，配备命令安全策略和审计追踪
• 集中式代理配置文件，确保集群设置的一致性

试用在线演示 → 或 了解更多请访问 pulserelay.pro

Pulse Pro 技术细节：docs/PULSE_PRO.md

❤️ 支持 Pulse 开发

Pulse 由一个人维护。赞助有助于支付演示服务器、开发工具和域名的费用。如果 Pulse 为您节省了时间，请考虑支持该项目！

📄 许可证

MIT © Richard Courtman。Pulse Pro 的使用受 服务条款 约束。

Pulse 快速上手指南

Pulse 是一款现代化的统一监控仪表盘，专为 Proxmox、Docker 和 Kubernetes 基础设施设计。它将指标、警报和 AI 驱动的洞察整合到一个简洁的界面中，非常适合家庭实验室（Homelab）、系统管理员和 MSP 使用。

环境准备

在部署 Pulse 之前，请确保满足以下任一环境要求：

• 推荐方案 (Proxmox LXC)：
  • 拥有一台运行 Proxmox VE 的主机。
  • 主机已连接互联网，可访问 GitHub。
• 通用方案 (Docker)：
  • 已安装 Docker Engine 和 Docker Compose（可选）。
  • 宿主机开放端口 7655。
  • 拥有持久的存储卷用于保存监控数据。

注意：Pulse 服务端负责收集数据，被监控节点（如其他 Proxmox 节点、K8s 集群或 Docker 主机）需安装对应的 Agent。Agent 的安装命令将在 Pulse 服务端启动后生成。

安装步骤

你可以选择以下两种最快捷的方式进行安装：

方案一：Proxmox LXC 一键安装（推荐）

如果你使用的是 Proxmox 环境，这是最轻量且推荐的部署方式。该脚本会自动创建一个优化的 LXC 容器并部署 Pulse 服务端。

在 Proxmox 宿主机的 Shell 中执行以下命令：

curl -fsSL https://github.com/rcourtman/Pulse/releases/latest/download/install.sh | bash

安装完成后，脚本会提示访问地址。

方案二：Docker 部署

适用于任何支持 Docker 的 Linux 服务器。以下命令将启动 Pulse 容器并挂载持久化数据卷：

docker run -d \
  --name pulse \
  -p 7655:7655 \
  -v pulse_data:/data \
  --restart unless-stopped \
  rcourtman/pulse:latest

基本使用

1. 访问仪表盘

安装完成后，在浏览器中访问：

http://<你的服务器 IP>:7655

首次访问时，你将看到初始设置向导。

2. 配置监控目标

Pulse 的核心优势在于“自动发现”和"Agent 模式”：

• 监控本地 Proxmox： Pulse 通常会自动发现同一网络下的 Proxmox 节点。进入仪表盘后，检查 Settings → Agents 查看发现状态。

• 监控远程节点 (Docker/K8s/其他 Proxmox)：

  1. 登录 Pulse 仪表盘。
  2. 导航至 Settings → Agents → Installation commands。
  3. 复制生成的安装命令（类似于 curl ... | bash 或 docker run ...）。
  4. 在需要被监控的目标机器上执行该命令，即可自动注册并上报数据。

3. 启用 AI 洞察 (可选)

Pulse 支持自带密钥 (BYOK) 的 AI 功能：

• Chat Assistant：在设置中填入你的 LLM API Key（如 OpenAI, Anthropic 等），即可通过自然语言询问基础设施状态。
• Pulse Patrol：启用后台健康检查，定期扫描 ZFS 容量、备份失败、VM 重启循环等问题，并通过 AI 生成分析报告。

4. 设置警报

进入 Settings → Notifications，配置 Discord、Slack、Telegram 或 Email webhook。当监控指标超过阈值或 AI 检测到异常时，系统将自动发送通知。