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

[1. Dockerfile](#1. Dockerfile)
[2. docker-compose.yml](#2. docker-compose.yml)
[3. 一键部署脚本 deploy.sh](#3. 一键部署脚本 deploy.sh)
[4. 构建与启动流程](#4. 构建与启动流程)
[5. 特点与优势](#5. 特点与优势)
[6. 总结](#6. 总结)

在现代微服务架构中，将 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 镜像的核心文件，示例如下：

dockerfile 复制代码

# 使用官方 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 用于管理容器和卷映射，示例：

yaml 复制代码

version: "3.9"

services:
  front-node:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: test-node
    restart: always
    ports:
      - "3001:3001"
    environment:
      - NODE_ENV=production
    working_dir: /usr/src/app
    command: ["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 脚本：

bash 复制代码

#!/bin/bash

WORKDIR="/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; then
    docker stop "$CONTAINER_NAME"
    docker rm "$CONTAINER_NAME"
    echo "容器 $CONTAINER_NAME 已停止并删除"
else
    echo "容器 $CONTAINER_NAME 不存在"
fi

echo "=== 删除旧镜像 ==="
if docker images --format '{{.Repository}}:{{.Tag}}' | grep -w "$IMAGE_NAME" > /dev/null; then
    docker rmi "$IMAGE_NAME" -f
    echo "镜像 $IMAGE_NAME 已删除"
else
    echo "镜像 $IMAGE_NAME 不存在"
fi

echo "=== 构建新镜像并启动容器 ==="
docker compose build
docker compose up -d

echo "=== 部署完成 ==="

使用方法：

bash 复制代码

chmod +x deploy.sh
./deploy.sh

该脚本功能：

停止并删除已有容器。
删除旧镜像。
构建新镜像。
启动容器并后台运行。

4. 构建与启动流程

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

构建镜像：
bash 复制代码
```
docker compose build
```
启动容器（后台运行）：
bash 复制代码
```
docker compose up -d
```
查看容器状态：
bash 复制代码
```
docker ps
```
查看日志：
bash 复制代码
```
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 环境中，方便开发、测试与生产环境的快速迭代。