高级预览本地预览无需 AI可导出开发文档

Docker Compose 架构图

把 Docker Compose YAML 转成可读架构图，帮助团队理解本地栈服务依赖、端口暴露、网络和持久化数据。

示例

Docker Compose YAML

Compose 图就绪

粘贴 docker-compose.yml，可视化服务、depends_on、网络和卷。

下一步可以继续

把当前预览结果带到相关工具里继续转换、排查或导出。

AI 图表生成器

用自然语言生成可编辑 Mermaid 图表，并在导出前完成预览和 review。

打开

Mermaid AI 修复器

用 AI 修复 Mermaid 语法错误，并在发布前检查图表语义和可读性。

打开

架构图生成器

用 AI 从产品或系统说明生成 Mermaid 架构图。

打开

使用方法

1粘贴包含 services、networks、volumes 和 depends_on 的 docker-compose.yml。
2把服务依赖和 readiness/healthcheck 保证分开 review。
3检查哪些服务暴露端口、挂载卷或共享网络。
4公开分享前移除 secret、私有 registry 和环境变量。
5导出图用于 onboarding、README 或本地开发说明。

常见场景

本地栈文档Compose 服务依赖 review开发者 onboardingREADME 架构图AI 生成 Compose 校验

常见问题

这个工具会用 AI 吗？

不会。它在浏览器本地解析并可视化输入内容。

depends_on 是否代表服务已经 ready？

不代表。depends_on 只说明启动顺序，不说明应用 readiness。需要 healthcheck 和应用重试保证。

分享 Compose 图前应移除什么？

移除 secret、私有 registry 名称、内部 host、以及不应出现在公开文档里的环境变量。

把 Docker Compose 服务和依赖关系转换为清晰的架构图。

粘贴 docker-compose.yml，可视化服务、depends_on、网络和卷。

这适合开发者把 AI 生成或手写的文本粘贴进来，在发布文档前快速做可视化检查。

Demo：可视化 Compose Web 栈

Docker Compose 描述本地架构。图可以帮助 onboarding 和调试服务依赖、端口、网络和 volume。

depends_on 和实际 readiness 分开展示。
标出公网端口和仅内部使用的服务。
文件变大后按 app、data、observability 分组。

services:
  web:
    build: .
    depends_on: [api]
    ports: ["3000:3000"]
  api:
    image: acme/api
    depends_on: [db]
  db:
    image: postgres:16

Review 清单：Compose 图不是 readiness 证明

图能说明拓扑，但 depends_on 不总是代表依赖已能接收流量。视觉 review 应和 healthcheck、环境变量检查一起做。

数据库和队列应配置 healthcheck。
检查端口是否意外暴露。
数据需要持久化时 review named volume。

healthcheck:
  test: ["CMD", "pg_isready", "-U", "postgres"]
  interval: 10s
  retries: 5

安全提示：发布前清理 Compose

Compose 文件常包含环境变量、本地路径、私有 registry 和内部服务名。图更容易分享，但源码仍要先 review。

删除 environment 中的 secret 和 token。
对外发布时替换私有 registry 或内部 host。
volume 路径不要暴露本机目录结构。

environment:
  DATABASE_URL: postgres://user:***@db:5432/app
volumes:
  - ./data:/var/lib/postgresql/data