Docker 不支持也不推荐将多个运行中的容器“合并”为单个镜像；正确做法是分别构建、推送各服务镜像，并通过 docker-compose.yml 统一编排部署。本文详解标准化构建、镜像管理与生产分发的最佳实践。
docker 不支持也不推荐将多个运行中的容器“合并”为单个镜像；正确做法是分别构建、推送各服务镜像，并通过 `docker-compose.yml` 统一编排部署。本文详解标准化构建、镜像管理与生产分发的最佳实践。
在 Docker 生态中，不存在“merge containers”这一操作——容器是运行时实例，镜像是不可变的构建产物，而微服务架构天然鼓励职责分离。你当前使用 docker-compose.yml 协调 Nginx 与 PHP-FPM 容器，这本身就是最佳实践；目标不应是“合并容器”，而是实现可复现、可分发、无本地依赖的镜像化部署流程。
✅ 正确路径：分离构建 + 统一编排
你需要两个独立但协同的镜像：
- nginx 镜像：仅含静态文件、配置和 Nginx 运行时；
- php-fpm 镜像：仅含应用代码、PHP 运行时及扩展。
二者通过 Docker 网络通信（如默认 bridge 或自定义网络），不共享文件系统、不耦合进程、不混杂职责。
1. 重构 Dockerfile：按角色拆分（推荐）
避免单 Dockerfile 多 FROM 目标带来的混淆，为每个服务创建专用文件：
# Dockerfile.nginx FROM nginx:1.21.6-alpine COPY ./src/ /var/www/html/ COPY ./nginx/conf.d/app.conf /etc/nginx/conf.d/default.conf EXPOSE 80
# Dockerfile.php FROM php:7.4-fpm-alpine RUN docker-php-ext-install pdo_mysql opcache COPY ./src/app/ /var/www/html/app/ EXPOSE 9000
⚠️ 注意：COPY 必须将代码打入镜像——删除 volumes 挂载后，镜像才真正自包含。开发时可用 override 文件临时挂载，但生产镜像必须“开箱即用”。
2. 分层 docker-compose.yml：兼顾开发与生产
主文件 docker-compose.yml（用于生产/分发）
✅ 仅声明 image、端口暴露策略、网络连接，不含任何 build 或 volume：
version: '3.8'
services:
nginx:
image: registry.example.com/myapp/nginx:${TAG:-latest}
ports: ["80:80"]
depends_on: [php]
php:
image: registry.example.com/myapp/php:${TAG:-latest}
# 不暴露 9000 端口给外部 —— 仅限内部通信覆盖文件 docker-compose.override.yml（仅本地开发使用）
⚠️ 此文件不提交至仓库或分发，用于快速迭代：
version: '3.8'
services:
nginx:
build:
context: .
dockerfile: Dockerfile.nginx
volumes:
- ./src/:/var/www/html/
php:
build:
context: .
dockerfile: Dockerfile.php
ports: ["9000:9000"] # 便于本地调试Compose 自动合并两者：docker-compose build 会基于 override 中的 build 构建并打上 registry.example.com/... 标签；docker-compose up 则按主文件拉取远程镜像。
3. 构建、推送与部署全流程
# 1. 设置语义化标签（推荐 Git SHA 或日期） export TAG=20260417 # 2. 构建并推送双镜像（自动使用 override 中的 build 配置） docker-compose build docker-compose push # 3. 在目标服务器上仅需此命令（无需源码、Dockerfile、override） scp docker-compose.yml user@prod-server:/opt/myapp/ ssh user@prod-server "cd /opt/myapp && export TAG=20260417 && docker-compose up -d"
此时 Docker 将自动从私有 Registry 拉取 nginx:${TAG} 和 php:${TAG} 镜像，并启动完全隔离、无外部依赖的服务栈。
? 关键原则总结
- ❌ 禁止尝试用 docker commit 导出运行中容器为“合并镜像”——破坏可重现性、引入未知状态、违反不可变镜像原则；
- ✅ 必须确保镜像内含全部运行时依赖（PHP 扩展、Nginx 配置、应用代码）；
- ✅ 推荐使用 docker-compose push（需 Compose v2.20+）或脚本循环 docker push 实现批量推送；
- ✅ 生产环境禁用 container_name 和自定义 networks（除非有跨栈通信需求），默认网络更轻量、更安全；
- ✅ 使用 .env 文件管理 TAG、REGISTRY 等变量，提升可移植性。
遵循此模式，你的应用即可实现：
? 开发时热重载（via override）
? 测试时环境一致（镜像即环境）
? 生产时一键部署（仅需 compose 文件 + tag）
? 团队协作零歧义（镜像来源清晰、构建逻辑分离）
这才是 Docker 原生、可持续、符合云原生演进方向的交付范式。
