第 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失败
六、部署核验清单
- 改 app.py / 模板 → 必须重启服务
- 展示站发布:
source .deploy.env && venv/bin/python deploy_pages.py - 公网核验:根页入口正常、
/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 独立整理维护 · 内容以现场实际为准