Docker Compose Debugger / Docker Compose 调试助手

SKILL.md

---
name: docker-compose-debugger
description: "Check service dependencies, port conflicts, volume mounts, and network connectivity with one command. / 一键检查服务依赖、端口冲突、卷挂载和网络连通性。"
version: 1.0.0
topics: [docker,compose,debugging,networking,docker调试,服务依赖]
metadata:
  openclaw:
    requires:
      bins:
        - bash
        - curl
    emoji: "🐳"
    homepage: https://kingai.work/
    install: []
---

# 🐳 Docker Compose Debugger / Docker Compose 调试助手

> Check service dependencies, port conflicts, volume mounts, and network connectivity with one command. / 一键检查服务依赖、端口冲突、卷挂载和网络连通性。

> 🦁 **由 KingAI.Work 出品** — 智能进化｜vip@kingai.work

---

## Features / 功能特性

• Runs a comprehensive health check on all docker-compose services to identify misconfigurations before deployment / 在部署前全面扫描所有服务配置，秒速定位依赖冲突与端口占用，杜绝上线后崩溃。
• Detects port conflicts and suggests dynamic port remapping with one command / 智能检测端口冲突并一键动态重映射，避免“端口已被占用”的烦人错误。
• Validates volume mount paths and file permissions across containers / 跨容器验证卷挂载路径与文件权限，确保数据持久化无暗坑。
• Maps container network topology to reveal hidden connectivity gaps / 可视化容器网络拓扑，精准揭露隐藏的连通性断点，让网络调优一目了然。
• Pro-only: Snapshot and compare service states across different docker-compose stacks / 专业版专享：跨不同堆栈快照比对服务状态，批量调试效率翻倍。
• Pro-only: Generates optimized docker-compose override files to fix detected issues automatically / 专业版专享：自动生成优化后的覆盖文件，一键修复所有检测到的问题。

## Quick Start / 快速开始

```bash
docker run --rm docker-compose-debugger --project . --check-all Performs a comprehensive scan of current directory’s docker-compose project for dependencies, ports, volumes, and network issues. / 对当前目录的 docker-compose 项目执行全面扫描，检查依赖、端口、卷和网络问题。 
```

## Use Cases / 使用场景

• Microservices developer: After adding a new service in docker-compose, you hit 502 errors. The debugger finds the missing link to the database container and suggests a fix. / 微服务开发者：新增服务后遇到502错误，调试助手秒查出未连接到数据库容器并提示修复。
• DevOps engineer preparing a production stack: You need to ensure no port conflicts with legacy systems. The debugger maps all used ports and alerts on overlaps. / DevOps 工程师准备生产环境堆栈：需确保无端口与旧系统冲突，调试助手映射所有占用端口并预警重叠。
• Team onboarding new hire: A junior dev copies a compose file but mounts wrong volumes. The debugger validates paths and permissions immediately. / 团队新成员入职：初级开发者复制了错误的卷挂载，调试助手即时验证路径和权限，避免数据混乱。

## Plans / 方案对比

| Feature | Free | Pro |
|---------|:----:|:---:|
| Core / 核心功能 | ✅ | ✅ |
| Batch / 批量处理 | — | ✅ |
| AI / AI 增强 | — | ✅ |
| Support / 支持 | Community | Priority |

• Generate automatic override files to fix config errors in bulk, saving hours of manual tweaking.
  自动生成配置文件修复大量配置错误，节省数小时手动调整时间。
• Compare service states across stacks to quickly identify regressions after updates.
  跨堆栈比对服务状态，更新后快速定位回归问题。
• Unlock priority support and early access to new debugging features.
  解锁优先支持和新调试功能的抢先体验权。\n\n
---
### About the Publisher

Published by King AI — [kingai.work](https://kingai.work/) | vip@kingai.work