
简介
什么是 VCompose ?
VCompose是一个开源的可视化Docker Compose构建器,可以通过拖拽操作、绘制连接在浏览器中直接生成可用于生产的docker-compose.yml文件。而手动编写docker-compose.yml意味着要处理缩进、记住镜像标签,还要对照depends_on条目。
主要特点
- 可视化拖拽 :通过拖拽服务、绘制连接线来构建
Docker Compose配置 - 实时预览 :实时生成
YAML输出,带语法高亮 - AI 生成 :支持
OpenAI、Anthropic、Gemini、GLM等大模型,用自然语言描述生成配置 - MCP 集成 :支持
MCP协议,可从Claude、Cursor等AI工具中调用 - YAML 导入 :支持粘贴现有
compose文件进行可视化编辑 - 智能推荐 :自动推荐配套服务(如
postgres搭配pgadmin) - 无需后端:所有操作在浏览器中完成,数据不会离开本地
应用场景
- 开发者快速部署 :开发人员可以快速搭建和可视化复杂的
Docker开发环境 - Docker 学习 :初学者可以通过可视化操作理解
docker-compose的配置结构 - 团队协作 :团队成员可以通过可视化界面共享和讨论
Docker配置

VCompose 是一个让 Docker Compose 配置变得简单直观的可视化工具
安装
在群晖上以 Docker 方式安装。
由于镜像托管在 ghcr.io,群晖 Docker 套件无法直接搜索,需要通过命令行拉取镜像。

docker cli 安装
如果你熟悉命令行,可能用 docker cli 更快捷
bash
docker run -d \
--name=vcompose \
--restart=unless-stopped \
-p 7482:80 \
ghcr.io/zbrave/vcompose:latest
docker-compose 安装
也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件
yaml
version: '3.8'
services:
vcompose:
image: ghcr.io/zbrave/vcompose:latest
container_name: vcompose
restart: unless-stopped
ports:
- "7482:80"
然后通过 SSH 登录到您的群晖,执行下面的命令:
bash
# 新建文件夹 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 包含了 6 个 services
- 从侧边栏拖拽服务到画布
- 配置镜像、端口、卷、环境变量
- 绘制连接线自动生成
depends_on - 复制或下载生成的
docker-compose.yml

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

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

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

注意事项
- 无需配置:这是一个纯前端应用,不需要环境变量和持久化存储
- 数据安全 :所有数据保存在浏览器
localStorage中,不会发送到任何服务器 - 版本更新:如需更新镜像,重新拉取最新版本即可
参考文档
VCompose: Visual Docker Compose Builder
地址:https://github.com/zbrave/vcompose
vcompose - Docker Image地址:https://ghcr.io/zbrave/vcompose
VCompose 在线版