| 用途 | 提供构建所需文件来源 |
|---|---|
| 语法 | docker build [选项] 上下文路径（. / URL / -） |
| 控制大小 | .dockerignore |
示例
示例
du -sh . # 先看上下文有多大
docker build -t app/web:1.0 .
ls | tar czf - | docker build -t app/web:1.0 - # 以 tar 流为上下文上下文太大时每次构建都要先传输；把数据、日志、依赖目录排除后构建速度明显改善。
本包目录（366 条）
基础命令50 条
镜像与构建107 条
- docker build 构建镜像
- Dockerfile 结构与构建流程
- FROM 指定基础镜像
- docker images 列出本地镜像
- RUN 执行构建命令
- docker tag 给镜像打标签
- docker pull 拉取镜像
- COPY 复制文件进镜像
- 多阶段构建组织镜像
- docker build -t 命名与多标签
- docker push 推送镜像到仓库
- ENV 设置环境变量
- CMD 默认启动命令
- 层缓存原理与指令排序
- RUN 合并命令减少层体积
- ENTRYPOINT 固定入口点
- .dockerignore 排除构建上下文
- docker rmi 删除本地镜像
- docker login 登录镜像仓库
- WORKDIR 设置工作目录
- ENTRYPOINT 与 CMD 组合用法
- docker build --build-arg 传递构建参数
- docker image inspect 查看镜像元数据
- ARG 构建期变量与 --build-arg
- USER 指定运行用户
- HEALTHCHECK 容器健康检查
- Debian/Ubuntu 镜像中的 apt 安装
- 镜像非 root 运行实践
- 构建期密钥：ARG 的风险与 secret 替代
- EXPOSE 声明端口
- RUN --mount=type=cache 构建缓存挂载
- Node 镜像中的 npm 安装
- docker build -f 指定 Dockerfile
- buildx build 构建与导出规则
- 多架构镜像构建与推送
- docker image prune 清理未使用镜像
- COPY --chown 设置属主
- COPY --from 引用外部镜像文件
- Node 多阶段构建示例
- RUN --mount=type=secret 构建期机密
- Python 镜像中的 pip 安装
- docker build --no-cache 全量重建
- docker history 查看镜像构建历史
- FROM 结合 ARG 参数化基础镜像
- RUN 两种形式的语义差异
- COPY 通配符与多源复制
- VOLUME 声明数据卷挂载点
- Go 多阶段构建示例
- 构建上下文与传输
- Alpine 基础镜像的取舍
- 完整示例：前端构建 + Nginx 运行镜像
- docker build --target 只建到指定阶段
- 按平台构建与 --load 导出
- buildx 构建器实例管理
- 用 registry:2 搭建私有镜像仓库
- FROM --platform 多架构构建选择
- JSON 数组形式的写法细节
- 基础镜像版本固定策略
- docker build --pull 刷新基础镜像
- docker save 导出镜像为 tar
- Dockerfile 语法声明 # syntax
- ADD 与 COPY 的差异
- 统一 UID/GID 数字避免权限错位
- registry-mirrors 配置镜像加速
- COPY --link 独立层复制
- COPY 源与目标的路径语义
- docker build --progress 构建日志形态
- 构建缓存导出导入（registry 缓存）
- docker images --format 定制输出
- docker load 导入镜像归档
- LABEL 镜像元数据标签
- STOPSIGNAL 声明停止信号
- Dockerfile heredoc 多行写法
- distroless 运行镜像
- ENV 与 RUN export 的区别
- buildx imagetools 查看清单
- 镜像瘦身手段与验收
- SHELL 指令切换构建 shell
- ARG 作用域与重新声明
- docker build 构建期网络模式
- docker build --check 构建检查
- 悬空镜像 dangling 的成因与处理
- RUN --mount=type=ssh 转发 SSH 代理
- scratch 空镜像构建
- ENTRYPOINT 结合 tini 做 PID1
- docker build -q 安静模式
- docker history 定位体积大头
- insecure-registries 配置（内网 HTTP 仓库）
- buildx bake 多目标构建
- 内联缓存 BUILDKIT_INLINE_CACHE
- docker push --all-tags 批量推送标签
- 按 digest 引用镜像内容
- ONBUILD 延迟触发指令
- 从 stdin 提供 Dockerfile 或上下文
- ~/.docker/config.json 认证与客户端配置
- docker manifest inspect 查看多架构清单
- docker logout 退出仓库登录
- 镜像标签规范与回滚策略
- Docker Hub 拉取限流的识别与缓解
- docker save 一次导出多个镜像
- docker buildx du 查看构建缓存占用
- 镜像 OCI 标签与元数据
- 离线环境镜像搬运流程
- save/load 与 export/import 的区别
- docker search 检索 Docker Hub 镜像
- buildx 输出到本地目录或 OCI 归档
- 构建溯源声明与 SBOM 附加信息
构建上下文与传输
docker build 最后的路径就是构建上下文：目录内容（除 .dockerignore 排除项）会打包发送给构建器，COPY/ADD 只能引用其中文件。
易错点
- 忘记 .dockerignore 时 COPY . . 会把日志、数据集、.env 一并带进镜像，风险与体积双输
- 上下文按目录树打包，软链接指向外部路径的文件不会跟随复制
数据来源与参考
- Docker 官方文档：docker build / build context（docs.docker.com）