· Dockerfile 与 docker run

Dockerfile 与 docker run

2206 字
11 分钟
Dockerfile 与 docker run
StarryLin/Geek · 摘要

本文讲Dockerfile指令与docker run用法，覆盖构建运行流程、实战易错点及排错清单，并给出合并RUN、多阶段构建等精简镜像习惯；EXPOSE仅声明端口。
2026-09-04
Docker
Docker

一、镜像、容器与仓库#

  • 镜像：包含文件系统层和运行配置的只读模板。
  • 容器：镜像的运行实例，拥有自己的可写层与进程生命周期。
  • 仓库：保存和分发镜像的服务。

一、镜像、容器与仓库#

  • 镜像：包含文件系统层和运行配置的只读模板。
  • 容器：镜像的运行实例，拥有自己的可写层与进程生命周期。
  • 仓库：保存和分发镜像的服务。

二、Dockerfile 指令速查#

2.1 基础指令#

指令作用示例
FROM开始构建阶段；前面可以有全局 ARG、注释和解析器指令FROM ubuntu:22.04
MAINTAINER声明作者（已过时，推荐用 LABEL）MAINTAINER CloudStudio author
LABEL以键值对形式写元数据LABEL env=production
WORKDIR设置后续指令的工作目录（不存在会自动创建）WORKDIR /app
USER指定运行用户，避免用 rootUSER www-data
ARG构建时参数，唯一可出现在 FROM 之前的指令ARG VERSION=latest

ARG 与 ENV 的区别要记住：

ARG  → 构建参数，不自动成为容器环境变量；值仍可能出现在构建历史或证明信息里，不能用于传递密钥
ENV  → 构建期和运行期都在，会持久化到容器里

2.2 文件操作：COPY 还是 ADD？#

指令能力建议
COPY单纯复制本地文件/目录默认就用它
ADD额外支持 URL 下载、tar 自动解压只有需要这两个特性时才用
# 本地目录
COPY site/ /var/www/html/
# 远程下载
ADD https://ftp.xxx/jenkins/war/2.397/jenkins.war /data/app
# 自动解压
ADD project.tar.gz /install/

2.3 执行指令：最容易混淆的三个#

指令执行时机能否被覆盖典型用途
RUNdocker build 时不适用装软件、建目录、编译
CMDdocker run 时✅ 可覆盖容器默认启动命令
ENTRYPOINTdocker run 时可用 --entrypoint 覆盖固定默认入口，exec 形式可搭配 CMD 提供默认参数
# 构建时装软件
RUN apt-get install -y nginx
# 启动时跑服务
CMD ["nginx", "-g", "daemon off;"]

覆盖示例：

Terminal window
docker run myimage nginx -g "daemon off;"   # 覆盖 CMD
docker run myimage -v                       # exec ENTRYPOINT 下替换 CMD 参数
docker run --entrypoint sh myimage          # 覆盖 ENTRYPOINT

推荐 CMD 用 exec 形式（JSON 数组）：CMD ["nginx","-g","daemon off;"]。 写 CMD nginx -g "daemon off;"（shell 形式）会额外起一个 shell 进程，导致信号无法正确传递给主进程，docker stop 时容器不会优雅退出。

2.4 配置指令#

指令作用示例
ENV设置环境变量ENV DEBIAN_FRONTEND=noninteractive
EXPOSE声明容器监听端口EXPOSE 80
VOLUME声明数据卷VOLUME ["/data"]

EXPOSE 只是声明/文档，不会真的开放端口。发布到宿主机端口通常用运行时的 -p；同网容器通信无需先发布端口：

Terminal window
docker run -p 8080:80 myimage    # 宿主机8080 → 容器80

三、从 Dockerfile 到容器的四个阶段#

Terminal window
# 1. 默认读取名为 Dockerfile 的文件；其他文件名可通过 -f 指定
vim Dockerfile


# 2. 编写指令（见下文实战）


# 3. 构建镜像，-t 打标签，末尾的 . 是构建上下文（当前目录）
docker build -t mywebserver:1.0 .


# 4. 运行容器
docker run -d --name myweb -p 80:80 mywebserver:1.0

关于构建上下文：docker build 末尾的 . 不是”Dockerfile 所在目录”这么简单，而是要把哪些文件打包发送给 Docker 守护进程。所以：

  • COPY ./nginx.conf ... 的源路径必须在上下文内；
  • 上下文里塞一堆无用文件会拖慢构建 → 用 .dockerignore 排除。

四、实战：把 Web 服务器装进容器#

4.1 版本 A：Apache（教学内容示例）#

FROM ubuntu
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update
RUN apt-get install apache2 -y
RUN apt-get install apache2-utils -y
RUN apt-get clean
EXPOSE 80
CMD ["apache2ctl","-D","FOREGROUND"]

逐句说明：

行作用
FROM ubuntu以官方 Ubuntu 为基础镜像
ENV DEBIAN_FRONTEND=noninteractive装软件时弹出交互式对话框会让构建卡死，这条让它全部用默认值
RUN apt-get update刷新软件源索引，不做的话常报 Unable to locate package
RUN apt-get install apache2 -y安装 Apache；-y 自动回答 yes
RUN apt-get install apache2-utils -y安装配套工具（ab 压测、htpasswd 等）
RUN apt-get clean清理下载缓存，减小镜像
EXPOSE 80声明监听 80 端口
CMD ["apache2ctl","-D","FOREGROUND"]前台启动 Apache

4.2 版本 B：nginx（优化版，推荐照这个写）#

FROM ubuntu:22.04
ENV DEBIAN_FRONTEND=noninteractive


# 合并 RUN，减少层数；同一层内清理缓存，镜像才真的变小
RUN apt-get update \
 && apt-get install -y nginx \
 && apt-get clean \
 && rm -rf /var/lib/apt/lists/*


# 放入自定义配置
COPY nginx.conf /etc/nginx/nginx.conf
# 放入站点内容
COPY site/ /var/www/html/


EXPOSE 80
# daemon off = 前台运行
CMD ["nginx", "-g", "daemon off;"]

配套的 nginx.conf（最小可用）：

user www-data;
worker_processes auto;
pid /run/nginx.pid;


events {
    worker_connections 768;
}


http {
    include /etc/nginx/mime.types;
    default_type application/octet-stream;
    sendfile on;
    keepalive_timeout 65;


    server {
        listen 80 default_server;
        server_name _;
        root /var/www/html;
        index index.html;


        location / {
            try_files $uri $uri/ =404;
        }
    }
}

4.3 三个必踩的坑#

坑 1：服务后台运行，容器秒退

容器的生命周期 = 主进程的生命周期。Apache/nginx 默认以守护进程方式启动，主进程 fork 完就退出，容器随之 Exited。

# ✅ 前台
CMD ["apache2ctl","-D","FOREGROUND"]
# ✅ 前台
CMD ["nginx","-g","daemon off;"]
# ❌ 后台，容器立刻退出
CMD ["service","nginx","start"]

坑 2：COPY 的源文件不在构建上下文里

COPY ./nginx.conf /etc/nginx/nginx.conf
ERROR: "/nginx.conf": not found

解决：确认宿主机当前目录下真有 nginx.conf，且没被 .dockerignore 排除。

坑 3：镜像名当成了占位符

Terminal window
docker run -d -p 80:80 tag_name     # ❌ tag_name 是文档占位符
docker run -d --name myweb -p 80:80 mywebserver:1.0   # ✅ 换成真实镜像名

报错特征（本地没有 + 远程也没有）：

Unable to find image 'tag_name:latest' locally
pull access denied for tag_name, repository does not exist

4.4 验证#

Terminal window
docker ps                      # STATUS 应为 Up
docker logs myweb              # 启动失败时看这里
curl http://localhost:80       # 或平台「端口管理」打开 80 端口
docker exec -it myweb bash     # 进容器内部排查

五、写出好 Dockerfile 的六个习惯#

  1. 按兼容性和维护状态选基础镜像。Alpine 通常更小，但使用 musl，部分原生依赖可能需要改用 Debian/Ubuntu slim 镜像。
  2. 合并 RUN，并在同一层内清理缓存： 
    RUN apt-get update && apt-get install -y nginx && apt-get clean && rm -rf /var/lib/apt/lists/*
    分开写多条 RUN，前一层已写进去的缓存在后一层删不掉，镜像不会变小。
  3. 必须配 .dockerignore，排除 .git、node_modules、*.md、日志等。
  4. 善用构建缓存：把变化少的指令（FROM、装依赖）放前面，变化频繁的（COPY 代码）放后面。
  5. 用 COPY 而非 ADD，用 WORKDIR 而非一堆 cd，避免以 root 运行。
  6. 多阶段构建瘦身，尤其适合编译型项目： 
    FROM maven:3.5-jdk-8-alpine AS build
    WORKDIR /app
    COPY . .
    RUN mvn install
    

    FROM openjdk:8-jre-alpine
    WORKDIR /app
    COPY --from=build /app/target/app.jar app.jar
    CMD ["java","-jar","app.jar"]
    第一阶段负责编译，只把产物捞到第二阶段，JDK、Maven 依赖全部不进最终镜像。

六、排错清单#

现象原因与处理
Unable to locate package xxx缺 apt-get update
构建卡在交互界面加 ENV DEBIAN_FRONTEND=noninteractive 和 -y
容器一启动就 Exited服务没前台运行（见坑 1）
COPY xxx: not found文件不在上下文或被 .dockerignore 排除
pull access denied镜像名错误或不存在（见坑 3）
端口访问不通漏了 -p；或容器内服务只监听 127.0.0.1
bind: address already in use宿主机端口被占用，换一个：-p 8080:80
mvn install 报 no POM目录里没有 pom.xml
镜像过大多阶段构建 + 同层清理缓存
改了代码容器里没变COPY 是构建时复制，改完必须重新 docker build

七、附录：可复用的脚本模板#

把下面两个文件放进项目根目录，chmod +x 后即可用，避免每次手敲长命令。

build.sh#

#!/usr/bin/env bash
# 构建镜像：读取当前目录下的 Dockerfile
set -e


IMAGE_NAME=${IMAGE_NAME:-mywebserver}
IMAGE_TAG=${IMAGE_TAG:-1.0}


docker build -t "${IMAGE_NAME}:${IMAGE_TAG}" .


echo "✅ 镜像构建完成：${IMAGE_NAME}:${IMAGE_TAG}"
echo "   查看详情：docker images ${IMAGE_NAME}"

run.sh#

#!/usr/bin/env bash
# 运行容器：把容器端口映射到宿主机端口
set -e


IMAGE_NAME=${IMAGE_NAME:-mywebserver}
IMAGE_TAG=${IMAGE_TAG:-1.0}
CONTAINER_NAME=${CONTAINER_NAME:-myweb}
HOST_PORT=${HOST_PORT:-80}            # 宿主机端口
CONTAINER_PORT=${CONTAINER_PORT:-80}  # 容器内应用实际监听的端口；EXPOSE 不会强制设置它


# 同名容器已存在则先移除，避免名称/端口冲突
if docker ps -a --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}\$"; then
  echo "⚠️  容器 ${CONTAINER_NAME} 已存在，先移除"
  docker rm -f "${CONTAINER_NAME}" >/dev/null
fi


docker run -d \
  --name "${CONTAINER_NAME}" \
  -p "${HOST_PORT}:${CONTAINER_PORT}" \
  "${IMAGE_NAME}:${IMAGE_TAG}"


echo "✅ 容器已启动：${CONTAINER_NAME}"
echo "   访问地址：http://localhost:${HOST_PORT}"
echo "   查看日志：docker logs -f ${CONTAINER_NAME}"
echo "   停止容器：docker stop ${CONTAINER_NAME}"

用法#

Terminal window
chmod +x build.sh run.sh


./build.sh                                        # 默认构建 mywebserver:1.0
./run.sh                                          # 默认 -p 80:80


IMAGE_NAME=blog IMAGE_TAG=2.0 ./build.sh          # 自定义镜像名与版本
HOST_PORT=8080 CONTAINER_PORT=80 ./run.sh         # 80 被占用时换宿主机端口
docker build --build-arg VERSION=2.0 -t app:2.0 . # 传 ARG 构建参数

配套 .dockerignore#

.git
.gitignore
.vscode
.idea
.tutorial
*.md
Dockerfile*
.dockerignore
*.sh
node_modules
target
dist
*.log

写在最后#

Dockerfile 语法本身不多，真正决定水平的是这几个判断：

  • 服务要前台跑，容器才不会秒退；
  • 清理缓存要和安装在同一层，镜像才真的会变小；
  • COPY 是构建时快照，改代码就要重新构建；
  • 报错先看 docker logs，再看 docker ps -a 的状态。

核对资料#

文章分享

如果这篇文章对你有帮助，欢迎分享给更多人！

Dockerfile 与 docker run
https://mjzy.tech/posts/docker/03-dockerfile-与-docker-run/
作者
JIA
发布于
2026-09-04
许可协议
CC BY-NC-SA 4.0
AI 进入 CI/CD 流水线
Docker 镜像制作实践
相关文章 智能推荐
1
Docker 概述与架构原理
Docker Docker镜像交付，容器三级调度运行，推荐构建一次后pull+run部署。
2
Docker 环境安装
Docker Windows用WSL2加Docker Desktop，Ubuntu用apt装Docker CE；docker组等同root须慎用。
3
Docker 镜像制作实践
Docker Docker镜像制作实践，涵盖Dockerfile编写、分层缓存优化、上下文与dockerignore管理、镜像推送、commit与save差异及常见故障排查。
4
文件系统解析：FAT32、NTFS、EXT4 与 exFAT
Docker 本文对比FAT32、NTFS、EXT4与exFAT，说明各自容量、安全与兼容性特点及选型权衡。性能结论受驱动、挂载选项与硬件影响。
5
容器内常用命令
Docker 本文介绍Docker容器内执行命令的方法及常用命令速查，比较Bash、exec与Dockerfile RUN的差异，说明镜像容器管理要点与安全边界。
随机文章 随机推荐

评论区

分享你的想法，与大家交流讨论

正在加载 GitHub 评论…

Tips · 随手记
自动保存到此浏览器0
仅自己可见 · 每篇文章单独保存
© 2026 JIA. All Rights Reserved. / RSS / Sitemap
Built with Astro · Dusty Notes

文章目录