Ops Dashboard Free

提供实时运维监控看板免费版，支持会话查看、定时任务监控、网关健康检查及基础安全扫描。

运维看板（免费版）

通过命令行驱动AI Agent执行运维巡检任务，查看会话状态、监控定时任务和检查系统健康度。免费版提供只读监控和基础安全检查功能。

概述

在AI Agent驱动的自动化工作流中，运维可见性是保障系统稳定运行的关键。运维看板将分散的运维信息（会话状态、任务执行、网关健康、安全配置）聚合为统一的命令行接口，让AI Agent能够通过自然语言指令快速完成日常巡检。

免费版聚焦只读监控能力，提供会话查看、任务状态检查和健康巡检功能，适合个人开发者和小团队的轻量级运维场景。

核心能力

能力模块	免费版支持	说明
会话查看	支持	列出和查看Agent会话状态
定时任务监控	支持	查看cron任务执行状态
健康检查	支持	网关和服务健康状态检查
安全扫描	基础	敏感信息扫描和报告
配置查看	支持	读取环境配置和默认值
成本分析	不支持	专业版提供
变更操作	不支持	专业版提供
告警通知	不支持	专业版提供
批量管理	不支持	专业版提供
审计日志	不支持	专业版提供

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：实时运维监控看板、免费版、支持会话查看、定时任务监控与基、础健康检查、运维看板免费版是、一款面向个人开发、者和小团队的实时、运维监控辅助、Skill、Agent、能够查看会话状态、监控定时任务执行、情况和检查系统健、实现轻量级的运维、可视化、核心能力、会话列表查看、定时任务状态监控、网关健康检查、基础安全扫描、配置文件管理、Use、when、需要系统监控、日志分析、运维告警、部署管理时使用、不适用于物理硬件等。

使用场景

场景一：每日运维巡检

每天快速检查系统运行状态，确认会话正常、定时任务按预期执行、网关健康。

场景二：定时任务监控

查看cron任务的最近执行结果，发现失败任务并及时处理。

场景三：安全配置审查

扫描配置文件中的敏感信息泄露风险，确保没有硬编码的Token或密钥。

快速开始

前置条件

1. Node.js 18+ 已安装
2. 运维看板服务已部署并运行
3. 服务默认监听http://localhost:3000

依赖详情

bash

# 检查服务是否运行
curl http://localhost:3000/api/health
# ...
# 查看帮助
node api-server.js --help

60秒上手

bash

# 1. 检查服务健康状态
curl http://localhost:3000/api/health
# ...
# 2. 查看活跃会话
curl http://localhost:3000/api/sessions
# ...
# 3. 查看定时任务状态
curl http://localhost:3000/api/cron
# ...
# 4. 查看网关健康
curl http://localhost:3000/api/gateway/health
# ...
# 5. 执行安全扫描
curl http://localhost:3000/api/security/scan

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤。

示例

环境变量配置

创建.env文件配置基础运行参数：

bash

# .env 文件
DASHBOARD_PORT=3000
DASHBOARD_HOST=localhost
# ...
# 认证Token（推荐设置）
OPS_DASHBOARD_AUTH_TOKEN=your_secure_token_here
# ...
# CORS配置（默认仅允许本地访问）
DASHBOARD_CORS_ORIGINS=http://localhost:3000

会话查看

bash

# 列出所有会话
curl http://localhost:3000/api/sessions
# ...
# 查看指定会话详情
curl http://localhost:3000/api/sessions/session-id
# ...
# 查看活跃会话
curl http://localhost:3000/api/sessions?status=active
# ...
# 带认证Token的请求
curl -H "Authorization: Bearer $OPS_DASHBOARD_AUTH_TOKEN" \
     http://localhost:3000/api/sessions

定时任务监控

bash

# 查看所有cron任务
curl http://localhost:3000/api/cron
# ...
# 查看任务执行历史
curl http://localhost:3000/api/cron/history
# ...
# 查看指定任务详情
curl http://localhost:3000/api/cron/task-name
# ...
# 查看失败的任务
curl http://localhost:3000/api/cron?status=failed

健康检查

bash

# 检查整体健康状态
curl http://localhost:3000/api/health
# ...
# 检查网关健康
curl http://localhost:3000/api/gateway/health
# ...
# 检查服务依赖
curl http://localhost:3000/api/health/dependencies

安全扫描

bash

# 扫描配置文件中的敏感信息
curl http://localhost:3000/api/security/scan
# ...
# 检查环境变量安全性
curl http://localhost:3000/api/security/env-check
# ...
# 查看安全配置状态
curl http://localhost:3000/api/security/config

配置查看

bash

# 查看当前运行配置
curl http://localhost:3000/api/config
# ...
# 查看环境变量（脱敏后）
curl http://localhost:3000/api/config/env
# ...
# 查看服务信息
curl http://localhost:3000/api/info

最佳实践

1. 设置认证Token：即使本地使用也建议设置OPS_DASHBOARD_AUTH_TOKEN，防止未授权访问。
2. 限制CORS来源：通过DASHBOARD_CORS_ORIGINS明确指定允许的来源，避免使用通配符*。
3. 定期执行安全扫描：将安全扫描纳入每日巡检流程，及时发现敏感信息泄露。
4. 监控定时任务失败率：关注cron任务的执行成功率，失败率突增时及时排查。
5. 配置文件脱敏：确保.env文件不包含明文密钥，使用占位符代替真实Token。

常见问题

Q1: 启动后无法访问页面？

检查服务是否正常监听。执行curl http://localhost:3000/api/health确认服务响应。若端口被占用，修改DASHBOARD_PORT环境变量。

Q2: API返回401未授权？

设置了OPS_DASHBOARD_AUTH_TOKEN后，所有请求需携带Authorization: Bearer <token>头。确认Token值正确且未过期。

Q3: CORS错误导致前端无法访问？

默认仅允许本地来源访问。如需跨域访问，设置DASHBOARD_CORS_ORIGINS为逗号分隔的允许来源列表。

Q4: 安全扫描报告显示敏感信息？

检查配置文件中是否有硬编码的Token、密钥或绝对路径。将敏感值替换为环境变量引用或占位符。

Q5: 定时任务状态显示"unknown"？

任务可能尚未执行或执行超时。检查任务配置和执行日志，确认cron表达式正确且任务脚本可正常执行。

依赖说明

运行环境

• Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统：Windows / macOS / Linux
• Node.js：18.0及以上版本
• 运行时：运维看板服务需持续运行

第三方依赖

依赖项	类型	是否必需	获取方式
Node.js	运行时	必需	从Node.js官网下载安装
Express	npm包	必需	通过npm install express安装
curl	命令行工具	必需	系统通常自带
LLM API	API	必需	由Agent平台内置LLM提供

API Key 配置

• 运维看板Token：通过OPS_DASHBOARD_AUTH_TOKEN环境变量配置
• 存储位置：建议存储在.env文件中（已加入.gitignore）
• 禁止：在代码或配置文件中硬编码Token
• 默认行为：未设置Token时仅允许本地访问，设置后需在请求头中携带

可用性分类

• 分类：MD+EXEC（纯Markdown指令，需要exec命令行执行能力）
• 说明：基于Markdown的AI Skill，通过自然语言指令驱动Agent执行运维看板API调用

已知限制

本免费体验版限制以下高级功能：

• 成本分析与用量统计（专业版提供Token消耗和API成本追踪）
• 变更操作与备份管理（专业版支持任务执行、备份创建和模型切换）
• 告警通知与自动响应（专业版支持阈值告警和自动重启）
• 批量会话管理（专业版支持批量终止、归档和清理）
• 审计日志与操作追踪（专业版提供完整操作审计链）
• 服务商审计集成（专业版支持调用AI服务商组织API）
• 系统级操作（专业版支持systemctl重启等系统管理操作）

解锁全部功能请使用专业版：ops-dashboard-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

输出格式

json

{
  "success": true,
  "data": {
    "result": "运维看板(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "ops dashboard"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}