Docker Node.js 开发环境配置指南

费念念Ross

于 2025-06-10 09:02:15 发布

阅读量273

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01086/article/details/148549123

Docker Node.js 开发环境配置指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

本文将详细介绍如何使用 Docker 容器为 Node.js 应用程序搭建完整的本地开发环境。通过容器化开发，您可以获得一致的开发环境、便捷的服务依赖管理以及高效的开发调试体验。

环境准备

在开始之前，请确保您已经完成了 Node.js 应用程序的容器化基础配置。这包括：

已创建基本的 Dockerfile
已配置 compose.yaml 文件
应用程序能够在容器中正常运行

开发环境搭建

1. 添加本地数据库与数据持久化

在开发过程中，我们通常需要本地数据库服务。使用 Docker Compose 可以轻松实现这一点。

配置数据库服务

修改 compose.yaml 文件，添加 PostgreSQL 服务配置：

services:
  server:
    # 原有配置...
    depends_on:
      db:
        condition: service_healthy
  db:
    image: postgres
    restart: always
    user: postgres
    secrets:
      - db-password
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=example
      - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
    healthcheck:
      test: ["CMD", "pg_isready"]
      interval: 10s
      timeout: 5s
      retries: 5
volumes:
  db-data:
secrets:
  db-password:
    file: db/password.txt

关键配置说明

数据卷(db-data)：确保数据库数据在容器重启后不会丢失
健康检查(healthcheck)：确保应用服务只在数据库就绪后启动
密码管理(secrets)：安全地管理数据库密码

实现步骤

创建 db/password.txt 文件并设置数据库密码
更新应用服务的环境变量，添加数据库连接配置
启动服务并验证数据持久化功能

2. 开发容器配置

为了提升开发效率，我们需要配置容器以支持热重载和代码即时更新。

多阶段 Dockerfile

使用多阶段构建同时支持开发和生产环境：

# 基础阶段
FROM node:18-alpine as base
WORKDIR /usr/src/app
EXPOSE 3000

# 开发阶段
FROM base as dev
RUN npm ci --include=dev
USER node
COPY . .
CMD npm run dev

# 生产阶段
FROM base as prod
RUN npm ci --omit=dev
USER node
COPY . .
CMD node src/index.js

开发模式 Compose 配置

更新 compose.yaml 以支持开发模式：

services:
  server:
    build:
      context: .
      target: dev
    ports:
      - 3000:3000
      - 9229:9229  # 调试端口
    volumes:
      - ./src:/usr/src/app/src  # 绑定挂载实现代码热更新