完整地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: 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 脚本：
#!/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 "=== 部署完成 ==="
使用方法：
chmod +x deploy.sh ./deploy.sh
该脚本功能：
- 停止并删除已有容器。
- 删除旧镜像。
- 构建新镜像。
- 启动容器并后台运行。
4. 构建与启动流程
假设当前在项目根目录 /opt/test/front-node/：
构建镜像：
docker compose build
启动容器（后台运行）：
docker compose up -d
查看容器状态：
docker ps
查看日志：
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 环境中，方便开发、测试与生产环境的快速迭代。
到此这篇关于完整地Docker化Node.js项目的部署流程的文章就介绍到这了,更多相关Docker化Node.js项目内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！