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

 更新时间:2025年10月31日 08:43:56   作者:代码怪兽大大作战  
在现代微服务架构中,将 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项目内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 浅谈Node.js ORM框架Sequlize之表间关系

    浅谈Node.js ORM框架Sequlize之表间关系

    下面小编就为大家带来一篇浅谈Node.js ORM框架Sequlize之表间关系。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-07-07
  • 使用GruntJS构建Web程序之Tasks(任务)篇

    使用GruntJS构建Web程序之Tasks(任务)篇

    任务(Tasks)是grunt的核心概念,你所做的很多工作比如资源合并(concat)、压缩(uglify)都是在配置任务。 每次grunt运行的时候,你指定的一个或多个任务也在运行,如果你没有指定任务,那么一个默认名为“default”的任务将自动运行。
    2014-06-06
  • NodeJS远程代码执行

    NodeJS远程代码执行

    这篇文章主要介绍了NodeJS远程代码执行方法的相关资料,需要的朋友可以参考下
    2016-08-08
  • 前端+nodejs+mysql实现前后端联通的完整代码

    前端+nodejs+mysql实现前后端联通的完整代码

    Node.js主要属于后端技术,但也可以用于前端开发的某些场景,下面这篇文章主要介绍了前端+nodejs+mysql实现前后端联通的完整代码,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-04-04
  • Nodejs抓取html页面内容(推荐)

    Nodejs抓取html页面内容(推荐)

    这篇文章主要介绍了Nodejs抓取html页面内容的关键代码,另外还给大家附上了nodejs抓取网页内容,非常不错,对node.js抓取页面内容感兴趣的朋友一起学习吧
    2016-08-08
  • nodejs个人博客开发第七步 后台登陆

    nodejs个人博客开发第七步 后台登陆

    这篇文章主要为大家详细介绍了nodejs个人博客开发的后台登陆功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-04-04
  • koa+mongoose实现简单增删改查接口的示例代码

    koa+mongoose实现简单增删改查接口的示例代码

    这篇文章主要介绍了koa+mongoose实现简单增删改查接口的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-05-05
  • node中间层实现文件上传功能

    node中间层实现文件上传功能

    这篇文章主要介绍了node中间层实现文件上传功能,本文给大家介绍的非常详细,需要的朋友可以参考下
    2018-06-06
  • 实例分析nodejs模块xml2js解析xml过程中遇到的坑

    实例分析nodejs模块xml2js解析xml过程中遇到的坑

    这篇文章主要介绍了实例分析nodejs模块xml2js解析xml过程中遇到的坑,涉及nodejs模块xml2js解析xml过程中parseString方法参数使用技巧,需要的朋友可以参考下
    2017-03-03
  • 解决node-webkit 不支持html5播放mp4视频的方法

    解决node-webkit 不支持html5播放mp4视频的方法

    本文给大家分享的是解决node-webkit 不支持html5播放mp4视频的方法,其原因大概是因为node-webkit没有购买mp4格式的专利授权,恩,我们来想个办法来解决这个事情吧。
    2015-03-03

最新评论