yinjianm
9af9dd0df7
新增父节点墙状态检测任务、结果上报与节点列表状态装饰， 支持子节点继承父节点检测结果并通过 WS/REST 双链路执行 管理端补充墙状态筛选、搜索、单行与批量检测入口， 同时更新知识库归档并新增后续自动上线方案包
2.2 KiB
2.2 KiB
node-gfw-check
职责
- 在 Xboard 后端维护节点墙状态检测任务和检测结果
- 通过管理端接口触发父节点墙状态检测，并通过节点端接口提供 REST 兜底领取与结果上报
- 通过
NodeSyncService发送gfw.checkWS 事件，让在线 mi-node 可即时执行检测 - 在节点列表返回
gfw_check字段，并对子节点应用父节点检测结果继承规则
行为规范
- 检测任务只对父节点创建；带
parent_id的子节点不单独下发任务 - 子节点列表展示继承父节点最新
gfw_check，并返回inherited=true与source_node_id server_gfw_checks.status使用pending / checking / normal / blocked / partial / failed / skipped- 管理端
POST server/manage/checkGfw接收{ ids: number[] }，响应中区分started与skipped - 节点端
GET server/gfw/task只向父节点返回待执行任务；节点端POST server/gfw/report必须校验check_id归属当前节点 - 当前检测方向只做节点服务器主动 ping 国内三网目标；后续墙内探测 IP 可在同一任务模型中扩展
- 参考脚本中的 Telegram 通知、chat_id、bot token 和自动安装依赖逻辑不得进入项目实现
- mi-node 使用 Go 原生 runner 调用系统
ping，按三网目标并发检测并结构化上报summary / operator_summary / raw_result - Docker runtime 镜像需要提供
ping，当前通过 Alpineiputils满足
依赖关系
- 依赖
app/Services/ServerGfwCheckService.php统一处理任务创建、状态判定、结果装饰和子节点继承 - 依赖
app/Models/ServerGfwCheck.php与server_gfw_checks表保存检测记录 - 依赖
app/Http/Controllers/V2/Admin/Server/ManageController.php暴露管理端触发接口 - 依赖
app/Http/Controllers/V2/Server/ServerController.php暴露节点端任务领取和上报接口 - 依赖
app/Services/NodeSyncService.php与 Workerman WS 通道向在线节点推送gfw.check - 依赖
E:/code/go/mi-node/internal/gfwcheck执行 ping 检测和结果判定 - 依赖
E:/code/go/mi-node/internal/panel、internal/controlplane与internal/service接收任务、轮询兜底并上报结果