DF

Dockerfile 生成

常用镜像模板 + 多阶段构建 + 缓存与瘦身建议


                

        

        

如何使用本工具

  1. 选一个基础镜像,工作目录、依赖文件、安装与启动命令会自动填好,再按项目实际情况改。
  2. 前端或需要编译的项目勾上「多阶段构建」,构建产物会被拷进干净的第二阶段,镜像能小一半以上。
  3. 「依赖文件」和「安装依赖」要放在 COPY . . 之前,这样只改业务代码时依赖层能命中缓存。
  4. 运行用户建议填非 root 账号(node、www-data 或自己建的),不填会有风险提示。
  5. 右侧复制 Dockerfile,下方复制 docker build / run 命令,.dockerignore 建议一并建上。

常见问题

Q:为什么要把 COPY package.json 单独写一行?

A:Docker 每一层都会缓存,只要输入没变就复用。先 COPY 依赖清单再 RUN 安装,然后才 COPY 源码,这样改业务代码时依赖层不变,构建只需几秒。反过来先 COPY . . 再 npm install,任何一行代码改动都会让整个依赖重装。

Q:多阶段构建到底省了什么?

A:省掉编译工具链和开发依赖。第一阶段装 node_modules 全量、跑构建,第二阶段只从第一阶段 COPY 产物,最终镜像里没有源码、没有 devDependencies、没有编译器。Node 项目通常能从 1GB 降到 150MB 左右。

Q:CMD 为什么推荐 JSON 数组写法?

A:shell 形式 CMD node server.js 会被包成 /bin/sh -c "node server.js",主进程变成 sh 而不是 node。这样 docker stop 发的 SIGTERM 打不到 node 上,应用没机会优雅退出,等 10 秒后被 SIGKILL 硬杀。JSON 形式让 node 直接成为 1 号进程。

Q:为什么必须写 .dockerignore?

A:docker build 会先把整个目录当上下文发给守护进程。node_modules、.git、日志、.env 全被塞进去,构建变慢,还可能把密钥打进镜像层。.dockerignore 的语法和 .gitignore 类似。

Q:alpine 一定比 debian 好吗?

A:不一定。alpine 用 musl libc 而不是 glibc,某些二进制依赖(老版本 Node 原生模块、部分 Python 包)会编译失败或运行时报错。省下的几十 MB 换来排查成本不划算时,用 slim 版 Debian 更稳。

Q:USER 写了不存在的用户会怎样?

A:容器直接启动失败,报错类似 unable to find user。基础镜像自带的用户才能直接用:node 镜像有 node,nginx 镜像有 nginx,python slim 默认只有 root,需要自己 RUN useradd 再 USER。