Docker 镜像构建：手把手教你用 docker commit 定制专属镜像

在 Docker 中构建自定义镜像有两种主流方式：docker commit 命令和 Dockerfile 文件。相比 Dockerfile 的"声明式"构建，docker commit 更像"交互式"快照——通过在容器中手动操作，再将修改保存为新镜像。本文将深入讲解 docker commit 的工作原理、使用场景、操作步骤及注意事项，帮你快速掌握这种灵活的镜像定制方法。

一、什么是 docker commit？

docker commit 是 Docker 提供的一个命令，用于将容器的当前状态（包括所有修改）保存为一个新的镜像。简单来说，它就像给容器拍了一张"快照"，这个快照可以作为新镜像被后续容器复用。

核心原理

容器是镜像的运行实例，基于镜像的只读层创建了一层可写层（容器层）。当你在容器内修改文件、安装软件时，所有变更都只发生在这层可写层。docker commit 的作用就是将这层可写层"固化"，与底层镜像合并成一个新的只读镜像。

（示意图：容器层变更通过 commit 成为新镜像层）

• 基础镜像层：来自原始镜像（如 ubuntu:20.04），由多个只读层叠加而成，不可修改；
• 容器层：容器启动时在基础镜像层之上创建的唯一可写层，所有操作（安装软件、修改配置、新增文件）均在这一层执行；
• docker commit 后：可写的容器层被 “冻结” 为只读层，与底层基础镜像层合并，形成新的镜像（新镜像仍保持分层结构，可被后续容器复用）。

二、为什么要用 docker commit？

虽然 Docker 官方更推荐使用 Dockerfile（可追溯、可重复构建），但 docker commit 仍有其不可替代的场景：

1. 快速验证环境配置：在容器内临时安装依赖、调试配置，确认可用后直接保存为镜像，无需先写 Dockerfile
2. 修复紧急问题：生产环境容器出现异常，临时修改后 commit 为镜像，快速替换故障容器
3. 学习与实验：通过手动操作理解镜像分层原理，直观感受容器与镜像的关系
4. 迁移现有容器：将运行中的容器状态打包成镜像，迁移到其他环境（如从测试机到生产机）

三、docker commit 实战：从容器到自定义镜像

下面通过一个实例，完整演示 docker commit 的使用流程：基于官方 Ubuntu 镜像，在容器内安装 Nginx，然后将修改保存为新镜像。

步骤 1：启动基础容器

首先从 Docker Hub 拉取基础镜像（这里用 Ubuntu 20.04），并启动一个交互式容器：

# 拉取基础镜像
docker pull ubuntu:20.04

# 启动容器（--name 命名容器，-it 交互式终端）
docker run --name my-ubuntu -it ubuntu:20.04 /bin/bash

执行后会进入容器的命令行界面（提示符类似 root@容器ID:/#），表示已在容器内操作。

步骤 2：在容器内做修改

在容器内安装 Nginx（模拟实际开发中对环境的定制）：

# 更新 apt 包索引
apt-get update

# 安装 Nginx（-y 自动确认）
apt-get install -y nginx

# 验证 Nginx 是否安装成功
nginx -v  # 输出版本信息即表示安装成功

此时容器已被修改（新增了 Nginx 及依赖），这些变更仅存在于当前容器的可写层。

步骤 3：提交容器为新镜像

保持容器运行（可另开一个终端），执行 docker commit 命令：

# 格式：docker commit [选项] 容器名/容器ID 新镜像名:标签
docker commit -m "Install Nginx on Ubuntu 20.04" my-ubuntu my-nginx:1.0

• -m：添加镜像描述（类似 Git commit 的注释）
• my-ubuntu：被提交的容器名称（也可用容器 ID，通过 docker ps 查看）
• my-nginx:1.0：新镜像的名称和标签（标签推荐用版本号）

执行成功后，会输出新镜像的 ID（如 sha256:abc123...）。

步骤 4：验证新镜像

通过 docker images 查看是否生成新镜像：

docker images | grep my-nginx

输出类似：

my-nginx   1.0    abc123456789   10 seconds ago   220MB

步骤 5：用新镜像启动容器

测试新镜像是否可用——启动一个容器，检查 Nginx 是否存在：

# 用新镜像启动容器，并映射 80 端口
docker run -d -p 8080:80 --name my-nginx-container my-nginx:1.0

# 进入容器验证 Nginx
docker exec -it my-nginx-container /bin/bash
nginx -v  # 应输出之前安装的版本

也可通过宿主机访问 http://localhost:8080，若看到 Nginx 默认页面（需在容器内先启动 Nginx：service nginx start），则证明镜像定制成功。

四、docker commit 命令详解

基本语法

docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

常用选项

选项	作用	示例
-m	添加镜像提交信息（类似 Git 注释）	docker commit -m "安装 Python" my-container my-python:3.9
-a	指定镜像作者	docker commit -a "张三 <zhangsan@example.com>" my-container my-img:1.0
--pause=true	提交时暂停容器（默认 true，避免提交过程中容器状态变化）	docker commit --pause=false my-container my-img（不暂停）
--change	提交时添加 Dockerfile 指令（如 EXPOSE、ENV）	docker commit --change "EXPOSE 8080" my-container my-img

示例：带作者信息和端口声明

docker commit \
  -a "Li Ming <liming@example.com>" \
  -m "Ubuntu + Python 3.9 + Flask" \
  --change "EXPOSE 5000" \
  my-python-container \
  my-flask-app:2.0

五、使用 docker commit 的注意事项

虽然 docker commit 灵活方便，但也有明显局限性，使用时需特别注意：

1. 镜像不可追溯，难以维护

docker commit 是"黑箱操作"——你无法知道镜像内部做了哪些修改（比如安装了哪些依赖、修改了哪些配置）。而 Dockerfile 是明文指令，可清晰追溯构建过程。

建议：仅在临时场景使用 docker commit，正式环境优先用 Dockerfile，并将镜像构建过程文档化。

2. 镜像体积容易膨胀

容器内的临时文件（如 apt 缓存、日志）会被一并提交到镜像，导致体积过大。例如：

• 执行 apt-get update 会生成缓存文件，若未清理，镜像会增加几十 MB
• 容器内误操作产生的垃圾文件也会被打包

解决办法：提交前手动清理冗余文件：

# 在容器内执行清理
apt-get clean  # 清理 apt 缓存
rm -rf /var/lib/apt/lists/*  # 删除软件包列表

3. 安全性风险

如果在容器内操作时不小心泄露敏感信息（如密码、密钥），这些信息会被永久保存在镜像中，即使后续删除也可能通过镜像历史层恢复。

建议：提交前检查容器内是否有敏感文件，必要时用 docker history 查看镜像历史层。

4. 难以重复构建

基于 docker commit 构建的镜像无法通过命令重现，一旦基础环境变化（如基础镜像更新），需要重新手动操作。而 Dockerfile 可通过 docker build 一键重建。

六、docker commit vs Dockerfile：如何选择？

维度	docker commit	Dockerfile
操作方式	交互式手动操作	声明式指令文件
可追溯性	差（无法知道具体修改）	好（指令明文可见）
可重复性	差（无法一键重建）	好（docker build 重复执行结果一致）
适用场景	临时测试、紧急修复、学习实验	正式环境、自动化部署、团队协作
镜像体积控制	较难（易包含冗余文件）	容易（可通过指令清理）
学习成本	低（直观操作）	中（需学习指令语法）

总结：docker commit 是"快速原型工具"，适合临时场景；Dockerfile 是"工程化工具"，适合生产环境。实际开发中，可先用 docker commit 验证环境配置，再将操作转化为 Dockerfile 指令，实现规范化构建。

七、总结

docker commit 通过将容器状态快照化为镜像，提供了一种简单直接的镜像定制方式。它的优势在于操作灵活、上手快，能快速将容器内的修改固化为可用镜像，特别适合临时验证和实验场景。

但同时也要注意其局限性：镜像不可追溯、体积易膨胀、难以重复构建。因此，在正式项目中，建议将 docker commit 作为过渡手段，最终用 Dockerfile 实现镜像的标准化、可维护构建。

若有转载，请标明出处：https://blog.csdn.net/CharlesYuangc/article/details/153800465