# itops-agent-platform **Repository Path**: IT_Oline/itops-agent-platform ## Basic Information - **Project Name**: itops-agent-platform - **Description**: 国内首个开源企业级 IT 运维多 Agent 自动化平台 — 基于大语言模型的智能运维解决方案。ITOps Agent Platform 是一个企业级全栈运维自动化平台，通过可视化工作流编排，将多个AI Agent组合成智能运维自动化流水线，实现服务器管理、告警处理、故障诊断、日志分析、脚本管理、定时运维任务的自动化执行，支持火山引擎/OpenAI双LLM模型。 - **Primary Language**: NodeJS - **License**: MPL-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 10 - **Forks**: 8 - **Created**: 2026-05-21 - **Last Updated**: 2026-05-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: 运维, 监控系统, Docker, AI, devops ## README ⚠️ **重要许可证变更通知（2026-05-27）** 本项目自今日起，所有新提交的代码将采用 **Mozilla Public License 2.0 (MPL-2.0)** 许可证开源。 - 2026年5月27日 16:00 之前提交的所有代码，仍遵循原 MIT 许可证 - 任何基于本项目 2026-05-27 之后版本的衍生作品，必须遵守 MPL-2.0 许可证 - 如需**闭源二次开发、打包销售、SaaS化运营**等商业用途，请联系作者获取专属商业许可证 📧 商业授权联系：huawei_network@foxmail.com | 微信公众号：IT Online 👤 作者：谭策 | IT Online # ITOps Agent Platform 企业级 IT 运维多 Agent 自动化平台 — 基于大语言模型的智能运维解决方案。 [项目愿景与社区共建](docs/项目愿景与社区共建.md) [项目入门学习文档](docs/book/README.md) [![CI](https://github.com/qinshihu/itops-agent-platform/actions/workflows/ci.yml/badge.svg)](https://github.com/qinshihu/itops-agent-platform/actions/workflows/ci.yml) [![Release](https://github.com/qinshihu/itops-agent-platform/actions/workflows/release.yml/badge.svg)](https://github.com/qinshihu/itops-agent-platform/actions/workflows/release.yml) [![GitHub release](https://img.shields.io/github/v/release/qinshihu/itops-agent-platform?include_prereleases&sort=semver)](https://github.com/qinshihu/itops-agent-platform/releases/latest) [![License](https://img.shields.io/badge/license-MPL--2.0-blue.svg)](LICENSE) 🌐 **项目官网**: 0cpuy-fbfi3 0cpuy-fbfi3 ## 项目简介 ITOps Agent Platform 是一个企业级全栈运维自动化平台，通过可视化工作流编排多个 AI Agent 协同工作，实现服务器巡检、告警处理、故障诊断、合规检查等运维任务的自动化。 ```mermaid graph TB Browser["浏览器"] --> Nginx["Nginx 反向代理"] Nginx --> React["React 前端
30+个页面 | Zustand | @xyflow/react"] Nginx --> Express["Express 后端
31个路由 | 20+个服务 | JWT认证"] React <-->|"WebSocket 实时通信"| Express Express --> SQLite[("SQLite 数据库
39张表 | AES-256加密")] Express --> LLM["🤖 LLM API
豆包 | OpenAI"] Express --> SSH["🖥️ SSH 远程服务器"] Express --> Webhook["🚨 告警 Webhook
Prometheus | Zabbix"] Express --> Notify["📬 通知渠道
邮件 | 企业微信 | 钉钉"] ``` > 📐 [查看完整架构图 →](./docs/ARCHITECTURE_DIAGRAM.md) ### 核心特性 - **多 Agent 协作** — 9 个预设运维 Agent，支持自定义创建，覆盖告警、诊断、巡检、变更等场景 - **可视化工作流** — 拖拽式编排，支持串行/并行/条件分支，实时 WebSocket 推送执行进度 - **Web SSH 终端** — 基于 xterm.js 的交互式远程终端，支持实时输入输出、窗口自适应、双向实时通信 - **主机管理增强** — 多级分组树形结构、CSV/JSON 批量导入、SSH 自动信息采集（CPU/内存/磁盘/OS） - **数据导入导出** — 支持 CSV/JSON 格式批量导入服务器，导出告警、审计日志、报表数据 - **备份恢复** — 完整的数据库备份与恢复流程，支持压缩、完整性校验和恢复后自动优雅重启 - **自动修复** — 告警自动触发修复策略，支持自定义修复工作流和审批流程 - **根因分析** — AI 驱动的告警根因分析，快速定位问题源头 - **告警降噪** — 智能告警去重和抑制，减少告警风暴 - **服务器管理** — SSH 远程连接，命令执行与历史审计，14 项合规检查 - **告警中心** — Webhook 接收 Prometheus/Zabbix/通用告警，自动降噪与工作流触发 - **知识库 + RAG** — 22 条预设知识条目，智能检索注入 LLM 上下文 - **AI Copilot** — 自然语言对话式运维助手，自动感知系统状态 - **多模型支持** — 同时支持豆包（Doubao）、OpenAI 和本地部署大模型（Ollama/LM Studio/vLLM 等 OpenAI 兼容接口），数据可完全不出域 - **企业级安全** — AES-256-GCM 敏感数据加密、JWT 认证、速率限制、审计日志、内存泄漏防护 - **Docker 一键部署** — 前后端容器化，5 分钟上线，支持阿里云镜像仓库和本地开发热重载 - **CI/CD 自动化** — 完整的 GitHub Actions 流水线，自动构建、测试、发布和镜像推送 ## 安全特性 项目采用多层安全设计，保障您的服务器和数据安全： | 安全措施 | 说明 | |---------|------| | **🔐 AES-256-GCM 加密** | 服务器密码和 SSH 密钥采用银行级加密存储，密钥自动生成 | | **🎫 JWT 双令牌认证** | Access Token + Refresh Token 机制，自动刷新，黑名单登出 | | **📜 完整操作审计** | 所有登录、命令执行、配置变更均有详细审计日志，可追溯 | | **🚫 敏感信息脱敏** | 密码、API 密钥等敏感信息在日志和输出中自动脱敏 | | **🛡️ 非 root 运行** | Docker 容器以非 root 用户运行，遵循最小权限原则 | | **🧱 Nginx 安全头** | HSTS、CSP、X-Frame-Options、XSS 防护等安全配置 | | **⚡ API 速率限制** | 防止恶意请求和暴力破解，保护接口安全 | | **🏠 本地 AI 支持** | 支持 Ollama、LM Studio、vLLM 等本地部署模型，数据 100% 不出域 | | **🔑 强制密码修改** | 首次登录系统强制要求修改默认密码，杜绝弱口令风险 | > **数据安全目标**：所有服务器凭证只在本地加密存储，不会发送给任何第三方 AI。Agent 执行的命令和输出也只在您的服务器内部流转。 ## 支持的 AI 模型 | 类型 | 提供商/框架 | 支持情况 | 推荐场景 | |------|------------|---------|---------| | **国内云 API** | 火山引擎 · 豆包 (Doubao) | ✅ 完全支持 | 国内用户推荐，稳定快速 | | **国际云 API** | OpenAI (GPT-4o 等) | ✅ 完全支持 | 有外网环境用户 | | **本地部署** | Ollama / LM Studio / vLLM | ✅ 完全支持 | 数据安全要求高，内网部署 | **本地模型推荐**：Qwen2.5、Llama3、DeepSeek-Coder、Yi、ChatGLM、Phi-3 等开源大模型（兼容 OpenAI 接口）。 ## 技术栈 | 层 | 技术 | | ------ | ------------------------------------------- | | 前端 | React 18 + TypeScript + Tailwind CSS + Vite | | 状态管理 | Zustand + React Query | | 工作流编辑器 | @xyflow/react | | 后端 | Node.js + Express + TypeScript | | 数据库 | SQLite (better-sqlite3) | | 实时通信 | Socket.io | | 远程连接 | SSH2 | | 部署 | Docker + Docker Compose + Nginx | ## 快速开始 ### 方式一：一键脚本部署（推荐） ```bash # Windows .\deploy.ps1 # Linux/Mac chmod +x deploy.sh && ./deploy.sh ``` 脚本会自动拉取阿里云镜像、生成配置、启动服务并验证健康状态。 ### 方式二：Docker Compose 部署 ```bash # 1. 配置环境变量 cp .env.example .env # 2. 构建并启动（本地源码构建） docker-compose up -d --build # 3. 访问 # 前端: http://localhost:8080 # 后端: http://localhost:3001 # 健康: http://localhost:3001/health ``` ### 方式三：手动拉取阿里云镜像部署 ```bash # 拉取镜像 docker pull registry.cn-hangzhou.aliyuncs.com/huluwa666/tsq-images-hub:IT_Onlin-ITOps-backend-latest docker pull registry.cn-hangzhou.aliyuncs.com/huluwa666/tsq-images-hub:IT_Onlin-ITOps-frontend-latest # 启动服务 docker-compose up -d ``` 也可使用简化版： ```bash docker-compose -f docker-compose.simple.yml up -d --build ``` 或一键脚本： ```bash # Windows .\start.ps1 # Linux/Mac chmod +x start.sh stop.sh && ./start.sh ``` ### 本地开发 #### 方式一：源码本地开发（热重载） ```bash # 使用本地开发环境（推荐） cd local-dev start-dev.bat # Windows # 或 ./start-dev.sh # Linux/Mac ``` - 前端：Vite 热重载，修改代码即时刷新 http://localhost:5173 - 后端：tsx watch 热重载，修改代码自动重启 http://localhost:3001 - 数据库：Docker volume 持久化，停止容器不丢失数据 #### 方式二：传统本地开发 ```bash # 后端 cd backend && npm install && npm run dev # 前端 cd frontend && npm install && npm run dev ``` **默认管理员**: `admin` / `admin` > ⚠️ 首次登录后系统会强制要求修改密码 image ## 功能模块 ### 仪表盘 系统概览，展示服务器、告警、任务等核心指标。 屏幕截图 2026-05-18 144450 ### Web SSH 终端 - 基于 xterm.js 的交互式 SSH 终端 - 实时双向通信（WebSocket） - 窗口大小自适应 - 连接状态可视化 - 终端会话管理（30 分钟 TTL 自动清理） image ### 主机管理 - 多级分组树形结构，按分组筛选服务器 - CSV/JSON 批量导入，自动验证 SSH 连通性和去重 - 一键采集主机信息（OS/CPU/内存/磁盘/IP） - 服务器卡片展示分组标签和硬件信息 - 支持 CSV/JSON 格式导出服务器列表 image ### 服务器管理 - 添加/编辑/删除服务器，支持 SSH 密码或密钥认证 - 标签筛选、连接测试 - 在线 Shell 命令执行，命令历史审计 - 14 项系统合规检查（CPU/内存/磁盘/网络/服务/安全等） - 命令历史和合规历史 JSON 导出 屏幕截图 2026-05-18 144417 ### Agent 管理 - 9 个预设 Agent：告警处理、故障诊断、日志分析、系统巡检、变更执行、文档生成、合规检查、服务器命令执行、自动巡检 - 支持自定义创建 Agent，配置系统提示词、模型、温度参数 - Agent 测试与执行历史追踪 image ### 工作流编排 - 可视化拖拽式编辑器 - 6 个预设工作流模板 - 支持上下文传递、服务器选择 - 执行顺序拓扑排序，视觉位置优先 屏幕截图 2026-05-18 144326 ### 任务执行 - 实时 WebSocket 推送执行进度 - 节点高亮、思考过程展示 - 支持暂停/继续/取消 - 自动生成 Markdown 执行报告 image ### 告警中心 - Webhook 接收：Prometheus Alertmanager / Zabbix / 通用格式 - 告警自动降噪去重 - 告警→工作流自动映射触发 - 状态管理：新建/已确认/已解决 ### 通知系统 - 支持 Webhook、邮件、企业微信、钉钉通知 - 通知配置管理 - 系统通知自动推送 ### 数据导入导出 - CSV 格式批量导入服务器列表（提供标准模板下载） - 智能去重：hostname+name 联合去重，自动跳过重复服务器 - 详细错误报告：每行错误信息单独返回，便于定位问题 - 事务保证：要么全部成功要么全部失败，不会部分导入 - 支持导出：服务器列表、告警数据、审计日志、报表 - 导出格式：CSV（Excel 可直接打开）和 JSON ### 备份恢复 - 自动/手动备份数据库，支持 gzip 压缩 - 备份完整性校验（文件大小验证） - 恢复备份后自动优雅重启，确保数据一致性 - 备份历史管理和清理策略 - 支持定时自动备份 ### 知识库 - 22 条预设知识条目 - 增强 RAG 检索，关键词+语义相关度排序 - 自动注入 LLM 对话上下文 - 批量导入/导出 image ### AI Copilot - 自然语言对话式运维助手 - 自动感知系统告警、服务器、任务状态 - 基于规则的快速响应 + LLM 深度分析 image ### 定时任务 - 4 个预设定时任务 - Cron 表达式配置 - 自动执行指定工作流 ### 用户与审计 - 用户管理（admin/operator/viewer 角色） - JWT 认证 + Token 黑名单 - 完整操作审计日志 ### 报告系统 - 工作流执行自动生成 Markdown 报告 - 报告模板管理 - 报告查看与下载 ## 项目结构 ``` ├── backend/ │ └── src/ │ ├── app.ts # Express 应用入口 │ ├── models/database.ts # SQLite 数据库初始化和预设数据 │ ├── routes/ # API 路由（31 个模块） │ ├── services/ # 业务逻辑（20+ 个服务） │ ├── middleware/ # 中间件（6 个：auth, errorHandler, rateLimiter, validation, trace, commandFilter） │ ├── websocket/ # WebSocket 实时通信 │ └── utils/ # 工具函数 ├── frontend/ │ └── src/ │ ├── App.tsx # React 应用入口 │ ├── pages/ # 页面组件（27 个） │ ├── components/ # 通用组件 │ ├── contexts/ # React Context │ ├── hooks/ # 自定义 Hooks │ └── lib/ # 工具库 ├── docker/ # Docker 生产配置 ├── docs/ # 技术文档 ├── examples/ # 测试脚本和示例 ├── .github/workflows/ # GitHub Actions CI/CD 配置 ├── docker-compose.yml # 生产级 Docker Compose ├── docker-compose.simple.yml # 简化版 Docker Compose ├── deploy.ps1 / deploy.sh # 一键部署脚本 ├── start.ps1 / start.sh # 一键启动脚本 ├── stop.ps1 / stop.sh # 一键停止脚本 └── .env.example # 环境变量示例 ``` ## 文档导航 | 文档 | 说明 | | ------------------------------------ | -------------- | | [部署手册](./DEPLOYMENT.md) | 详细部署操作说明 | | [技术规范](./SPEC.md) | 功能规范和接口定义 | | [API 文档](./docs/API.md) | 完整 API 接口文档 | | [架构设计](./docs/ARCHITECTURE.md) | 系统架构说明 | | [开发指南](./docs/DEVELOPMENT.md) | 本地开发环境搭建 | | [生产环境](./docs/PRODUCTION.md) | 生产部署最佳实践 | | [Web 终端](./WEB_TERMINAL.md) | Web SSH 终端技术文档 | | [主机管理](./SERVER_MANAGEMENT.md) | 主机管理增强功能文档 | | [Zabbix 集成](./docs/ZABBIX_CONFIG.md) | Zabbix 告警集成配置 | | [变更日志](./CHANGELOG.md) | 版本更新记录 | | [测试指南](./TEST_GUIDE.md) | 功能测试说明 | ## 环境变量 | 变量 | 说明 | 默认值 | | ----------------- | ------------- | ------------------------------------------ | | `NODE_ENV` | 运行环境 | development | | `PORT` | 后端端口 | 3001 | | `DATABASE_PATH` | 数据库路径 | ./data/app.db | | `JWT_SECRET` | JWT 签名密钥 | 开发环境自动生成 | | `JWT_EXPIRES_IN` | Token 有效期 | 24h | | `ALLOWED_ORIGINS` | CORS 允许来源 | | | `DOUBAO_API_KEY` | 豆包 API 密钥 | - | | `DOUBAO_API_BASE` | 豆包 API 地址 | | | `DOUBAO_MODEL` | 豆包模型 | doubao-4o | | `OPENAI_API_KEY` | OpenAI API 密钥 | - | | `OPENAI_API_BASE` | OpenAI API 地址 | | | `OPENAI_MODEL` | OpenAI 模型 | gpt-4o | | `LOG_LEVEL` | 日志级别 | info | ## 安全特性 - 服务器密码和 SSH 密钥 AES-256-GCM 加密存储 - JWT 认证 + Token 黑名单机制（数据库错误时安全降级：拒绝） - access_token + refresh_token 双 token 机制，自动刷新 - API 速率限制 - bcrypt 密码哈希（成本因子 12） - 完整操作审计日志 - 敏感信息自动脱敏 - Nginx 安全头（HSTS/CSP/X-Frame-Options/XSS-Protection） - 部署脚本默认 admin/admin 初始密码，首次登录强制修改 - 邮件模板 XSS 防护（HTML 转义） - Graceful Shutdown（优雅关闭，30s 超时保护） - 非 root 用户容器运行 + 最小权限文件权限 ## 🚀 CI/CD 自动化 本项目配置了完整的 GitHub Actions CI/CD 流水线： | 流水线 | 触发条件 | 功能 | |--------|---------|------| | [CI](.github/workflows/ci.yml) | Push/PR 到 main | Lint + TypeScript 检查 + 测试 + Docker 构建验证 | | [Release](.github/workflows/release.yml) | 推送 tag (`v*`) 或手动 | 构建 Docker 镜像 → 推送阿里云 → 自动创建 GitHub Release | | [Mirror](.github/workflows/mirror.yml) | Push 到 main 或手动 | 自动同步代码到 Gitee/Gitcode | > 📖 详细配置指南：[docs/CICD_SETUP.md](docs/CICD_SETUP.md) ## 作者 **谭策** — 独立开发者 | AIOps 领域探索者 - 🌐 项目官网：[ITOpsAgentinfo](https://www.zjzwfw.cloud/ITOpsAgentinfo) - 📝 博客：[zjzwfw.cloud](https://www.zjzwfw.cloud/) - 📧 邮箱： - 💬 微信公众号：**IT Online**

IT Online 微信公众号

## 许可证 [MPL-2.0](./LICENSE) © 谭策