Your Name
cdd0be328a
Critical runtime bugs:
- terminal.html WebSSH完全不可用（URL前缀/JSON解析/Content-Type三处错误）
- servers.py路由遮蔽：/logs被/{id}拦截，3个前端页面同步日志查询失败
- scripts.html startExecPoll()→startExecPolling()，长任务快速执行崩溃
- agent.py {value!r!s:.50}格式串非法，agent发非数值时ValueError
- alerts.html d.daily.reduce()无null检查，API返回空数据时TypeError
Resource leak / stability:
- websocket.py僵尸连接未关闭TCP，文件描述符泄漏
- websocket.py _last_alert_time字典无限增长（加1小时过期清理）
- asyncssh_pool.py全忙时超过MAX_CONNECTIONS无限增长
- self_monitor.py Telegram告警无冷却，宕机时每30秒刷屏
- schedule_runner.py一次性调度执行超60秒会重复触发
- 限速脚本EXPIRE每次重置窗口可绕过（改用Lua原子脚本）
Security:
- JWT access token加token_version声明，改密码后旧token立失效（零宽限）
- INSTALL_MODE导入时常量→动态函数，安装后JWT认证不再残留禁用
- install.py /lock端点加管理员存在性验证，防止阻断安装
- ServerUpdate schema移除connectivity只读字段，防止伪造连接状态
Frontend fixes:
- doExec()缺r.ok检查、commands.html null检查
- _server_to_dict()补last_checked_at+ssh_key_public
- _field_match()逗号cron表达式修复
- alerts类型显示、SSH会话名称、搜索高亮定位
- 一次性/循环定时任务（run_mode+fire_at+自动禁用）
Dead code removed (400+ lines):
- SyncService batch_push/_push_single等5个方法（零调用者）
- 5个未使用schema（SyncCommands/SyncConfig/SyncSftp/FileDeploy/PaginatedResponse）
- 6个零调用service方法、3个无前端API端点
- 4个未使用import
Schema migrations:
- push_schedules: run_mode + fire_at列，cron_expr改NULL
- servers: 7个新列 + ssh_key_private/public VARCHAR(500)→TEXT
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
1.7 KiB
1.7 KiB
2026-05-23 — 脚本/健康检查改 SSH，弱化 8601
摘要
远程脚本执行与手动健康检查改为经 SSH（22）；Agent 仅负责 HTTPS 出站心跳（443）。子机 Agent HTTP 默认只监听 127.0.0.1:8601，不要求公网放行 8601。
动机
大量宝塔子机未开放 8601；推送与文件已走 SSH。统一命令通道为 SSH，监控仍靠 Agent 心跳，减少防火墙与双通道维护成本。
涉及文件
server/application/services/script_service.py—_call_ssh_exec，移除 Agent HTTP 执行路径server/application/services/server_service.py—check_all_servers改 SSH 探测server/infrastructure/ssh/remote_probe.py— 新增 SSH 健康/指标探测server/api/servers.py— 健康检查 API 文档说明web/agent/install.sh— Python 3.12 venv、127.0.0.1 绑定、不再自动放行公网 8601web/app/servers.html— 安装说明文案server/config.py— 注释
端口模型（变更后）
| 方向 | 端口 | 用途 |
|---|---|---|
| 子机 → 中心 | 443 出站 | Agent 心跳、长任务 curl 回调 |
| 中心 → 子机 | 22 入站 | 推送、文件、脚本、手动健康检查 |
| 127.0.0.1:8601 | 仅本机 | Agent 进程（可选，不暴露公网） |
迁移 / 重启
- 需重启 Nexus 后端以加载 Python 变更
- 已装 Agent：建议重装或手动改 systemd 为
127.0.0.1+ venv；不必再开公网 8601 - 确保各服务器 SSH 凭据可用（与推送相同）
验证
- 子机 Agent 运行：
journalctl -u nexus-agent -f，心跳 200 - 未开公网 8601 时：脚本页执行命令应成功（
channel: ssh） POST /api/servers/check返回channel: ssh且status: online（SSH 可达时）