deep9/node-test

集成Node.js、PostgreSQL和Redis的Docker镜像文档

镜像概述

本Docker镜像为预配置的一站式开发与运行环境，集成了Node.js运行时、PostgreSQL关系型数据库和Redis缓存服务。旨在简化需要同时使用这三种组件的应用开发与部署流程，避免单独配置多个服务的复杂性，提供统一的服务管理和网络环境。

核心功能与特性

1. 组件集成

• Node.js：内置稳定版Node.js（如20.x LTS）及npm/yarn包管理器，支持ES模块和CommonJS
• PostgreSQL：预安装关系型数据库（如16.x稳定版），包含默认数据库和用户配置
• Redis：集成内存数据库缓存服务（如7.x稳定版），支持持久化配置

2. 预配置服务

• 自动启动PostgreSQL和Redis服务，无需手动管理进程
• 服务间通过本地网络通信（localhost访问），无需额外配置跨容器网络
• 内置服务健康检查，确保依赖组件正常运行

3. 开发效率优化

• 统一开发环境，减少"环境差异"导致的部署问题
• 支持代码热重载（需配合Node.js开发工具链）
• 简化多服务日志管理，统一输出至容器日志流

4. 可定制性

• 通过环境变量配置各服务核心参数（如数据库密码、Redis端口）
• 支持挂载外部配置文件覆盖默认设置
• 预留数据持久化目录，支持卷挂载保存数据

使用场景与适用范围

1. 开发与测试环境

• 快速搭建全栈应用开发环境（Node.js后端+PostgreSQL+Redis）
• 统一团队开发环境，避免"本地能运行，部署出问题"的情况
• 临时测试环境搭建，无需复杂的服务编排

2. 小型应用部署

• 资源受限环境下的一站式部署（如树莓派、个人服务器）
• 轻量级Web应用（如博客系统、小型管理系统）的生产环境
• 演示/原型系统部署，减少基础设施配置成本

3. 教学与演示

• 全栈开发教学案例（展示后端服务完整技术栈）
• 数据库与缓存结合使用的示例演示
• Docker多服务集成的实践教学

使用方法与配置说明

基本使用（docker run）

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/node-postgre-redis:latest

2. 基础启动命令

bash
docker run -d \
  -p 3000:3000 \  # Node.js应用端口
  -p 5432:5432 \  # PostgreSQL端口
  -p 6379:6379 \  # Redis端口
  --name node-fullstack \
  [镜像仓库地址]/node-postgre-redis:latest

3. 带数据持久化的启动

bash
docker run -d \
  -p 3000:3000 \
  -p 5432:5432 \
  -p 6379:6379 \
  -v postgres-data:/var/lib/postgresql/data \  # PostgreSQL数据持久化
  -v redis-data:/data \                       # Redis数据持久化
  -v ./app:/app \                             # 挂载Node.js应用代码
  --name node-fullstack \
  [镜像仓库地址]/node-postgre-redis:latest

环境变量配置

带环境变量的启动示例

bash
docker run -d \
  -p 3000:3000 -p 5432:5432 -p 6379:6379 \
  -e NODE_ENV=production \
  -e POSTGRES_PASSWORD=SecurePass123 \
  -e REDIS_PASSWORD=RedisPass456 \
  --name node-fullstack \
  docker.xuanyuan.run/[镜像仓库地址]/node-postgre-redis:latest

Docker Compose配置示例

yaml
version: '3.8'

services:
  app:
    image: docker.xuanyuan.run/[镜像仓库地址]/node-postgre-redis:latest
    ports:
      - "3000:3000"
      - "5432:5432"
      - "6379:6379"
    environment:
      - NODE_ENV=production
      - NODE_PORT=3000
      - POSTGRES_USER=appuser
      - POSTGRES_PASSWORD=apppass123
      - POSTGRES_DB=productiondb
      - REDIS_PASSWORD=redispass789
    volumes:
      - ./node-app:/app  # 挂载本地Node.js应用代码
      - postgres-data:/var/lib/postgresql/data
      - redis-data:/data
    restart: unless-stopped

volumes:
  postgres-data:
  redis-data:

服务访问说明

1. Node.js应用访问

• 容器内地址：http://localhost:${NODE_PORT}
• 宿主机访问：http://宿主机IP:映射端口（如http://localhost:3000）

2. PostgreSQL数据库访问

• 容器内连接：psql -U $POSTGRES_USER -d $POSTGRES_DB -h localhost -p $POSTGRES_PORT
• 宿主机连接：psql -U $POSTGRES_USER -d $POSTGRES_DB -h 宿主机IP -p 映射端口

3. Redis服务访问

• 容器内连接：redis-cli -h localhost -p $REDIS_PORT [-a $REDIS_PASSWORD]
• 宿主机连接：redis-cli -h 宿主机IP -p 映射端口 [-a $REDIS_PASSWORD]

注意事项

1. 生产环境建议：本镜像主要面向开发/测试环境，生产环境建议使用独立容器分别部署各服务，以便更好地进行资源隔离、扩展和故障恢复。

2. 数据安全：务必通过卷挂载（-v）持久化PostgreSQL和Redis数据，避免容器删除导致数据丢失。

3. 性能考量：单容器运行多服务会共享资源，高负载场景下可能出现性能瓶颈，建议根据应用规模评估是否需要拆分服务。

4. 安全加固：生产环境使用时必须修改默认密码（POSTGRES_PASSWORD、REDIS_PASSWORD），并限制端口暴露范围。