Back to Details

troubleshooting

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Ludus Troubleshooting

Ludus 故障排查

Use this skill to triage user-reported failures quickly, categorize errors, and provide targeted remediation steps.
使用此技能快速分类用户报告的故障，归类错误类型，并提供针对性的修复步骤。

Diagnostic Workflow

诊断流程

  1. Gather context and exact error output.
  2. Check range deployment status and recent errors.
  3. Review deployment logs for failure details.
  4. Identify the failure category using the known error catalog.
  5. Inspect the current range config for misconfigurations.
  6. Provide targeted fixes with concrete steps.
  7. Define clear verification steps to confirm recovery.
  1. 收集上下文信息和准确的错误输出。
  2. 检查部署范围的状态及近期错误。
  3. 查看部署日志以获取故障详情。
  4. 使用已知错误目录确定故障类别。
  5. 检查当前部署范围配置是否存在错误配置。
  6. 提供包含具体步骤的针对性修复方案。
  7. 定义清晰的验证步骤以确认恢复情况。

Key Diagnostic Information

关键诊断信息

When triaging, gather these in order of usefulness:
  • Range status — is the deployment running, failed, or complete?
  • Deployment errors — the most recent error output from a deploy.
  • Deployment logs — full log stream for tracing failure context.
  • Template status — are required templates built and available?
  • Range config — does the YAML match what the user intended?
  • Testing mode status — is testing mode active, and are network rules in effect?
进行分类排查时，请按以下有用性顺序收集信息：
  • 部署范围状态 — 部署是运行中、失败还是已完成？
  • 部署错误 — 部署产生的最新错误输出。
  • 部署日志 — 完整的日志流，用于追踪故障上下文。
  • 模板状态 — 所需模板是否已构建并可用？
  • 部署范围配置 — YAML配置是否与用户预期一致？
  • 测试模式状态 — 测试模式是否激活，网络规则是否生效？

Common Patterns

常见模式

  • Network issues often trace back to dnsmasq or NAT bridge state.
  • Ansible failures often involve WinRM (Windows) or SSH reachability (Linux).
  • Domain join failures usually involve DNS ordering or timing.
  • Template failures are commonly ISO download or disk-space related.
  • 网络问题通常可追溯到dnsmasq或NAT网桥状态。
  • Ansible故障通常涉及WinRM（Windows）或SSH（Linux）的可达性问题。
  • 域加入失败通常与DNS排序或时序有关。
  • 模板故障常见原因是ISO下载失败或磁盘空间不足。

References

参考资料

  • Use 
    references/common-errors.md
    for known errors, root causes, and fix procedures.
  • Use 
    https://docs.ludus.cloud/docs/troubleshooting/client
    for client and CLI troubleshooting details.
  • Use 
    https://docs.ludus.cloud/docs/troubleshooting/network/
    and 
    https://docs.ludus.cloud/docs/troubleshooting/wireguard/
    for network and connectivity issues.
  • For uninstalling Ludus, direct users to the official guide at 
    https://docs.ludus.cloud/docs/troubleshooting/uninstall
    rather than performing the steps yourself.
  • 请使用
    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
    ，而非自行执行步骤。