部署与运维 · 机房自动化执行中心展示说明书架构日志
第 04 章

🚀部署与运维

核心介绍

一、部署信息

项 值
设备 L-Ubt Agent · 192.168.11.77(Ubuntu 24.04,leonzion-vmwarevirtualplatform)
服务端口 5010
内网地址 http://192.168.11.77:5010/
公网地址 http://119.145.17.34:5010/(经网关映射;若 502 先查内网,再查映射链路)
角色 .73 部署服务器的备份节点
协同 LZ-SecOps(192.168.11.71:5011)

二、服务管理

  • 启动:app:create_app(),gunicorn 4 workers(gthread 线程类,timeout 900s,graceful-timeout 60s)
  • 进程管理:systemd 常驻服务,开机自启
  • 配置:config.py —— Flask 0.0.0.0:5010,DEBUG 关闭;中转站地址/Key/超时;DEFAULT_MAX_ITERATIONS=20、DEFAULT_MAX_CONCURRENT_AGENTS=10、ITERATION_DELAY=1.0s
  • 模型热切换:data/model_settings.json(mtime 缓存,改后对新建任务即时生效,无需重启)

页面路由(web.py)

路由 页面
/ 首页(工单面板与导航)
/agents Agent 管理
/skills Skill 管理
/tasks 任务管理(执行中/待执行/已完成)
/tasks/ID 任务详情(规划步骤、执行器命令与回传)
/console 控制台(模型设置 / 执行记录 / Agent 卡片)

重启命令

kill <pid>; setsid nohup ./start.sh >> /tmp/leon-webhost.log 2>&1 </dev/null &

改 app.py / 模板后必须重启 Flask(无 debug 自动重载)。

三、代码备份

备份标记 说明
.bak-20260921 模型变更前(config.py / llm.py / engine.py / database.py / agent_manager.py / api/routes.py / templates/tasks.html)
.bak-20261018-1529 控制台功能前(llm.py / web.py / api/routes.py / templates/base.html)
.bak-novolcano-20261018-1651 火山/豆包通道下线前
data/model_settings.json.bak-novolcano 模型设置下线前
agent.db.bak-20261022-lfyclean 尾行规则清洗前
opencode.db.bak-20261022-lfyclean 尾行规则清洗前
/root/crontab.bak-20261022-ai-patrol-manual 巡检 cron 停用前

四、数据库

库 表 说明
data/agent.db agents / tasks / task_logs / iterations Agent 与任务记录
data/agent.db tickets / ticket_logs 工单与流转记录
opencode.db part OpenCode 会话数据

五、SSH 连通性

  • .71/.73/.74/.75:lz 用户密码登录 + sudo;.70:leonzion 密钥 ~/.ssh/ai-admin-key 登录,无 sudo
  • SSH 建连超时 8s;未知 host 直接报 Unknown host 失败

六、部署核验清单

  1. 改 app.py / 模板 → 必须重启服务
  2. 展示站发布:source .deploy.env && venv/bin/python deploy_pages.py
  3. 公网核验:根页入口正常、/w/ /a/ /c/ 可达、wiki 首页二维码为域名地址、arch 含 Mermaid、展示页含站内互引条

七、当前状态

  • 服务 active(gunicorn 4 workers,本地 127.0.0.1:5010 返回 200)
  • 公网 http://119.145.17.34:5010/ 返回 502 → 网关映射链路问题,服务本身正常(2026-11-03 实测)

相关链接


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