关键不是“事后清理”,而是从构建上下文、Dockerfile指令、阶段设计和交付验证四环节切断泄露路径,核心原则是不进镜像、不留痕、不固化:.dockerignore过滤上下文,禁用明文ENV/RUN设密,多阶段精准COPY产物,交付前用Trivy等工具黑盒扫描验证。
避免敏感信息在 docker 镜像构建过程中泄露,关键不是“事后清理”,而是从构建上下文、dockerfile 指令、阶段设计和交付验证四个环节切断泄露路径。核心原则是:不进镜像、不留痕、不固化。
.dockerignore 是第一道安全网
构建时,docker build . 会把当前目录整个打包上传为构建上下文——哪怕你 Dockerfile 里什么都没 COPY,.env、.npmrc、.aws、secrets/、*.pem、.git 这些文件也已进入守护进程内存或中间缓存。
- 必须在项目根目录放置 .dockerignore,逐行明确排除高危项
- 典型规则包括:.env .npmrc .aws secrets/ *.key *.pem .git __pycache__ node_modules .vscode .idea *.log
- 需要保留的个别文件(如 README.md)用 !README.md 白名单放行
- 构建前可快速验证:运行 tar -cf - . | tar -t | grep -E '\.(env|key|pem)$',输出为空才表示上下文干净
禁用所有明文设密的 ENV 和 RUN 指令
Docker 镜像层只增不减,ENV DB_PASSWORD=123 或 RUN echo "token=$API_KEY" > config.json 会把值直接写入某一层,后续 RUN rm 无法真正删除,仍可通过 docker history --no-trunc 或 docker image inspect 提取。
- 删掉所有含敏感值的 ENV;仅保留非敏感变量,如 APP_ENV=prod、TZ=Asia/Shanghai
- 禁止在 RUN 中拼接敏感内容到文件;改用运行时注入(如启动脚本读取挂载的 secret 文件)
- ARG 只用于构建逻辑(如版本号),不得用于存储密钥,也不得在 RUN 中 echo 或写入持久化文件
多阶段构建必须精准复制产物
很多泄露源于 COPY 操作过于宽泛:COPY . . 或 COPY config/ . 把本地开发配置、测试数据、源码甚至 .git 全部打进镜像。
- 构建阶段(builder)只安装依赖、编译代码,不 COPY 整个 src/ 或 config/ 目录
- 运行阶段(runtime)只 COPY --from=builder 明确产物:dist/、build/、二进制文件等
- 绝不复制 .git、node_modules、.env.example(除非确认无敏感字段)、*.local 配置
- 配置类文件应在运行时注入,而非构建时 COPY;若带默认配置,确保不含 password、token、secret 等字段
交付前强制黑盒扫描验证
不能依赖“我记得没加”。最终镜像要当黑盒查——不看 Dockerfile,只看里面有没有东西。
- 使用 Trivy image --scanners secret,config, vulnerabilty your-image:tag 扫描密钥、配置风险与漏洞
- 用 docker history --no-trunc your-image:tag 检查各层指令,识别 RUN echo、COPY *.env 等高风险操作
- 对基础镜像启用签名验证(Docker Content Trust),防止被篡改的镜像流入构建流程
- 优先选用 distroless 或 scratch 作为运行阶段基础镜像,彻底移除 shell 和包管理器,压缩攻击面


















