用途:该技能用于快速分诊用户报告的 Ludus 故障,对错误进行分类并提供有针对性的修复步骤。
诊断流程:先收集上下文和确切错误输出;检查靶场部署状态与近期错误;查看部署日志中的失败细节;借助已知错误目录判断失败类别;检查当前靶场配置是否存在错误配置;给出带具体步骤的针对性修复;并定义明确的验证步骤以确认恢复。
关键诊断信息(按有用程度排序):靶场状态(部署是运行中、失败还是完成);部署错误(最近一次部署的错误输出);部署日志(用于追踪失败上下文的完整日志流);模板状态(所需模板是否已构建并可用);靶场配置(YAML 是否符合用户意图);测试模式状态(测试模式是否启用、网络规则是否生效)。
常见模式:网络问题常可追溯到 dnsmasq 或 NAT 网桥状态;Ansible 失败常涉及 WinRM(Windows)或 SSH 可达性(Linux);域加入失败通常与 DNS 顺序或时序有关;模板失败通常与 ISO 下载或磁盘空间有关。
参考:已知错误、根因与修复流程见 references/common-errors.md;客户端与 CLI 排查见 https://docs.ludus.cloud/docs/troubleshooting/client;网络与连接问题见 https://docs.ludus.cloud/docs/troubleshooting/network/ 和 https://docs.ludus.cloud/docs/troubleshooting/wireguard/。卸载 Ludus 时应引导用户前往官方指南 https://docs.ludus.cloud/docs/troubleshooting/uninstall,而不要自行执行卸载步骤。