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