首页/云/云与容器速查/.dockerignore 构建上下文裁剪
本包目录(340 条)
云基础概念44 条计算与存储56 条网络与安全组33 条
容器与 Docker106 条
Kubernetes68 条容器排障33 条

.dockerignore 构建上下文裁剪

放在构建上下文根目录,按 gitignore 风格排除文件:缩小发送给构建器的上下文、加速构建,并防止 .env、密钥、node_modules 混进镜像。

云与容器速查云更新于 2026-10-12
位置与 Dockerfile 同目录;由构建上下文根决定生效范围
语法glob 通配、! 反选、# 注释,行为与 .gitignore 接近
常见排除node_modules、.git、dist、*.log、.env*、本地缓存
收益上下文更小构建更快;敏感文件不进入镜像层

示例

示例
node_modules
.git
dist
*.log
.env*
!.env.example
Dockerfile 与 .dockerignore 自身即使被排除,构建器仍会读取它们来完成构建——排除它们并不会阻止其被使用。

易错点

  • 漏排除 .env:密钥被打进镜像层,推送仓库即泄露
  • 用 ! 反选前没先排除父目录:反选不生效,文件仍被忽略

数据来源与参考

  • Docker Docs:.dockerignore file

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌