Nexus/docs/changelog/2026-06-09-agent-remote-diagnose-script.md

2026-06-09 — 子机 Agent 批量诊断脚本

摘要

新增 scripts/agent_remote_diagnose.py：从中心侧按服务器 ID/名称/离线筛选，SSH 拉取子机 systemctl、脱敏 config.json、401/心跳错误日志、主站 /health 探测；并对照 Redis/MySQL 心跳。

动机

排查「显示离线但 SSH 可连」类问题时，需登录每台子机看 nexus-agent 日志；武汉颜又文案需可重复工具。

涉及文件

• scripts/agent_remote_diagnose.py
• scripts/agent_remote_diagnose.sh
• tests/test_agent_remote_diagnose.py

用法

bash scripts/agent_remote_diagnose.sh --id 95
bash scripts/agent_remote_diagnose.sh --name 颜又文
bash scripts/agent_remote_diagnose.sh --offline-only --limit 20 -o docs/reports/agent-offline-snapshot.md

需在含 .env 的目录执行（本地或生产 /opt/nexus）。

验证

pytest tests/test_agent_remote_diagnose.py -q