Node.js项目在Linux上如何实现容器化部署

在Linux环境下，把Node.js项目打包成容器部署，现在基本已经成为标配操作了。Docker是这其中最常用的工具，没有之一。整个过程其实并不复杂，只要把关键步骤捋清楚，哪怕是第一次接触，也能较快上手。

1. 安装Docker

首先得确认你的Linux系统里已经装好了Docker。不同发行版的安装命令稍有差异，但都是几行指令的事情。

在Ubuntu上安装Docker

sudo apt update
sudo apt install docker.io

在CentOS上安装Docker

sudo yum install -y docker
sudo systemctl start docker
sudo systemctl enable docker

装完之后可以跑个docker --version验证一下，确保环境就绪。

2. 创建Dockerfile

这是整条链路的核心文件——告诉Docker怎么构建你的应用镜像。在项目根目录下新建一个名为Dockerfile的文件，内容大概长这样：

# 使用官方Node.js运行时镜像作为基础镜像
FROM node:14

# 设置工作目录
WORKDIR /usr/src/app

# 将package.json和package-lock.json复制到工作目录
COPY package*.json ./

# 安装项目依赖
RUN npm install

# 将项目文件复制到工作目录
COPY . .

# 暴露端口
EXPOSE 3000

# 启动应用
CMD ["node", "app.js"]

这里有几个细节值得注意：COPY package*.json ./ 放在 COPY . . 之前，是为了利用Docker的分层缓存机制——如果依赖没有变化，这一步就不会重新安装，能大幅节省构建时间。另外，基础镜像版本可以根据项目实际使用的Node版本来调整，比如 node:18 或 node:20。

3. 构建Docker镜像

在项目根目录下执行构建命令，给镜像取个名字方便后续引用：

docker build -t my-node-app .

这里的 -t my-node-app 就是镜像标签（tag），你可以换成任何有意义的名称。末尾的点表示构建上下文为当前目录。

4. 运行Docker容器

镜像构建成功后，用一行命令就能把应用跑起来：

docker run -p 3000:3000 my-node-app

-p 3000:3000 的意思是将宿主机的3000端口映射到容器内的3000端口。如果你的应用监听的是其他端口，记得对应修改。

5. 验证部署

打开浏览器，访问 http://<你的服务器IP>:3000，如果看到应用正常响应，说明容器化部署已经成功了。

6. 使用Docker Compose（可选）

当项目涉及多个服务（比如前端+后端+数据库）时，手动一个个跑容器就显得笨重了。这时候Docker Compose就能派上用场。在项目根目录创建 docker-compose.yml：

version: '3'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules

然后一句命令启动所有服务：

docker-compose up

这个配置里还顺带做了目录映射（volumes），方便开发阶段修改代码后实时生效，而无需重新构建镜像。但需要注意把 node_modules 排除掉，避免宿主机与容器内的依赖冲突。

7. 持久化数据（可选）

如果应用需要写入数据并希望容器重启后不丢失，就得用Docker卷来管理。比如下面这个扩展后的docker-compose.yml：

version: '3'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules
      - data:/usr/src/app/data
volumes:
  data:

这样应用写入 /usr/src/app/data 的数据就会持久化存储在宿主机上，即使容器被删除，数据也不会丢失。

以上这七个步骤，基本覆盖了从零开始把Node.js项目容器化并部署到Linux上的主流做法。实际项目中可能还会涉及环境变量管理、日志收集、健康检查等进阶内容，但核心框架就是这么简单。