Docker 化 Node.js 项目完整部署流程

---

在现代微服务架构中，将 Node.js 应用容器化可以方便部署、管理和扩展。本文将展示如何完整地 Docker 化 Node.js 项目，并提供一个一键部署脚本。

假设Node.js 项目结构如下：

/opt/test/front-node/
├── node/
│   ├── src/
│   ├── package.json
│   ├── pnpm-lock.yaml
│   ├── assets/
│   └── test.js
└── Dockerfile
└── docker-compose.yml
└── deploy.sh

---

1. Dockerfile

Dockerfile 是构建 Node.js 镜像的核心文件，示例如下：

# 使用官方 Node 20 运行时
FROM node:20-alpine# 设置工作目录
WORKDIR /usr/src/app# 复制依赖文件
COPY node/package*.json ./# 安装依赖
RUN npm install --omit=dev && \addgroup -S appgroup && adduser -S appuser -G appgroup# 切换用户，避免使用 root
USER appuser# 暴露应用端口
EXPOSE 3001# 启动命令
CMD ["npm", "run", "start"]

说明：

• node:20-alpine：轻量化 Node 20 官方镜像。

• WORKDIR /usr/src/app：容器内部工作目录。

• COPY node/package*.json ./：只复制依赖文件进行安装，提升缓存效率。

• npm install --omit=dev：仅安装生产依赖。

• USER appuser：降低安全风险，不以 root 运行。

• EXPOSE 3000：暴露端口供外部访问。

• CMD ["npm", "run", "start"]：默认启动应用。

---

2. docker-compose.yml

docker-compose 用于管理容器和卷映射，示例：

version: "3.9"services:front-node:build:context: .dockerfile: Dockerfilecontainer_name: test-noderestart: alwaysports:- "3001:3001"environment:- NODE_ENV=productionworking_dir: /usr/src/appcommand: ["npm", "run", "start"]volumes:# 映射整个项目文件夹，方便热更新- ./node:/usr/src/app# 防止 node_modules 被宿主机覆盖- /usr/src/app/node_modules

说明：

• container_name：容器命名为 test-node。

• volumes：映射本地项目目录到容器，同时保留容器内 node_modules。

• restart: always：容器异常退出后自动重启。

---

3. 一键部署脚本 deploy.sh

为了方便构建、启动和更新容器，我们可以写一个 deploy 脚本：

#!/bin/bashWORKDIR="/opt/test/front-node"
CONTAINER_NAME="test-node"
IMAGE_NAME="test-node:latest"cd "$WORKDIR" || { echo "工作目录不存在: $WORKDIR"; exit 1; }echo "=== 检查并停止已有容器 ==="
if docker ps -a --format '{{.Names}}' | grep -w "$CONTAINER_NAME" > /dev/null; thendocker stop "$CONTAINER_NAME"docker rm "$CONTAINER_NAME"echo "容器 $CONTAINER_NAME 已停止并删除"
elseecho "容器 $CONTAINER_NAME 不存在"
fiecho "=== 删除旧镜像 ==="
if docker images --format '{{.Repository}}:{{.Tag}}' | grep -w "$IMAGE_NAME" > /dev/null; thendocker rmi "$IMAGE_NAME" -fecho "镜像 $IMAGE_NAME 已删除"
elseecho "镜像 $IMAGE_NAME 不存在"
fiecho "=== 构建新镜像并启动容器 ==="
docker compose build
docker compose up -decho "=== 部署完成 ==="

使用方法：

chmod +x deploy.sh
./deploy.sh

该脚本功能：

1. 停止并删除已有容器。

2. 删除旧镜像。

3. 构建新镜像。

4. 启动容器并后台运行。

---

4. 构建与启动流程

假设当前在项目根目录 /opt/test/front-node/：

1. 构建镜像：

   docker compose build
   

2. 启动容器（后台运行）：

   docker compose up -d
   

3. 查看容器状态：

   docker ps
   

4. 查看日志：

   docker logs -f test-node
   

现在， Node.js 服务已经在 Docker 容器中运行，并映射到宿主机 3001 端口。

---

5. 特点与优势

• 安全：容器使用非 root 用户。

• 自动重启：容器异常退出会自动重启。

• 热更新：本地项目目录映射到容器，可直接修改代码。

• 可重复部署：deploy.sh 一键完成更新与启动。

• 轻量：使用 Alpine Node 镜像减少镜像体积。

---

6. 总结

Node.js 应用完整 Docker 化流程，包括：

• Dockerfile 编写

• docker-compose.yml 配置

• 容器和镜像管理

• 一键部署脚本

通过这种方式，Node.js 应用可以安全、稳定地部署在 Docker 环境中，方便开发、测试与生产环境的快速迭代。

---