rcourtman/pulse

Pulse

Proxmox VE、Proxmox Mail Gateway、PBS和Docker基础设施的实时监控工具，支持警报和Webhook。

从单个仪表板监控混合的Proxmox和Docker环境。当节点宕机、容器异常、备份失败或存储空间不足时，获取即时警报。支持电子邮件、***、Slack、***等多种通知方式。

尝试在线演示 →（只读模式，含模拟数据）

支持Pulse开发

Pulse由一名独立开发者利用晚上和周末时间开发。您的支持将帮助：

• 保持开发新功能的动力
• 优先处理错误修复和用户需求
• 确保Pulse永远100%免费且开源

![]([]

暂时无法赞助？ 给项目点星或将其分享给您的家庭实验室社区！

特性

• 自动发现：在网络上查找Proxmox节点，通过生成的脚本实现一行式设置
• 集群支持：配置一个节点，监控整个集群
• 企业级安全：
  • 凭证静态加密存储，日志中脱敏显示，从不发送到前端
  • 所有状态变更操作的CSRF保护
  • 速率限制（一般请求500次/分钟，认证请求10次/分钟）
  • 多次登录失败后账户锁定
  • 使用HttpOnly cookie的安全会话管理
  • bcrypt密码哈希（成本12）- 密码绝不会以明文存储
  • API令牌通过受限文件权限安全存储
  • 安全头（CSP、X-Frame-Options等）
  • 全面的审计日志
• 虚拟机、容器、节点、存储的实时监控
• 智能警报：电子邮件和Webhook（、Slack、、Teams、ntfy.sh、Gotify）
  • 示例："节点'pve1'上的虚拟机'webserver'已宕机"
  • 示例："存储'local-lvm'使用率达85%"
  • 示例："虚拟机'database'已恢复在线"
• 自适应阈值：基于滞后效应的触发/清除级别，网络阈值分数，每指标搜索，重置为默认值，以及带内联审计跟踪的自定义覆盖
• 警报时间线分析：丰富的历史记录浏览器，带确认/清除标记、升级轨迹和嘈杂资源的快速筛选
• Ceph感知：当Proxmox公开Ceph支持的存储时，自动显示Ceph健康状态、池利用率和守护进程状态
• PBS备份、PVE备份和快照的统一视图
• 交互式备份浏览器：交叉高亮的柱状图+网格，支持快速时间范围切换（24小时/7天/30天/自定义）和最繁忙任务的上下文工具提示
• Proxmox Mail Gateway分析：邮件量、垃圾邮件/病毒趋势、隔离区健康状况和集群节点状态
• 通过轻量级代理可选监控Docker容器
• 带加密和认证的配置导出/导入
• 自动稳定更新与安全回滚（可选）
• 深色/浅色主题，响应式设计
• 使用Go构建，资源占用极小

https://github.com/rcourtman/Pulse

隐私

Pulse尊重您的隐私：

• 不收集遥测数据或分析信息
• 无"电话回家"功能
• 无外部API调用（除已配置的Webhook外）
• 所有数据保留在您的服务器上
• 开源 - 您可自行验证

您的基础设施数据仅属于您。

使用Docker快速开始

基本设置

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

然后打开http://localhost:7655并完成安全设置向导。

网络发现

Pulse会自动发现网络上的Proxmox节点！默认情况下，它会扫描：

• 192.168.0.0/16（家庭网络）
• 10.0.0.0/8（私有网络）
• 172.16.0.0/12（Docker/内部网络）

要扫描自定义子网：

bash
docker run -d \
  --name pulse \
  -p 7655:7655 \
  -v pulse_data:/data \
  -e DISCOVERY_SUBNET="192.168.50.0/24" \
  --restart unless-stopped \
  rcourtman/pulse:latest

使用预配置认证的自动部署

bash
# 使用预配置的认证部署
docker run -d \
  --name pulse \
  -p 7655:7655 \
  -v pulse_data:/data \
  -e API_TOKEN="your-secure-token" \
  -e PULSE_AUTH_USER="admin" \
  -e PULSE_AUTH_PASS="your-password" \
  --restart unless-stopped \
  rcourtman/pulse:latest

# 明文凭证会自动哈希以确保安全
# 无需额外设置 - API可立即使用

Docker Compose

yaml
services:
  pulse:
    image: rcourtman/pulse:latest
    container_name: pulse
    ports:
      - "7655:7655"
    volumes:
      - pulse_data:/data
    environment:
      # 注意：环境变量会覆盖UI设置。移除环境变量以允许UI配置。

      # 网络发现（通常不需要 - 自动扫描常见网络）
      # - DISCOVERY_SUBNET=192.168.50.0/24  # 仅用于非标准网络

      # 端口
      # - PORT=7655                         # 后端端口（默认：7655）
      # - FRONTEND_PORT=7655                # 前端端口（默认：7655）

      # 安全（均为可选 - 默认情况下开放运行）
      # - PULSE_AUTH_USER=admin             # Web UI登录用户名
      # - PULSE_AUTH_PASS=your-password     # 明文或bcrypt哈希（明文会自动哈希）
      # - API_TOKEN=your-token              # 明文或SHA3-256哈希（明文会自动哈希）
      # - ALLOW_UNPROTECTED_EXPORT=false    # 允许无需认证导出（默认：false）

      # 安全：明文凭证会自动哈希
      # 您可以提供：
      # 1. 明文（自动哈希）：PULSE_AUTH_PASS=mypassword
      # 2. 预哈希（高级）：PULSE_AUTH_PASS='$2a$12$...'
      #    注意：在docker-compose.yml中，预哈希值中的$需转义为$

      # 性能
      # - CONNECTION_TIMEOUT=10             # 连接超时（秒，默认：10）

      # CORS和日志
      # - ALLOWED_ORIGINS=https://app.example.com  # CORS源（默认：无，仅同源）
      # - LOG_LEVEL=info                    # 日志级别：debug/info/warn/error（默认：info）
    restart: unless-stopped

volumes:
  pulse_data:

初始设置

1. 打开http://<您的服务器>:7655
2. 完成强制性安全设置（仅首次运行）
3. 创建管理员用户名和密码
4. 保存生成的API令牌用于自动化

配置Proxmox/PBS节点

登录后：

1. 进入设置 → 节点
2. 发现的节点会自动显示
3. 点击任意节点旁的"设置脚本"
4. 点击"生成设置代码"按钮（创建6字符代码，有效期5分钟）
5. 复制提供的单行命令并在您的Proxmox/PBS主机上运行
6. 节点将被配置并自动开始监控

示例设置命令：

bash
curl -sSL "http://pulse:7655/api/setup-script?type=pve&host=https://pve:8006&auth_token=ABC123" | bash

Docker更新

bash
# 最新稳定版
docker pull rcourtman/pulse:latest

# 最新RC/预发布版
docker pull rcourtman/pulse:rc

# 特定版本
docker pull rcourtman/pulse:v4.22.0

# 然后重新创建容器
docker stop pulse && docker rm pulse
# 再次运行您的docker run或docker-compose命令

安全

• 需要认证 - 保护您的Proxmox基础设施凭证
• 快速设置向导 - 一分钟内完成安全配置
• 多种认证方式：密码认证、API令牌、代理认证（SSO）或组合方式
• 代理/SSO支持 - 与Authentik、Authelia和其他认证代理集成
• 企业级保护：
  • 凭证静态加密（AES-256-GCM）
  • 状态变更操作的CSRF令牌
  • 速率限制和账户锁定保护
  • 使用HttpOnly cookie的安全会话管理
  • bcrypt密码哈希（成本12）- 密码绝不会以明文存储
  • API令牌通过受限文件权限安全存储
  • 安全头（CSP、X-Frame-Options等）
  • 全面的审计日志
• 安全设计：
  • 前端从不接收节点凭证
  • API令牌仅对认证用户可见
  • 配置的导出/导入需要认证

详见https://github.com/rcourtman/Pulse/blob/main/docs/SECURITY.md%E3%80%82

HTTPS/TLS配置

通过设置以下环境变量启用HTTPS：

bash
docker run -d -p 7655:7655 \
  -e HTTPS_ENABLED=true \
  -e TLS_CERT_FILE=/data/cert.pem \
  -e TLS_KEY_FILE=/data/key.pem \
  -v pulse_data:/data \
  -v /path/to/certs:/data/certs:ro \
  rcourtman/pulse:latest

故障排除

认证问题

设置安全后无法登录

• Docker：确保bcrypt哈希正好60个字符，并使用单引号包裹
• Docker Compose：必须将$字符转义为$$（例如：$2a$12$...）
• 示例（docker run）：PULSE_AUTH_PASS='$2a$12$YTZXOCEylj4TaevZ0DCeI.notayQZ..b0OZ97lUZ.Q24fljLiMQHK'
• 示例（docker-compose.yml）：PULSE_AUTH_PASS='$2a$12$YTZXOCEylj4TaevZ0DCeI.notayQZ..b0OZ97lUZ.Q24fljLiMQHK'
• 如果哈希被截断或损坏，认证将失败
• 使用UI中的快速安全设置可避免手动配置错误

.env文件未创建（Docker）

• 预期行为：使用环境变量时，/data中不会创建.env文件
• .env文件仅在使用快速安全设置或更改密码时创建
• 如果通过环境变量提供凭证，它们具有更高优先级
• 要使用快速安全设置：启动容器时不提供认证环境变量

虚拟机磁盘统计显示"-"

• 虚拟机需要QEMU Guest Agent才能报告磁盘使用情况（Proxmox API对虚拟机返回0）
• 在虚拟机中安装客户代理：apt install qemu-guest-agent（Linux）或virtio-win工具（Windows）
• 在虚拟机选项→QEMU客户代理中启用，然后重启虚拟机
• 容器（LXC）磁盘统计始终有效（无需客户代理）

连接问题

• 检查Proxmox API是否可访问（端口8006/8007）
• 验证凭证至少具有PVEAuditor角色
• 对于PBS：确保API令牌具有Datastore.Audit权限

日志

bash
# 查看日志
docker logs pulse

# 跟踪日志
docker logs -f pulse

文档

完整文档见GitHub：

• https://github.com/rcourtman/Pulse/blob/main/docs/INSTALL.md
• https://github.com/rcourtman/Pulse/blob/main/docs/CONFIGURATION.md
• https://github.com/rcourtman/Pulse/blob/main/docs/VM_DISK_MONITORING.md - 设置QEMU客户代理以获取准确的虚拟机磁盘使用情况
• https://github.com/rcourtman/Pulse/blob/main/docs/TROUBLESHOOTING.md
• https://github.com/rcourtman/Pulse/blob/main/docs/API.md
• https://github.com/rcourtman/Pulse/blob/main/docs/WEBHOOKS.md
• https://github.com/rcourtman/Pulse/blob/main/docs/PROXY_AUTH.md - 与Authentik、Authelia等集成SSO
• https://github.com/rcourtman/Pulse/blob/main/docs/REVERSE_PROXY.md - nginx、Caddy、Apache、Traefik配置
• https://github.com/rcourtman/Pulse/blob/main/docs/SECURITY.md
• https://github.com/rcourtman/Pulse/blob/main/docs/FAQ.md

链接

• https://github.com/rcourtman/Pulse
• https://github.com/rcourtman/Pulse/releases
• https://github.com/rcourtman/Pulse/issues
• 在线演示

许可证

MIT - 详见https://github.com/rcourtman/Pulse/blob/main/LICENSE