快捷導(dǎo)航

完整地Docker化Node.js項目的部署流程

更新時間：2025年10月31日 08:43:56 作者：代碼怪獸大大作戰(zhàn)

在現(xiàn)代微服務(wù)架構(gòu)中,將 Node.js 應(yīng)用容器化可以方便部署、管理和擴展,本文將展示如何完整地 Docker 化 Node.js 項目,并提供一個一鍵部署腳本,需要的朋友可以參考下

1. Dockerfile

Dockerfile 是構(gòu)建 Node.js 鏡像的核心文件，示例如下：

# 使用官方 Node 20 運行時
FROM node:20-alpine

# 設(shè)置工作目錄
WORKDIR /usr/src/app

# 復(fù)制依賴文件
COPY node/package*.json ./

# 安裝依賴
RUN npm install --omit=dev && \
    addgroup -S appgroup && adduser -S appuser -G appgroup

# 切換用戶，避免使用 root
USER appuser

# 暴露應(yīng)用端口
EXPOSE 3001

# 啟動命令
CMD ["npm", "run", "start"]

說明：

node:20-alpine：輕量化 Node 20 官方鏡像。
WORKDIR /usr/src/app：容器內(nèi)部工作目錄。
COPY node/package*.json ./：只復(fù)制依賴文件進行安裝，提升緩存效率。
npm install --omit=dev：僅安裝生產(chǎn)依賴。
USER appuser：降低安全風(fēng)險，不以 root 運行。
EXPOSE 3000：暴露端口供外部訪問。
CMD ["npm", "run", "start"]：默認啟動應(yīng)用。

2. docker-compose.yml

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

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：映射本地項目目錄到容器，同時保留容器內(nèi) node_modules。
restart: always：容器異常退出后自動重啟。

3. 一鍵部署腳本 deploy.sh

為了方便構(gòu)建、啟動和更新容器，我們可以寫一個 deploy 腳本：

#!/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 "=== 構(gòu)建新鏡像并啟動容器 ==="
docker compose build
docker compose up -d

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

使用方法：