（10507期）Container Debug – Docker 容器全方位调试手册

Docker 容器全方位调试手册 Docker容器与Compose服务的调试指南，提供日志分析、网络诊断、资源监控等完整命令集，纯文档性工具 使用说明 核心功能 container-debug 是一套全面的 Docker 容器调试指南，专注于帮助开发者诊断和解决容器化应用的各类问题。内容涵盖六大核心场景：日志查看与过滤（docker logs 多维度查询）、容器内执行调试（docker exec 交互式与单命令模式）、网络连通性诊断（DNS 解析、端口映射、自定义网络）、资源使用监控（内存 OOM 检测、磁盘分析）、Dockerfile 多阶段构建调试，以及 Docker Compose 服务依赖与启动顺序问题。 显著优点 场景覆盖完整：从容器崩溃（exit code 分析）到网络隔离（bridge vs 自定义网络），从资源泄漏到构建缓存问题，几乎涵盖所有常见故障模式 命令即拿即用：所有示例均为可直接执行的 CLI 命令，无需额外工具链，兼容 Linux/macOS/Windows 特殊场景支持：针对 distroless/scratch 等无 shell 镜像，提供 nsenter 和 sidecar 调试方案；针对 OOM 退出码 137 提供精准诊断流程 Compose 深度集成：包含 depends_on 健康检查条件、服务启动顺序控制等生产级编排技巧 潜在局限 纯文档性工具：本身无可执行代码，依赖用户手动执行命令，无法自动化诊断 Docker 版本差异：部分命令（如 docker debug）需要 Docker Desktop 特定版本，旧版 Docker 引擎不支持 平台限制：nsenter 方案仅适用于 Linux 主机，macOS/Windows 需借助虚拟机或特定工具 无实时聚合：无法跨多主机或 Kubernetes 环境工作，仅限单机 Docker 场景 适合人群 DevOps/SRE 工程师处理生产容器故障 后端开发者本地调试微服务架构 CI/CD 流水线维护人员排查构建失败 Docker 学习者系统掌握调试方法论 使用风险 命令执行风险：docker system prune --volumes 等清理命令可能导致数据永久丢失 权限要求：部分诊断（如 nsenter）需要主机 root 权限 生产环境慎用：docker cp 提取敏感文件、tcpdump 抓包可能涉及合规问题 网络测试副作用：容器内 ping/curl 可能触发防火墙告警或产生意外流量 原始说明 Debug running Docker containers and Compose services. Use when inspecting container logs, exec-ing into running containers, diagnosing networking issues, checking resource usage, debugging multi-stage builds, troubleshooting health checks, or fixing Compose service dependencies.