LZ-Agent · 机房自动化执行中心说明书 · 机房自动化执行中心展示说明书架构日志
lz-agent

现场操作与系统说明

本说明书覆盖平台全部功能模块。左侧目录可逐章跳转,每章独立成页;扫下方二维码即可分享给他人。

▶ 视频导读首屏视频

🎬

视频导读位

管理员可在后台「说明书设置」配置远程视频

✦ 书签点击跳转时间点

目录书签点书签 · 视频自动跳转
书签列表预留位
管理员可在后台「说明书设置」中配置
导读

🤖LZ-Agent · 机房自动化执行中心说明书

核心介绍

这是什么

LZ-Agent 是部署于 L-Ubt Agent 节点(192.168.11.77)的机房自动化执行中心。系统本身具备完整的执行能力:SSH 跨节点执行器、工单系统、定时巡检、主机白名单守卫——这些都不依赖 AI,开箱即用。

AI 只是附加功能:当基础设施按固定规则解决不了问题时,才上报工单,由 AI 基于系统自带能力进行研判与自动化处置。没有 AI,系统照常执行、照常巡检、照常守卫。

  • 设备:L-Ubt Agent · 192.168.11.77
  • 服务端口:5010(内网 http://192.168.11.77:5010/,公网 http://119.145.17.34:5010/ 经网关映射)
  • 角色:.73 部署服务器的备份节点,出口线路由控制台统一调度
  • 运行:gunicorn 4 workers(gthread,timeout 900),systemd 常驻,开机自启

一、系统自带能力(不依赖 AI)

🖥️ 跨节点执行(5 类执行器)

注册表 executors/__init__.py 共 5 类、10 个别名,按 executor_type 分发,全部由系统本地代码执行、结果直接回传:

执行器 别名 作用 关键参数
ShellExecutor shell / shell_command 本机 subprocess 或跨节点 SSH command / host / cwd / timeout(默认60s) / env
RemoteShellExecutor remote_shell / remote_command SSH 跨节点执行 command / host / timeout
HTTPExecutor http / http_request 发起 HTTP 请求 url / method / headers / params / json / data / timeout
FileExecutor file / file_operation 文件读写删建目录 operation(read/write/delete/list/mkdir) / path / content
PythonExecutor python / python_execute 受限沙箱执行 Python code / variables(禁 os.system/subprocess/eval/exec/import)

SSH 直连参数(shell_executor.py / remote_shell_executor.py 内 _SSH_CONFIG):

节点 用户 认证 说明
192.168.11.71 lz 密码 + sudo -S 提权 Safe
192.168.11.74 lz 密码 + sudo -S 提权 Safe01
192.168.11.75 lz 密码 + sudo -S 提权 Safe02
192.168.11.73 lz 密码 + sudo -S 提权 Control
192.168.11.70 leonzion 密钥 ai-admin-key,无 sudo TK-Station

不在表中的 host 直接返回 Unknown host 失败;host 为空/localhost/127.0.0.1 走本机执行。stdout 截断 5000 字符、stderr 2000 字符,SSH 建连超时 8s。

🎫 工单系统

任务以工单流转,从下发到执行到反馈全程可追溯。工单存 tickets 表,流转记录存 ticket_logs 表——这是系统自身的流转中枢,人工与 SecOps 都可直接建单,无需经过 AI:

方法 路径 说明
GET/POST /api/tickets 工单列表 / 创建工单(SecOps 外部调用,必填 title)
GET/PUT/DELETE /api/tickets/ID 详情(含流转日志)/ 更新状态与结果 / 删除

工单字段:ticket_no(自动 TKT-时间戳)/ title / category(默认 security)/ severity(默认 medium)/ source(默认 secops)/ status / description / agent_task_id / resolution / created_by。

⏰ 定时巡检

周期性巡检任务由 cron 调度,异常主动上报并生成工单。当前策略:AI 巡检改为仅手动启动(2026-10-22 起自动 cron 已停用),详见《定时巡检》一章。

🔒 主机白名单守卫(ops_guard.py)

系统自带的安全门:仅允许操作安全三机 .71/.74/.75、路由器 172.168.100.1 与本机 .77;仅约束 dailyops 类 Agent 的 shell 类动作;本机执行永远放行。详见《安全设计》。

🎛️ 控制台(/console)

模型设置(默认提供方 / 中转站模型 ID 一键拉取 / 地址 Key 超时 / 连通性测试 / 恢复默认)/ 执行记录(统计 + 筛选 + 15s 刷新)/ Agent 卡片。详见《控制台》。

二、基础设施框架

机房节点(.70/.71/.73/.74/.75)
    ↕ paramiko SSH(密码 / 密钥,sudo 提权)
LZ-Agent · 192.168.11.77:5010(gunicorn 4 workers,systemd 常驻)
    ├─ 执行器层:shell / remote_shell / http / file / python
    ├─ 工单层:tickets + ticket_logs(SQLite agent.db)
    ├─ 巡检层:cron + --manual 守卫 + SecOps 侧总开关
    ├─ 守卫层:ops_guard 主机白名单
    └─ 对外:REST API(tasks / tickets / agents / skills / model-settings / chat / v1/*)
         ↕
LZ-SecOps(192.168.11.71:5011):告警研判与建单,结果回写
  • 数据:data/agent.db(agents/tasks/task_logs/iterations/tickets/ticket_logs),opencode.db(会话),data/model_settings.json(模型热切换)
  • 页面路由:/ 首页、/agents、/skills、/tasks、/tasks/ID 详情、/console 控制台
  • 联动:SecOps 负责告警研判与建单,本项目承接处置指令在机房实际执行并回写结果

三、AI 附加功能(解决基础设施解决不了的问题)

系统按固定规则能处理的事情不需要 AI。只有当巡检发现异常、或工单超出预设规则能处理的范围时,AI 才介入:基于上述执行器与工单能力进行研判,自动规划处置动作并验证结果。

flowchart TB
    J[定时巡检 cron] --> B[工单系统 tickets]
    A[LZ-SecOps 处置工单] --> B
    B --> C{规则可解?}
    C -->|是| F[执行器直接执行]
    C -->|否·上报| D[AI 研判规划 relay 模型]
    D --> F
    F --> G[机房节点 SSH]
    G --> H{结果验证}
    H -->|未通过| D
    H -->|通过| I[回写工单 / 异常上报]
  • 自主循环引擎:HTTP 驱动的规划-执行-验证循环,默认上限 20 轮、最大 10 并发、迭代间隔 1s;同一动作连续下发 2 次即熔断纠正;致命 LLM 错误(401/403/欠费/模型不存在)首轮终止。
  • 执行证据校验:success 分支强制校验,拦截模型编造的虚假报告(详见《安全设计》)。
  • 模型通道:唯一来源自建中转站(http://192.168.11.76:18080/v1,默认 relay + Zen-big-pickle);中转站免费模型不可用于运维执行(实测编造结果),生产巡检需更强模型。

访问入口

渠道 地址 说明
内网首页 http://192.168.11.77:5010/ 工单面板与导航
控制台 http://192.168.11.77:5010/console 模型设置 / 执行记录 / Agent 卡片
任务页 http://192.168.11.77:5010/tasks 执行中/待执行/已完成任务
Agent 页 http://192.168.11.77:5010/agents Agent 管理
Skill 页 http://192.168.11.77:5010/skills Skill 管理
展示站 官网项目卡「展示」入口 功能特性与技术栈介绍
说明书 当前页面 使用指引与常见问题
架构页 官网项目卡「架构」入口 定位 / 架构 / 数据流 / 接口 + Mermaid 图

界面导览

  1. 打开首页进入工单/任务面板:查看执行中 / 待执行 / 已完成任务。

系统首页

  1. 点击任务详情:查看 AI 规划步骤、执行器命令与回传结果(/tasks/<task_id>)。

任务管理

  1. 定时巡检页管理周期任务,巡检异常自动上报并生成工单。
  2. 新建工单填写目标节点与任务描述:规则内直接执行,规则外转 AI 规划后调度执行器。
  3. 控制台 /console:模型设置 / 执行记录 / Agent 卡片。

控制台模型设置

控制台执行记录

常见问题

Q:没有 AI,系统还能工作吗? 能。执行器、工单、巡检、守卫、控制台全部是系统自带能力;AI 只负责规则解决不了的异常研判与自动处置。

Q:执行器能操作哪些节点? SSH 节点表:.71/.73/.74/.75(lz + sudo)与 .70(密钥,无 sudo)。未知 host 直接失败;本机执行无需 host。

Q:任务失败了怎么办? 规则内任务按预设重试;AI 任务重新规划(重复动作 2 次熔断纠正);持续失败的工单在详情页查看原因后人工介入,或 POST /tasks/<id>/stop 停止。

Q:与 LZ-SecOps 是什么关系? SecOps 负责告警研判与建单,本项目承接处置指令在机房实际执行并回写结果。

Q:为什么巡检不再自动运行? 2026-10-22 起 AI 巡检改为仅手动启动;需在 SecOps 页面手动触发或执行 --manual 脚本。

Q:中转站模型能用于运维执行吗? 不可。中转站 Zen-* 免费模型会编造命令执行结果;运维执行类任务需更强模型,中转站仅适合纯文本生成/问答。

Q:如何切换模型? 进入 /console → 模型设置,选择提供方、填写模型 ID,点击「测试连通性」验证后保存;单次任务也可用 "llm_provider": "relay:<模型ID>" 临时指定。

Q:公网地址 502 怎么办? 先确认内网 http://192.168.11.77:5010/ 是否正常;若内网正常,系网关映射链路问题,联系运维检查端口映射。

模块跳转

相关链接

  • 架构说明:官网项目卡「架构」→ 定位 / 架构 / 数据流 / 接口 + Mermaid 架构图
  • 更新日志:官网项目卡「日志」→ Git 快照与部署记录(服务端模板故障期间以说明书《更新日志》页为准)
  • 项目展示:官网项目卡「展示」→ LZ-Agent 功能特性站
  • 联动项目:LZ-SecOps 说明书(告警研判与工单来源的安全运营平台)

AI 接口维护

GET  /api/projects/lz-agent/wiki/tree          # 页面目录
GET  /api/projects/lz-agent/wiki/page?path=home&raw=1
POST /api/projects/lz-agent/wiki/page          # 创建/更新页面

本说明书由 Leon 独立整理维护 · 内容以现场实际为准

团队联系方式
📇

团队联系方式 · 预留位

管理员可在后台「说明书设置」配置联系方式图片
本说明书由 Leon 独立整理维护 · 内容以现场实际为准