Dockerfile 生成
常用镜像模板 + 多阶段构建 + 缓存与瘦身建议
如何使用本工具
- 选一个基础镜像,工作目录、依赖文件、安装与启动命令会自动填好,再按项目实际情况改。
- 前端或需要编译的项目勾上「多阶段构建」,构建产物会被拷进干净的第二阶段,镜像能小一半以上。
- 「依赖文件」和「安装依赖」要放在 COPY . . 之前,这样只改业务代码时依赖层能命中缓存。
- 运行用户建议填非 root 账号(node、www-data 或自己建的),不填会有风险提示。
- 右侧复制 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。