🤖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 图 |
界面导览
- 打开首页进入工单/任务面板:查看执行中 / 待执行 / 已完成任务。

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

- 定时巡检页管理周期任务,巡检异常自动上报并生成工单。
- 新建工单填写目标节点与任务描述:规则内直接执行,规则外转 AI 规划后调度执行器。
- 控制台
/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 独立整理维护 · 内容以现场实际为准