可视化Docker Compose构建器VCompose

简介

什么是 VCompose ?

VCompose 是一个开源的可视化 Docker Compose 构建器,可以通过拖拽操作、绘制连接在浏览器中直接生成可用于生产的 docker-compose.yml 文件。而手动编写docker-compose.yml 意味着要处理缩进、记住镜像标签,还要对照 depends_on 条目。

主要特点

  • 可视化拖拽:通过拖拽服务、绘制连接线来构建 Docker Compose 配置
  • 实时预览:实时生成 YAML 输出,带语法高亮
  • AI 生成:支持 OpenAIAnthropicGeminiGLM 等大模型,用自然语言描述生成配置
  • MCP 集成:支持 MCP 协议,可从 ClaudeCursorAI 工具中调用
  • YAML 导入:支持粘贴现有 compose 文件进行可视化编辑
  • 智能推荐:自动推荐配套服务(如 postgres 搭配 pgadmin
  • 无需后端:所有操作在浏览器中完成,数据不会离开本地

应用场景

  • 开发者快速部署:开发人员可以快速搭建和可视化复杂的 Docker 开发环境
  • Docker 学习:初学者可以通过可视化操作理解 docker-compose 的配置结构
  • 团队协作:团队成员可以通过可视化界面共享和讨论 Docker 配置

VCompose 是一个让 Docker Compose 配置变得简单直观的可视化工具

安装

在群晖上以 Docker 方式安装。

由于镜像托管在 ghcr.io,群晖 Docker 套件无法直接搜索,需要通过命令行拉取镜像。

docker cli 安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
docker run -d \
--name=vcompose \
--restart=unless-stopped \
-p 7482:80 \
ghcr.io/zbrave/vcompose:latest

docker-compose 安装

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
version: '3.8'

services:
vcompose:
image: ghcr.io/zbrave/vcompose:latest
container_name: vcompose
restart: unless-stopped
ports:
- "7482:80"

然后通过 SSH 登录到您的群晖,执行下面的命令:

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 vcompose 和 子目录
mkdir -p /volume1/docker/vcompose

# 进入 vcompose 目录
cd /volume1/docker/vcompose

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:7482 即可进入 VCompose Web 界面。

点下方的 Open VCompose 按钮,进入主界面

Stacks 中是编排好的,像 Smart Home 包含了 6services

  1. 从侧边栏拖拽服务到画布
  2. 配置镜像、端口、卷、环境变量
  3. 绘制连接线自动生成 depends_on
  4. 复制或下载生成的 docker-compose.yml

Marketplace 中则是单个的镜像,也可以添加自定义镜像

设置 AI 之后,可以进行优化

VCompose 还可以作为 MCP 使用,但是看文档 http://<群晖IP>:7482/mcp 似乎应该只支持 stdio 传输

注意事项

  1. 无需配置:这是一个纯前端应用,不需要环境变量和持久化存储
  2. 数据安全:所有数据保存在浏览器 localStorage 中,不会发送到任何服务器
  3. 版本更新:如需更新镜像,重新拉取最新版本即可

参考文档

VCompose: Visual Docker Compose Builder
地址:https://github.com/zbrave/vcompose

vcompose - Docker Image
地址:https://ghcr.io/zbrave/vcompose

VCompose 在线版
地址:https://vcompose.cc