8
0

Dockerfile 镜像制作与相关优化

2026-10-26
2026-10-26
Dockerfile 镜像制作与相关优化

一、本文说明

整理 Dockerfile 常用指令(ADD、MAINTAINER、LABEL、EXPOSE、VOLUME、ENV、ARG、ENTRYPOINT、HEALTHCHECK 等)的使用方法,以及基于 Dockerfile 构建多游戏镜像、镜像打标签、构建优化和多服务启动的实践。示例中的镜像名、路径和密码均为演示值。

二、ADD 指令:构建多游戏镜像

1. 关键结论

ADD 与 COPY 都是把本地文件复制到镜像,但 ADD 多两个能力:

  1. 源文件是 .tar.gz / .tar 压缩包时,会自动解压到目标目录;

  2. 源文件可以是 URL(会先下载再复制)。

推荐用法:复制普通文件优先用 COPY,只在需要自动解压 tar 包时才用 ADD。

2. Dockerfile 示例

# 指定基础镜像,后续操作都在该镜像之上进行
FROM alpine:3.20.2
​
# 更换软件源并安装 nginx,安装完成后清理缓存
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
      /etc/apk/repositories && \
    apk update && \
    apk add nginx && \
    rm -rf /var/cache/* /usr/share/nginx/* && \
    mkdir -pv /usr/share/nginx/html/huangjinkuanggong && \
    mkdir -pv /usr/share/nginx/html/killbird
​
# ADD 会把 tar 包内容自动解压到指定路径,
# 可以理解为:先拷贝到容器,再解压,最后删除源文件
ADD demo-huangjinkuanggong.tar.gz /usr/share/nginx/html/huangjinkuanggong
ADD demo-killbird.tar.gz /usr/share/nginx/html/killbird
​
# 把本地配置拷贝到容器并覆盖原文件
COPY games.conf /etc/nginx/http.d/default.conf
​
# 指定容器启动命令
CMD ["nginx", "-g", "daemon off;"]

原课堂记录里清理缓存的写法是 rm -rf /var/cache/ rm -f /usr/share/nginx/*。这种写法把 rm 和 -f 当成了路径参数,属于笔误,建议改为 rm -rf /var/cache/* /usr/share/nginx/*。

3. 编写编译脚本

#!/bin/bash
​
TAG=$1
docker image build -t demo-games:v2.${TAG:-4} .
docker container rm -f `docker container ps -qa`
docker container run -d --name games --network host demo-games:v2.${TAG:-4}
docker container ps -l

执行:

./build.sh 6

脚本说明:

  • ${TAG:-4}:不传参数时默认标签为 4,传 6 则为 v2.6;

  • --network host:容器共享宿主机网络,nginx 直接监听宿主机的 80 端口;

  • docker container rm -f \docker container ps -qa``:先清掉所有容器避免名称冲突。没有容器时会报 "requires at least 1 argument",可在末尾加 2>/dev/null 消除提示。

4. 观察中间层镜像

每一条 Dockerfile 指令都会产生一个新的镜像层。构建完成后用 docker image ls -a 可以看到中间层:

docker image ls -a | grep 324bc02ae123
# alpine        3.20.2   324bc02ae123   ... 7.8MB
​
docker image ls -a | grep 6ac145279d85
# <none>        <none>   6ac145279d85   ... 9.25MB
​
docker image ls -a | grep bd8b482ff427
# demo-games v2.6     bd8b482ff427   ... 15.6MB

<none> 就是没有被最终打标签的中间层,最终镜像由这些层叠加而成。

5. 访问测试

宿主机 /etc/hosts 增加:

10.0.0.101 game01.example.com
10.0.0.101 game02.example.com

浏览器访问对应域名即可。

三、MAINTAINER 与 LABEL:给镜像打标签

1. 指令说明

MAINTAINER 用于声明作者信息,但可读性较差,已被官方弃用;官方推荐用 LABEL 以键值对的形式声明元数据。

# 已弃用
MAINTAINER demo demo@example.com www.example.com
​
# 推荐
LABEL school=demo \
      class=demo-class \
      auther=demo \
      email=demo@example.com \
      office=www.example.com

2. 查看镜像信息

docker image inspect -f "{{.Author}}" demo-games:v2.8
# demo
​
docker image inspect -f "{{.Config.Labels.auther}}" demo-games:v2.8
# demo

四、构建优化:缓存与 .dockerignore

1. 观察缓存命中

再次执行构建时,没变化的指令会显示 Using cache:

Step 2/7 : RUN sed -i ... apk add nginx ...
 ---> Using cache

因此把不经常改动的指令放前面、经常改动的放后面,可以充分利用缓存,加快构建速度。

2. 构建上下文过大

Docker 构建时会把当前目录(构建上下文)整体发给守护进程:

dd if=/dev/zero of=./bigfile bs=1M count=1024
# 生成了一个 1GB 的无用文件

再构建时:

Sending build context to Docker daemon  1.087GB

目录里的无关大文件会严重影响构建速度。

3. 使用 .dockerignore

在构建目录创建 .dockerignore:

big*
*.exe
*.txt
*.log

被匹配的文件不会进入构建上下文。

4. 优化思路总结

编译速度:

  1. 不常改的指令放上面、常改的放下面,利用层缓存;

  2. 用 .dockerignore 忽略无关文件;

  3. 使用国内软件源或本地仓库,提升下载速度;

  4. 较大的软件包放到本地或内网文件站点,避免每次下载。

镜像大小:

  1. 删除缓存和无用软件包;

  2. 尽量合并指令,减少中间层(docker image ls -a 可以看到每层);

  3. 使用较小的基础镜像(如 Alpine)。

五、启动容器技巧

1. 进入容器时指定工作目录

docker exec -it -w /usr/share/nginx/html games sh

2. 运行容器时指定匿名存储卷

docker run -d --name game -v /usr/share/nginx/html demo-games:v2.9

查看卷落在宿主机的位置:

docker inspect -f "{{range .Mounts}}{{.Source}}{{end}}" game
# /var/lib/docker/volumes/<随机ID>/_data

3. 随机端口映射

docker run -dp :80 --name c2 demo-games:v2.9
docker ps -l

示例结果:

PORTS
0.0.0.0:32770->80/tcp, :::32770->80/tcp

-p :80 让宿主机随机分配高位端口映射到容器 80 端口。

六、VOLUME / EXPOSE / WORKDIR 案例

FROM alpine:3.20.2
​
LABEL school=demo class=demo-class auther=demo
​
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
      /etc/apk/repositories && \
    apk update && \
    apk add nginx && \
    rm -rf /var/cache/* /usr/share/nginx/*
​
ADD code/demo-pingtai.tar.gz /usr/share/nginx/html/pingtai
COPY config/games.conf /etc/nginx/http.d/default.conf
​
# 指定工作目录,连接容器时自动切换到该目录
WORKDIR /usr/share/nginx/html
​
# 声明暴露的端口
EXPOSE 80
​
# 将容器指定目录创建为存储卷
VOLUME /usr/share/nginx/html
​
CMD ["nginx", "-g", "daemon off;"]

指令说明:

指令

作用

备注

WORKDIR

设置工作目录

docker exec 进入后自动位于该目录

EXPOSE

声明容器监听端口

是声明性文档,真正映射靠 -p / -P

VOLUME

声明匿名卷

容器重建后数据保留在卷中

验证:

docker run -dP --name c1 demo-games:v2.13
docker ps -l
docker inspect -f "{{range .Mounts}}{{.Source}}{{end}}" c1
docker exec -it c1 sh
pwd
# /usr/share/nginx/html

七、ENV / ARG 案例:多服务启动

1. 指令区别

指令

生效阶段

覆盖方式

ENV

构建和运行阶段都生效

运行时 -e 覆盖

ARG

仅构建阶段生效

构建时 --build-arg 覆盖

2. 手动启动 openssh 的关键命令

apk add openssh-server       # 安装 sshd
ssh-keygen -A                # 生成主机密钥
sed -i 's@#PermitRootLogin prohibit-password@PermitRootLogin yes@' /etc/ssh/sshd_config
/usr/sbin/sshd               # 启动 sshd
echo root:123456 | chpasswd  # 免交互修改 root 密码

3. Dockerfile

FROM alpine:3.20.2
​
WORKDIR /usr/share/nginx/html
EXPOSE 80
VOLUME /usr/share/nginx/html
​
RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' \
      /etc/apk/repositories && \
    apk update && \
    apk add nginx openssh-server curl && \
    sed -i 's@#PermitRootLogin prohibit-password@PermitRootLogin yes@' /etc/ssh/sshd_config && \
    ssh-keygen -A && \
    rm -rf /var/cache/* /usr/share/nginx/html/*
​
# 运行时变量,构建和运行阶段都有效
ENV DEMO_USERNAME=root \
    DEMO_PASSWORD=321
​
# 构建期变量,仅构建阶段有效
ARG DEMO_SCHOOL=demo \
    DEMO_CLASS=demo-class
​
RUN touch /demo-${DEMO_USERNAME} && \
    touch /demo-${DEMO_PASSWORD} && \
    touch /demo-xixi-${DEMO_SCHOOL} && \
    touch /demo-haha-${DEMO_CLASS}
​
ADD code/demo-zhiwu.tar.gz /usr/share/nginx/html/zhiwu
COPY config/games.conf /etc/nginx/http.d/default.conf
COPY scripts/start.sh /
​
CMD ["/bin/sh", "-x", "/start.sh"]

4. 启动脚本 start.sh

#!/bin/sh
​
USERNAME=${DEMO_USERNAME:-root}
PASSWORD=${DEMO_PASSWORD:-123}
​
id ${USERNAME} || adduser ${USERNAME} -D
echo $USERNAME:$PASSWORD | chpasswd
​
/usr/sbin/sshd
nginx -g 'daemon off;'

5. 运行时用 -e 覆盖 ENV

docker run -dP --name c1 \
  -e DEMO_USERNAME=xixi \
  -e DEMO_PASSWORD=haha \
  demo-games:v2.14

进入容器验证:

docker exec -it c1 sh
env | grep DEMO_
# DEMO_USERNAME=xixi
# DEMO_PASSWORD=haha

6. 构建时用 --build-arg 覆盖 ARG

docker build -t demo-games:v2.15 \
  --build-arg DEMO_SCHOOL=demo-school \
  --build-arg DEMO_CLASS=demo-class .

验证构建期变量已生效:

docker run --rm -it demo-games:v2.15 sh
ls /demo-*
# /demo-321
# /demo-haha-demo-class
# /demo-root
# /demo-xixi-demo-school

八、HEALTHCHECK:健康检查

HEALTHCHECK 用来判断容器内服务是否正常。指定健康检查后,容器除了正常状态外,还有健康状态:

  1. 初始为 starting;

  2. 检查通过后变为 healthy;

  3. 连续失败一定次数后变为 unhealthy。

HEALTHCHECK --interval=1s \
            --timeout=1s \
            --start-period=10s \
            --retries=5 \
            CMD curl -H "host: game01.example.com" 127.0.0.1

参数说明:

参数

默认值

含义

--interval

30s

每隔多久检查一次

--timeout

30s

单次检查超时时间

--start-period

0s

启动宽限期,此期间失败不计数

--retries

3

连续失败多少次判定为 unhealthy

九、ENTRYPOINT:指定启动命令

1. CMD 与 ENTRYPOINT 的区别

指令

容器启动时可被覆盖?

典型用法

CMD

可以

提供默认命令/参数

ENTRYPOINT

不可直接覆盖

固定入口程序,命令作为参数传入

2. 示例

ENTRYPOINT ["/bin/sh", "-x", "/start.sh"]

两者混用时,CMD 的内容会作为参数传给 ENTRYPOINT:

ENTRYPOINT ["/bin/sh", "-c"]
CMD ["tail -f /etc/hosts"]

十、Dockerfile 指令速查表

指令

作用

FROM

指定基础镜像

RUN

构建阶段执行命令

COPY

复制本地文件到镜像

ADD

复制文件,支持自动解压 tar 和 URL

CMD

指定容器默认启动命令

ENTRYPOINT

指定容器入口程序

WORKDIR

设置工作目录

VOLUME

声明数据卷

EXPOSE

声明容器端口

LABEL

添加镜像元数据

MAINTAINER

声明作者(已弃用,用 LABEL 替代)

ARG

设置构建参数,--build-arg 覆盖

ENV

设置环境变量,-e 覆盖

HEALTHCHECK

定义健康检查

USER

指定运行用户

ONBUILD

定义子镜像构建时触发的指令

十一、总结

  1. ADD 能自动解压 tar 包,但普通文件复制优先用 COPY;

  2. MAINTAINER 已弃用,作者信息改用 LABEL;

  3. 构建优化围绕两条主线:编译速度(缓存、.dockerignore、国内源)和镜像大小(清理缓存、合并层、小基础镜像);

  4. ENV 运行时和构建时都有效,ARG 仅构建时有效;

  5. EXPOSE 只是声明端口,真正映射靠 -p;VOLUME 用于声明匿名卷;

  6. CMD 可被覆盖,ENTRYPOINT 固定入口,两者可混用;

  7. HEALTHCHECK 让容器具备 starting / healthy / unhealthy 状态。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!