Compose Tool 🐳

Docker Compose 配置转换工具
->点击打开 Github 项目地址

一键转换 Docker Run 命令和 Docker Compose 配置，实现"一容器一目录"的标准化管理。

---

🖼️ 界面预览

🔗 在线演示：Compose Tool | Docker 配置转换工具

---

🏗️ 核心哲学：图纸与材料同屋存放

问题

装了几个 Docker 项目后，各种映射卷零零散散躺在宿主机的各个目录里，极其混乱：

/root/data/          ← 有些项目装这里

/home/user/docker/   ← 有些装这里

/var/lib/myapp/      ← 有些装这里

/tmp/test/           ← 还有些随手放的

解决方案

本工具的目标是把所有 Docker 项目的"图纸"（ compose.yaml 配置文件）和"材料"（映射的数据目录）统一存放：

/opt/docker/                        ← 统一大目录

├── vaultwarden/                    ← 每个容器一个子目录

│   ├── compose.yaml                ← 图纸（配置文件）

│   └── vw-data/                    ← 材料（容器数据）

├── portainer/

│   ├── compose.yaml

│   └── portainer-data/

├── compose-tool/                   ← 本项目自身也遵循此规范

│   └── compose.yaml

└── nextcloud/

    ├── compose.yaml

    └── data/

好处

• 备份极简：备份整个 /opt/docker 目录即可备份所有项目的配置和数据


• 迁移无痛：打包 → 上传到新服务器 → 解压 → 一键启动，完整恢复


• 管理清晰：进入任意子目录执行 docker compose up -d 即可启动对应项目

本工具默认路径为 /opt/docker/{container_name}，可通过 VOLUME_PREFIX 环境变量自定义。

---

✨ 核心特性

特性	说明
🔐 100% 隐私安全	纯前端实现，所有数据仅在浏览器本地处理，绝不上传
🎯 自动路径规范化	自动清理 $(pwd)`、`${HOME}、$PWD 等所有 Shell 变量
🛡️ 系统路径白名单	45+ 系统级挂载（如 /var/run/docker.sock）自动识别保留
🔄 双模式支持	同时支持 Docker Run 命令和 Docker Compose YAML 配置转换
📦 一键部署命令	转换结果自动生成完整部署命令，复制粘贴即可执行
📱 响应式设计	完美适配桌面端和移动端

---

🚀 快速部署

方式一：Docker Run （不推荐）

docker run -d \

  --name compose-tool \

  --restart unless-stopped \

  -p 6688:80 \

  -e VOLUME_PREFIX=/opt/docker/{container_name} \

  ghcr.io/beacherz/compose-tool:latest

方式二：Docker Compose （推荐，符合本工具理念）

💡 自定义路径说明：
如果不想使用默认的 /opt/docker/ 路径，请在执行前将下面命令中所有的 /opt/docker/ 整体替换为你规划的路径（包括 mkdir 、cd 以及环境变量中的路径）。

mkdir -p /opt/docker/compose-tool && cd /opt/docker/compose-tool && \

cat > compose.yaml << 'EOF'

services:

  compose-tool:

    image: ghcr.io/beacherz/compose-tool:latest

    container_name: compose-tool

    restart: unless-stopped

    ports:

      - "6688:80"  # 左边可改为你想要的端口

    environment:

      - TZ=Asia/Shanghai  # 时区

      - VOLUME_PREFIX=/opt/docker/{container_name}  # 默认卷映射路径，{container_name} 会自动替换为容器名

EOF

docker compose up -d

访问：http://服务器 IP:6688

关于 HTTPS：本工具为纯前端静态页面，所有数据在浏览器本地处理，HTTP 访问完全安全。

如需 HTTPS ，可在前面套一层反向代理（如 Nginx Proxy Manager / Caddy / Traefik ），

将域名指向 服务器 IP:6688 即可。

常用管理命令

cd /opt/docker/compose-tool      # 进入项目目录

docker compose logs -f            # 查看运行日志

docker compose pull               # 拉取最新镜像

docker compose up -d              # 重新部署（更新后执行）

docker compose down               # 停止并删除容器

💡 本工具是纯静态网页，无数据持久化需求，无需挂载卷。

---

🎯 使用流程

1. 粘贴命令 - 从官方文档或 GitHub 复制 Docker Run 命令或 Compose 配置


2. 点击转换 - 工具自动清理 Shell 变量、转换路径、添加标准配置


3. 
   一键部署 - 转换结果分为两部分，各有独立复制按钮：
   
   
   • 🚀 一键部署命令：包含目录创建、文件生成、容器启动的完整命令
   
   
   • 📄 compose.yaml 内容：纯 YAML 配置，适合手动编辑
   
   
   
   

---

📖 转换示例

示例 1：Docker Run → Compose

输入

docker run -d --name vaultwarden \

  -p 8000:80 \

  -v $(pwd)/vw-data:/data \

  -e DOMAIN=https://vw.example.com \

  vaultwarden/server:latest

输出（一键部署命令）

mkdir -p /opt/docker/vaultwarden && cd /opt/docker/vaultwarden && \

cat > compose.yaml << 'EOF'

services:

  vaultwarden:

    image: vaultwarden/server:latest

    container_name: vaultwarden

    ports:

      - "8000:80"

    volumes:

      - "/opt/docker/vaultwarden/vw-data:/data"

    environment:

      - "DOMAIN=https://vw.example.com"

    restart: unless-stopped

EOF

docker compose up -d

---

示例 2：官方 Compose → 标准化路径

输入

services:

  vaultwarden:

    image: vaultwarden/server:latest

    volumes:

      - ./vw-data:/data

    ports:

      - 8000:80

输出

mkdir -p /opt/docker/vaultwarden && cd /opt/docker/vaultwarden && \

cat > compose.yaml << 'EOF'

services:

  vaultwarden:

    image: vaultwarden/server:latest

    volumes:

      - "/opt/docker/vaultwarden/vw-data:/data"

    ports:

      - "8000:80"

    restart: unless-stopped

EOF

docker compose up -d

---

示例 3：系统路径自动保留

输入

docker run -d \

  -v /var/run/docker.sock:/var/run/docker.sock \

  -v ~/portainer-data:/data \

  --name portainer \

  portainer/portainer-ce

输出

mkdir -p /opt/docker/portainer && cd /opt/docker/portainer && \

cat > compose.yaml << 'EOF'

services:

  portainer:

    image: portainer/portainer-ce

    container_name: portainer

    volumes:

      - "/var/run/docker.sock:/var/run/docker.sock"

      - "/opt/docker/portainer/portainer-data:/data"

    restart: unless-stopped

EOF

docker compose up -d

/var/run/docker.sock 识别为系统路径，自动保留不转换。

---

💾 备份与迁移

备份单个项目

# 备份 vaultwarden 项目（配置 + 数据）

tar -czf /root/vaultwarden-backup.tar.gz /opt/docker/vaultwarden

压缩包位置：/root/vaultwarden-backup.tar.gz

---

备份所有项目

# 一次性备份所有 Docker 项目

tar -czf /root/docker-all-backup.tar.gz /opt/docker

压缩包位置：/root/docker-all-backup.tar.gz

---

下载备份到本地电脑

使用 FileZilla 或 WinSCP 等 FTP 工具：

1. 连接到服务器（填写 IP 、用户名 root、密码）


2. 进入 /root/ 目录


3. 下载 .tar.gz 压缩包到本地电脑

---

恢复单个项目

# 在新服务器上传压缩包到`/root/` 目录后执行

tar -xzf /root/vaultwarden-backup.tar.gz -C /



# 进入目录启动容器

cd /opt/docker/vaultwarden

docker compose up -d

---

迁移所有项目到新服务器

第 1 步：新服务器安装 Docker

curl -fsSL https://get.docker.com | sh

第 2 步：上传压缩包到新服务器

使用 FTP 工具将本地的 docker-all-backup.tar.gz 上传到新服务器的 /root/ 目录。

第 3 步：解压并还原目录结构

# 在新服务器执行

tar -xzf /root/docker-all-backup.tar.gz -C /

解压后目录结构自动恢复：

/opt/docker/

├── vaultwarden/

│   ├── compose.yaml

│   └── vw-data/

├── portainer/

│   ├── compose.yaml

│   └── portainer-data/

├── compose-tool/

│   └── compose.yaml

└── ...

第 4 步：一键启动所有容器

for dir in /opt/docker/*/; do

  echo "正在启动: $dir"

  (cd "$dir" && docker compose up -d)

done

---

🔧 高级配置

修改默认卷映射路径

编辑服务器上的 compose.yaml，修改 VOLUME_PREFIX 环境变量：

- VOLUME_PREFIX=/你的新路径/{container_name}

重启容器：

cd /opt/docker/compose-tool

docker compose up -d --force-recreate

自定义端口

编辑 compose.yaml：

ports:

  - "你的端口:80"

更新到最新版本

cd /opt/docker/compose-tool

docker compose pull

docker compose up -d

---

🛡️ 系统路径白名单

以下路径自动识别保留，不做转换：

分类	路径示例
Docker	/var/run/docker.sock、/var/lib/docker、/usr/bin/docker
内核/设备	/proc、/sys、/dev、/boot、/lib/modules
系统配置	/etc/localtime、/etc/hosts、/etc/resolv.conf、/etc/timezone
SSL 证书	/etc/ssl、/etc/pki、/etc/ca-certificates
用户/组	/etc/passwd、/etc/group、/etc/shadow、/etc/gshadow

完整白名单包含 45+ 路径，覆盖所有常见系统级挂载。

---

📜 开源协议

本项目采用 MIT License 协议开源。