Compose craft Docker 镜像文档

镜像概述和主要用途

Compose craft 是一款专注于 Docker Compose 文件管理的图形界面工具，旨在简化 Docker Compose 文件的创建、编辑和共享流程。用户可通过直观的 GUI 界面操作，无需手动编写 YAML 代码，同时支持配置的快速分享与协作，适用于需要可视化管理 Docker 服务编排的场景。

核心功能和特性

• GUI 创建 Docker Compose：通过图形界面直观创建 Docker Compose 配置，无需手动编写 YAML 代码
• 一键分享功能：生成公共链接，快速分享 Docker Compose 图表配置
• 自定义文件导入：支持导入用户本地已有的 Docker 文件
• 代码导出：可将图形界面配置导出为 Docker Compose 代码

使用场景和适用范围

• 需要可视化管理 Docker Compose 文件的开发者
• 团队内部需要共享 Docker 服务编排配置的场景
• 希望简化 Docker Compose 文件编辑流程的用户
• 需快速生成和调整 Docker 服务架构的测试环境

使用方法和配置说明

快速开始

在线使用

直接访问***在线工具：composecraft.com

自托管部署

若需在自有基础设施上部署，可通过以下 docker-compose.yml 配置实现：

yaml
name: compose craft
services:
  saas:
    image: composecraft/composecraft:latest
    ports:
      - 3000:3000  # 映射容器 3000 端口到主机 3000 端口
    environment:
      - CORE_ONLY=true  # 仅启用核心功能
      - URL=http://localhost:3000  # 应用访问 URL
      - SECRET_KEY=changeme  # JWT 签名密钥，需修改为自定义安全值
      - MONGODB_URI=mongodb://dev:dev@db  # MongoDB 连接地址
    depends_on:
      - db  # 依赖 db 服务
    networks:
      - internal  # 加入 internal 网络
  db:
    image: mongo:latest  # 使用最新版 MongoDB
    environment:
      - MONGO_INITDB_ROOT_USERNAME=dev  # MongoDB 初始用户名
      - MONGO_INITDB_ROOT_PASSWORD=dev  # MongoDB 初始密码
    ports:
      - 27017:27017  # 映射 MongoDB 默认端口
    networks:
      - internal  # 加入 internal 网络
    volumes:
      - mongo_data:/data/db  # 持久化 MongoDB 数据
networks:
  internal:
    driver: bridge  # 使用 bridge 网络驱动
    attachable: false
    external: false
volumes:
  mongo_data:
    driver: local  # 使用本地存储驱动
    external: false

注意：库和 GitHub 登录功能无法使用。

环境变量配置

自托管部署时支持以下环境变量配置：

• SECRET_KEY：用于签名 JWT 令牌的密钥，必须设置为安全值
• MONGODB_URI：MongoDB 数据库连接 URI，格式为 mongodb://<用户名>:<密码>@<主机地址>
• URL：应用访问基础 URL，用于生成链接和重定向
• CORE_ONLY：是否仅启用核心功能，设为 true 时禁用部分高级特性
• DISABLE_TELEMETRY：是否禁用遥测功能，设为 true 时停止数据收集

遥测说明

默认情况下，应用会通过自托管的 umami 实例收集基本网站遥测数据。若需禁用遥测，可在环境变量中设置 DISABLE_TELEMETRY=true。