Dockerfile从零入门：手把手教你打包Node.js应用，解决镜像构建的常见坑

代码写完了，在本地跑得好好的，怎么把它打包成Docker镜像，部署到服务器上？

答案就是Dockerfile。

今天这篇文章，我们用Node.js应用做例子，从零开始写一个Dockerfile，把应用打包成镜像，顺便把常见的坑都踩一遍。

一、Dockerfile是什么？

Dockerfile是一个文本文件，里面写着“如何构建这个镜像”的所有指令。它就像一张蓝图，Docker按照这张蓝图把应用打包成镜像。

重要：文件名必须叫Dockerfile，首字母大写，没有后缀名。

二、写一个最简单的Dockerfile

我们的Node.js应用需要运行在Node环境里，所以第一件事是找一个带Node的基础镜像：

dockerfile

FROM node:20-alpine

FROM是所有Dockerfile的第一行，指定基础镜像。这里用了node:20-alpine——一个轻量级的Node镜像，体积小，适合生产环境。

三、复制代码并安装依赖

把代码复制进镜像，然后安装依赖：

dockerfile

# 创建应用目录 RUN mkdir -p /home/app # 复制所有文件 COPY . /home/app # 设置工作目录 WORKDIR /home/app # 安装依赖 RUN npm install

注意几点：

• RUN是在构建镜像时执行的命令

• COPY是从宿主机复制文件到镜像里

• WORKDIR设置工作目录，后面的命令都会在这个目录下执行

一个常见错误：不要把本地的node_modules复制进镜像。因为本地依赖可能是旧版本，应该在镜像里重新npm install，保证依赖是最新的。

四、指定启动命令

最后，告诉容器启动时运行什么：

dockerfile

CMD ["node", "server.js"]

CMD是容器启动时执行的命令。一个Dockerfile只能有一个CMD。

完整的Dockerfile：

dockerfile

FROM node:20-alpine ENV MONGO_DB_USERNAME=admin \ MONGO_DB_PWD=password RUN mkdir -p /home/app COPY . /home/app WORKDIR /home/app RUN npm install CMD ["node", "server.js"]

五、构建镜像

在Dockerfile所在目录执行：

bash

docker build -t my-app:1.0 .

• -t my-app:1.0：给镜像起名字和版本号

• .：Dockerfile所在的路径（当前目录）

构建完成，用docker images就能看到新镜像。

六、运行容器

bash

docker run my-app:1.0

如果一切正常，你会看到app listening on port 3000!。如果报错，用docker logs查看日志。

七、踩坑与解决

坑1：找不到server.js

现象：启动容器报错Error: Cannot find module '/server.js'。

原因：没有设置WORKDIR，CMD里的相对路径找不到文件。

解决：加上WORKDIR /home/app。

坑2：进入容器报错bash: not found

现象：docker exec -it <容器ID> /bin/bash报错。

原因：Alpine基础镜像没有安装bash。

解决：用/bin/sh代替/bin/bash。

bash

docker exec -it <容器ID> /bin/sh

坑3：修改Dockerfile后镜像没变

现象：改了Dockerfile，重新构建后还是老样子。

原因：Docker不会自动删除旧镜像，你还在用旧的。

解决：先删旧容器，再删旧镜像，最后重新构建。

bash

# 查看所有容器（包括已停止的） docker ps -a # 删除旧容器 docker rm <容器ID> # 删除旧镜像 docker rmi my-app:1.0 # 重新构建 docker build -t my-app:1.0 .

八、优化：只复制需要的文件

上面的例子把整个项目目录都复制进了镜像，包括Dockerfile、README等不需要的文件。可以这样优化：

dockerfile

# 只复制app目录下的文件 COPY ./app /home/app

或者用.dockerignore文件排除不需要的文件，类似.gitignore。

写在最后

Dockerfile的核心就几条指令：FROM选基础镜像，COPY复制代码，RUN装依赖，CMD定启动命令。

记住几个关键点：

• 文件名必须是Dockerfile

• RUN是构建时执行，CMD是启动时执行

• 修改Dockerfile后要先删旧镜像再重新构建

• 轻量镜像用/bin/sh而不是/bin/bash

掌握了这些，你就能把任何应用打包成Docker镜像了。