Docker Compose 本身不支持直接导出拓扑图,但可通过 docker-compose-graph(生成 DOT 图)或 Python + diagrams(定制化建模)解析 docker-compose.yml 实现可视化;也可结合 docker network inspect、docker exec 等命令检查实际运行时结构。
在 Linux 中,Docker Compose 本身不提供直接导出拓扑图的功能,但可以通过解析 docker-compose.yml 文件结构 + 调用辅助工具(如 docker-compose-graph 或 diagrams 类库),生成可视化拓扑图,反映服务依赖、网络连接和容器关系。关键在于:先提取服务定义与依赖关系,再转换为图描述语言(如 DOT)或直接渲染。
用 docker-compose-graph 快速生成 DOT 图
这是一个轻量命令行工具,专为 Compose 文件生成依赖图:
- 安装(需 Node.js):
npm install -g docker-compose-graph - 进入项目目录,执行:
docker-compose-graph -f docker-compose.yml | dot -Tpng -o topology.png - 会输出 PNG 图片,展示服务节点、
depends_on箭头、默认网络连接(如default网络内的互通) - 支持 SVG/PDF 输出,加
-Tsvg即可;加--no-ports可隐藏端口标注
用 Python + diagrams 手动建模(适合定制化分析)
当需要体现更细粒度结构(如数据库类型、中间件角色、挂载卷路径),可用 Python 脚本解析 YAML 并绘图:
Content at Scale
SEO长内容自动化创作平台
下载
- 安装:
pip install diagrams pyyaml - 写一个
gen_topology.py,用yaml.safe_load()读取docker-compose.yml - 遍历
services,按image关键字自动匹配图标(如mysql→ 数据库节点,redis→ 缓存节点) - 用
depends_on或links构建边;用networks分组显示网络隔离域 - 示例片段:
with Diagram("Single-host Topology", show=False, direction="LR"):web = Service("web")db = Database("postgres")web >> db
检查实际运行时结构(非声明式,而是真实状态)
声明文件 ≠ 运行拓扑。要确认真实连接关系,需结合运行时命令:
- 查容器网络:
docker network inspect $(basename $(pwd))_default(默认网络名常为${PROJECT}_default) - 看容器间连通性:
docker exec -it web curl -s http://db:5432(验证 DNS 解析与端口可达) - 导出容器关系快照:
docker ps --format "{{.Names}}\t{{.Networks}}\t{{.Status}}" > runtime-topology.tsv,便于后续分析
注意事项与常见问题
导出的图只是静态快照,不能替代运行时诊断:
-
depends_on仅控制启动顺序,不保证服务就绪;图中箭头不代表健康通信 - 自定义网络(
networks:块)可能创建多个隔离网段,需在图中用不同颜色/分组标识 - 若使用
build:而非image:,图中无法体现基础镜像来源,需额外注释 - 敏感信息(如环境变量、卷路径)默认不显示在图中,如需分析,需在脚本中显式提取并标注