DCM：快速生成Docker Compose配置的自托管工具指南

为什么需要DCM？

在自托管和容器化部署的浪潮中，Docker Compose因其简洁的YAML配置格式成为开发者管理多容器应用的首选工具。然而，手动编写docker-compose.yaml文件常令人头疼——需要反复查阅文档、处理权限问题、配置环境变量，甚至可能因格式错误导致部署失败。

DCM（Docker Compose Maker） 应运而生，它通过可视化界面和预置模板，将复杂的容器配置转化为“选择-生成-部署”三步操作。无论是搭建家庭媒体服务器，还是构建开发测试环境，DCM都能显著降低学习成本，提升部署效率。

核心功能全景

一键生成生产级配置

  • 预置最佳实践：每个容器配置均包含权限管理（${PUID}/${PGID}）、时区同步（${TZ}）等关键设置
  • 环境变量分离：自动生成.env文件，敏感信息与配置解耦
  • 多平台兼容：支持Linux/amd64、arm64、armv7架构

模板化快速搭建

  • 场景化模板库：媒体服务器、开发环境、监控系统等常用组合
  • 自由叠加模板：支持混合多个模板创建个性化方案（如”媒体服务器+智能家居”）
  • 持续扩展生态：社区贡献驱动，每月新增10+应用配置

手把手实战指南

方法一：在线即时体验

访问 compose.ajnart.dev，无需安装即可：

  1. 选择「媒体服务器」模板
  2. 添加Jellyfin、Radarr、qBittorrent等组件
  3. 下载docker-compose.yaml和.env文件
  4. 执行docker-compose up -d完成部署

注意：在线版包含匿名使用统计，隐私敏感用户建议自托管部署

方法二：本地Docker运行

docker run -p 7576:7576 --name dcm --rm ghcr.io/ajnart/dcm

访问http://localhost:7576即可获得与在线版相同的功能，且无数据分析。

进阶部署方案

# docker-compose.yaml 示例
services:
  dcm:
    image: ghcr.io/ajnart/dcm
    ports:
      - "7576:7576"
    volumes:
      - ./custom_templates:/app/data/templates  # 挂载自定义模板
    restart: unless-stopped

通过Volume挂载可实现：

  • 添加私有容器配置
  • 修改默认模板
  • 持久化用户数据

支持的应用生态

媒体生态链

类型 代表工具
媒体服务器 Jellyfin、Plex、Emby
自动化工具 Sonarr（剧集）、Radarr（电影）、Lidarr（音乐）
请求管理 Overseerr、Jellyseerr
下载工具 qBittorrent（BT）、NZBGet（Usenet）

监控与运维

  • 实时监控：Grafana + Prometheus组合
  • 自动更新：Watchtower实现容器无感升级
  • 日志管理：Loki + Promtail方案（需手动添加）

数据存储方案

数据库类型 支持引擎
关系型 PostgreSQL、MySQL、MariaDB
NoSQL MongoDB、Redis
云存储 Nextcloud（私有云盘）

企业级部署技巧

Portainer集成实践

  1. 生成docker-compose配置后，在Portainer控制台创建新Stack
  2. 通过Web编辑器粘贴YAML内容
  3. 在Environment Variables部分导入.env内容
  4. 启用「自动更新」策略（建议生产环境关闭）

经验：将常用环境变量（如时区、UID）设置为Portainer全局变量，实现多项目复用

权限安全配置

services:
  jellyfin:
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - /path/to/media:/media
  • 所有预配置均强制要求PUID/PGID
  • 存储卷映射采用绝对路径规范
  • 默认禁用root权限运行

模板开发与贡献

创建自定义模板

  1. 在GitHub Fork项目仓库
  2. 在/data/templates目录新建YAML文件：
name: 智能家居套件
description: Home Assistant + Node-RED + MQTT
containers:
  - homeassistant
  - nodered
  - eclipse-mosquitto
  1. 提交Pull Request等待合并

质量验证流程

# 运行完整性测试
bun test:containers

# 验证Compose语法
docker-compose config

所有贡献需通过自动化测试套件验证，确保生成配置可直接投产。

常见问题解决

权限错误处理

# 检查宿主机用户组
id -u  # 获取PUID
id -g  # 获取PGID

# 递归修改目录权限
sudo chown -R ${PUID}:${PGID} /path/to/data

网络端口冲突

  • 在DCM界面修改「服务端口」字段
  • 使用network_mode: bridge实现容器间通信
  • 通过Traefik实现反向代理（推荐进阶方案）

项目生态与支持

社区驱动发展

  • 每月平均新增8个容器支持
  • GitHub Discussions提供配置讨论区
  • 模板投票机制决定开发优先级

支持开发者

  • GitHub Star🌟是最大的鼓励
  • 通过Ko-fi赞助服务器费用
  • 分享你的部署案例到#Showcase频道

立即开始你的容器化之旅

无论你是想搭建：

  • 🎬 家庭影院系统
  • 🛠️ 开发测试环境
  • 📊 业务监控平台
  • 🔒 私有云存储

DCM都提供开箱即用的解决方案。访问在线版体验，或查看GitHub仓库参与生态建设。

项目授权：MIT License｜由ajnart维护

– 高效码农：www.xugj520.cn –