多容器排错助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_b4da0893/multi-container-troubleshoot-cn。
技能介绍
要解决什么问题
本地或测试环境里,docker compose up 之后服务起不来、页面打不开、依赖连不上,很多人会在最后一行报错和「全量重启 / 删容器删卷」之间打转。真正需要的是:插值后的配置是否和预期一致、容器归属哪个 project、第一次退出码是什么、健康检查是否只测了进程、服务间该走 容器端口 还是宿主机映射、卷里是不是预期数据。
技能如何工作
多容器排错助手把故障拆成可验证层级,按固定工作流推进:固定调查对象(目录、项目名、编排文件合并顺序)→ 生成脱敏后的实际配置视图 → 建资源账本(服务、网络、卷及孤儿资源)→ 还原生命周期并优先看首次失败 → 分开验证进程入口、依赖就绪、网络路径与卷身份 → 单次只验证一个根因假设 → 设计最小恢复动作与停止线。
产出按规范组织:调查范围、资源账本、生命周期、互联与卷证据、根因候选与反证、恢复与回滚路径、分层验收。服务状态用语如 DECLARED、STARTED、HEALTHY、EXITED 等,命令建议标注只读 / 可逆 / 破坏性级别。
适用边界与注意点
适合本地开发、测试及经授权的单机排障;不自动删卷、批量清资源,不在未确认持久化位置时重建有状态服务,不把 depends_on 当成业务已就绪,不在内部互联里机械使用宿主发布端口。凭据只保留变量名并脱敏。
使用场景
- Compose 项目 Up 但 Web 打不开,需要区分进程存活、监听地址与发布端口映射
- depends_on 已配仍连不上数据库,要验证就绪条件与客户端有界重试而非启动顺序
- 修改 `.env` 后重启无变化,要核对插值来源与容器是否需 recreate 才吃到新环境
- 重建后数据丢失嫌疑,要先停写入并核对 project、卷 ID 与挂载点再处置
适合人员
- 本地用 Compose 起多服务的后端,希望先拿只读分层证据再动手的工程师
- 测试环境负责多套并行 Compose project、要隔离网络与卷归属的运维
- 改过镜像或编排 YAML 后整栈异常,需要对比渲染配置与首次退出码的发布负责人
- 单机授权部署上遇互联或卷问题、不能随意删卷的生产排障人员