HarborForge.Monitor

轻量级 Go 遥测客户端，用于把服务器硬件状态上报到 HarborForge Monitor。

它不依赖 OpenClaw，适合普通 Linux 主机、VPS、Nginx 机器等。

采集内容

• CPU 使用率
• 内存使用率
• 磁盘使用率
• Swap 使用率
• Load Average
• Uptime
• Nginx 是否安装
• /etc/nginx/sites-enabled 列表

上报接口

客户端调用：

• POST /monitor/server/heartbeat-v2
• Header: X-API-Key

项目结构

HarborForge.Monitor/
├── cmd/harborforge-monitor/      # 程序入口
├── internal/config/              # 配置加载
├── internal/telemetry/           # 指标采集与上报
├── scripts/install.sh            # 安装脚本
├── systemd/harborforge-monitor.service
├── config.example.json
└── README.md

配置

先在 HarborForge Monitor 中注册服务器并生成 API Key。

然后准备配置文件，例如 /etc/harborforge-monitor/config.json:

{
  "backendUrl": "https://monitor.hangman-lab.top",
  "identifier": "vps-nginx-01",
  "apiKey": "your-api-key",
  "reportIntervalSec": 30,
  "logLevel": "info"
}

也支持环境变量覆盖：

• HF_MONITOR_BACKEND_URL
• HF_MONITOR_IDENTIFIER
• HF_MONITOR_API_KEY
• HF_MONITOR_REPORT_INTERVAL
• HF_MONITOR_LOG_LEVEL

本地开发

go mod tidy
go build ./cmd/harborforge-monitor
./harborforge-monitor -config ./config.example.json -dry-run -once

安装

sudo ./scripts/install.sh

安装脚本会：

• 构建二进制 harborforge-monitor
• 安装到 /usr/local/bin/
• 安装 systemd service
• 初始化 /etc/harborforge-monitor/config.json
• 自动启用并启动服务

注意

• 当前 Nginx site 列表读取的是 /etc/nginx/sites-enabled
• 如果机器没有安装 Nginx，会回报 nginx_installed = false
• 该客户端不会尝试读取 OpenClaw 信息，agents 默认为空，openclaw_version 不上报