引言
你有没有过这样的夜晚?凌晨 2 点,手机在枕头底下疯狂震动,是 Zabbix 的告警短信。你从床上弹起来,眼睛都睁不开,摸过电脑就开始 SSH 登录服务器。翻 3 个 G 的日志,查 CPU、内存、磁盘、进程,杀僵尸进程,重启服务,折腾到 4 点终于解决。第二天早上 9 点,你还要准时到公司,写故障报告,复盘,整改,优化监控。日复一日,年复一年。
我一直在想:这些重复性的工作,能不能让 AI 来帮忙?
于是有了这个项目 —— ITOps Agent Platform,一个我利用业余时间开发的运维自动化平台。它的核心想法很简单:把运维经验变成 AI Agent 的能力,让机器去巡检、去诊断、去处理告警,让人去做更有价值的事情。把它开源,不是为了出名,也不是为了赚钱,只是想找一群和我一样,热爱 IT 的同行,趁着 AI 的东风一起把这件事做成。
这是个人项目,代码写得不够优雅,文档也不够完善,但它是真心实意想要解决运维人的痛点。 如果你也经历过那些熬夜排障的夜晚,也许你会理解我想做的事情。
项目地址如下(国内建议访问 Gitee 或 GitCode)
GitHub:https://github.com/qinshihu/itops-agent-platform
Gitee:https://gitee.com/IT_Oline/itops-agent-platform
GitCode:https://gitcode.com/gcw_IM7aAihp/itops-agent-platform
一、ITOps Agent Platform 是什么?
ITOps Agent Platform 是一个基于大语言模型的企业级运维自动化平台,通过可视化工作流编排多个 AI Agent 协同工作,实现服务器巡检、告警处理、故障诊断、合规检查等运维任务的自动化。市面上不缺监控工具,不缺 AI 聊天机器人,但真正能把 AI Agent + 运维工作流 + 实际业务场景 结合起来的全开源项目,几乎没有。
核心特性
二、AlmaLinux 10 简介
AlmaLinux 是一个 1:1 兼容 RHEL 的企业级 Linux 发行版,由社区驱动、免费且开源。AlmaLinux 10 是该系列的最新稳定版本,基于 RHEL 10 构建,提供最新的安全特性和性能优化。选择 AlmaLinux 10 的原因:
三、准备工作
3.1 系统要求
3.2 检查系统版本
登录服务器后,执行以下命令确认系统版本(Centos7+按理说命令都是兼容的):
cat /etc/os-release
3.3 安装必要工具
AlmaLinux 10 已预装大部分工具,但需要确保 Docker 可用:
# 更新软件包sudo dnf update -y# 安装 Docker(如果尚未安装)sudo dnf install -y dockersudo systemctl enable dockersudo systemctl start docker# 验证 Docker和compose版本docker --versiondocker compose version
3.4 配置防火墙
开放必要的端口:
# 开放前端端口(8080)sudo firewall-cmd --permanent --add-port=8080/tcp# 开放后端 API 端口(3001,可选,仅调试时需要)sudo firewall-cmd --permanent --add-port=3001/tcp# 重新加载防火墙规则sudo firewall-cmd --reload# 查看已开放的端口sudo firewall-cmd --list-ports
四、一键部署(推荐)
很多人说开源项目部署麻烦,我特意写了个部署脚本,复制下面一条命令直接运行。
curl -sL https://gitee.com/IT_Oline/itops-agent-platform/raw/main/deploy.sh -o deploy.sh && chmod +x deploy.sh && ./deploy.sh脚本支持
-y参数自动确认提示(./deploy.sh -y),也可手动输入y确认。☕ 喝杯咖啡的功夫(2 分钟)平台就跑起来了,脚本会自动完成:
检查 Docker 环境 从阿里云拉取最新镜像 生成随机 JWT_SECRET 启动前后端服务 验证健康状态
🎉部署完成约 1-3 分钟,看到以下输出表示成功:

前端: http://你的服务器 IP:8080健康检查:http://localhost:3001/health
五、部署方式二:Docker Compose 部署
如果你希望更精细地控制部署过程,可以使用 Docker Compose 手动部署。
5.1 获取项目代码
git clone https://github.com/qinshihu/itops-agent-platform.gitcd itops-agent-platform
5.2 配置环境变量(仅需配 JWT_SECRET)
cp .env.example .envvim .env
编辑 .env,至少设置以下一项:
# JWT 密钥(生产环境必须,一键部署脚本已自动生成)JWT_SECRET=your-random-secure-secret-key-here
💡 重要说明:
JWT_SECRET:不配置后端将无法启动。可用openssl rand -hex 32生成AI API 密钥(DOUBAO_API_KEY / OPENAI_API_KEY)不需要在 .env中配置!AI 密钥可在登录后通过前端页面配置,见第 6.3 节
5.3 启动服务
# 拉取镜像并启动服务docker compose up -d# 查看服务状态docker compose ps# 查看后端日志docker compose logs -f backend# 查看前端日志docker compose logs -f frontend
5.4 验证部署
# 检查后端健康状态curl http://localhost:3001/health# 检查前端是否可访问curl -I http://localhost:8080
六、访问和使用
6.1 登录系统
浏览器访问:http://<服务器IP>:8080

6.2 默认管理员账号
admin | |
admin |
️ 安全提示:首次登录后系统会强制要求修改密码,请务必及时修改!
6.3 配置 AI API 密钥(推荐方式:前端配置)
🎯 无需在部署时配置
.env!AI 密钥可直接在前端设置,保存到数据库,重启不丢失。
登录后,进入 设置 → AI 配置,填写以下信息:

| 豆包 API(国内用户) | |
| OpenAI API | |
doubao-pro-32k、gpt-4o 等 |
配置后立即可用,所有 AI Agent、Copilot、RAG 功能将自动启用。
💡 配置优先级:前端数据库配置 >
.env环境变量。建议直接在前端配置,更方便管理。
七、常见问题
Q1:Docker 服务启动失败
解决方案:
# 查看 Docker 服务状态sudo systemctl status docker# 重启 Docker 服务sudo systemctl restart docker# 查看日志sudo journalctl -u docker -f
Q2:端口被占用
解决方案:
# 查看端口占用情况sudo netstat -tlnp | grep 8080sudo netstat -tlnp | grep 3001# 修改 docker-compose.yml 中的端口映射vim docker-compose.yml# 将 8080:80 改为 8888:80
Q3:服务启动后无法访问
解决方案:
# 检查防火墙是否开放端口sudo firewall-cmd --list-ports# 检查 SELinux 状态getenforce# 临时关闭 SELinux(仅用于调试)sudo setenforce 0# 查看服务日志docker compose logs backenddocker compose logs frontend
Q4:AI 功能无法使用
解决方案:
检查是否已在前端 设置 → AI 配置 中填写了正确的 API Key 确认服务器可以访问外部 API(豆包/OpenAI,国内用户推荐豆包) 查看后端日志中的错误信息: docker compose logs backend
八、服务管理
启动服务
docker compose up -d停止服务
docker compose down重启服务
docker compose restart查看日志
# 查看实时日志docker compose logs -f# 查看后端日志docker compose logs -f backend# 查看前端日志docker compose logs -f frontend
更新服务
# 拉取最新镜像docker compose pull# 重新构建并启动docker compose up -d --build
九、项目截图预览
仪表盘
系统概览,展示服务器、告警、任务等核心指标。

数据大屏

多 Agent 协作

Web SSH 终端
基于 xterm.js 的交互式远程终端,支持实时输入输出、窗口自适应。

工作流编排
可视化拖拽式编辑器,支持串行/并行/条件分支。

告警中心
Webhook 接收 Prometheus/Zabbix/通用告警,自动降噪与工作流触发。
十、技术支持
GitHub:https://github.com/qinshihu/itops-agent-platform Gitee:https://gitee.com/IT_Oline/itops-agent-platform GitCode:https://gitcode.com/gcw_IM7aAihp/itops-agent-platform 文档:项目仓库内有完整的中文文档 Issues:遇到问题可在 GitHub 提交 Issue 项目官网:https://www.zjzwfw.cloud/ITOpsAgentinfo

夜雨聆风