Docker部署Node.js应用教程：从入门到生产环境最佳实践

docker-deployment by pluginagentmarketplace/custom-plugin-nodejs

222 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/pluginagentmarketplace/custom-plugin-nodejs --skill docker-deployment

Node.js 自动化开发运维

🇨🇳中文介绍

Docker 部署技能

掌握使用 Docker 容器化并部署 Node.js 应用程序，以实现一致、可移植的部署。

快速开始

只需 3 步即可将 Node.js 应用 Docker 化：

创建 Dockerfile - 定义容器镜像
构建镜像 - docker build -t myapp .
运行容器 - docker run -p 3000:3000 myapp

核心概念

基础 Dockerfile

FROM node:18-alpine

WORKDIR /app

COPY package*.json ./
RUN npm ci --only=production

COPY . .

EXPOSE 3000

CMD ["node", "src/index.js"]

多阶段构建（优化版）

# 构建阶段
FROM node:18-alpine AS builder

WORKDIR /app

COPY package*.json ./
RUN npm ci --only=production

COPY . .

# 生产阶段
FROM node:18-alpine

WORKDIR /app

# 从构建阶段复制
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app .

# 创建非 root 用户
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001

USER nodejs

EXPOSE 3000

HEALTHCHECK --interval=30s --timeout=3s \
  CMD node healthcheck.js || exit 1

CMD ["node", "src/index.js"]

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

Docker Compose 命令

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f app

# 停止服务
docker-compose down

# 重新构建镜像
docker-compose up -d --build

# 扩展服务
docker-compose up -d --scale app=3

node_modules
npm-debug.log
.git
.gitignore
.env
.env.local
.vscode
*.md
tests
coverage
.github
Dockerfile
docker-compose.yml

# 构建镜像
docker build -t myapp:latest .

# 运行容器
docker run -d -p 3000:3000 --name myapp myapp:latest

# 查看日志
docker logs -f myapp

# 进入容器
docker exec -it myapp sh

# 停止容器
docker stop myapp

# 移除容器
docker rm myapp

# 列出镜像
docker images

# 移除镜像
docker rmi myapp:latest

# 清理未使用的资源
docker system prune -a

# 在 Dockerfile 中
ENV NODE_ENV=production
ENV PORT=3000

# 或在 docker-compose.yml 中
environment:
  - NODE_ENV=production
  - PORT=3000

# 或从 .env 文件加载
env_file:
  - .env.production

用于持久化的卷

services:
  app:
    volumes:
      - ./logs:/app/logs              # 绑定挂载
      - node_modules:/app/node_modules # 命名卷

volumes:
  node_modules:

# 在 Dockerfile 中
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s \
  CMD node healthcheck.js || exit 1



// healthcheck.js
const http = require('http');

const options = {
  host: 'localhost',
  port: 3000,
  path: '/health',
  timeout: 2000
};

const request = http.request(options, (res) => {
  console.log(`STATUS: ${res.statusCode}`);
  process.exit(res.statusCode === 200 ? 0 : 1);
});

request.on('error', (err) => {
  console.log('ERROR:', err);
  process.exit(1);
});

request.end();

# 使用 Alpine（更小的基础镜像）
FROM node:18-alpine  # 180MB vs node:18 (1GB)

# 多阶段构建（移除构建依赖）
# 使用 .dockerignore（排除不必要的文件）
# 使用 npm ci 而不是 npm install（更快，确定性）
# 仅安装生产依赖
RUN npm ci --only=production

# 合并 RUN 命令（减少层数）
RUN apk add --no-cache git && \
    npm ci && \
    apk del git

生产环境最佳实践

FROM node:18-alpine

# 不要以 root 身份运行
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001

WORKDIR /app

COPY --chown=nodejs:nodejs package*.json ./
RUN npm ci --only=production

COPY --chown=nodejs:nodejs . .

USER nodejs

# 健康检查
HEALTHCHECK CMD node healthcheck.js || exit 1

# 使用 node 而不是 npm start（更好的信号处理）
CMD ["node", "src/index.js"]

# 登录
docker login

# 标记镜像
docker tag myapp:latest username/myapp:1.0.0
docker tag myapp:latest username/myapp:latest

# 推送到 Docker Hub
docker push username/myapp:1.0.0
docker push username/myapp:latest

# 从 Docker Hub 拉取
docker pull username/myapp:latest

使用 GitHub Actions 进行 CI/CD

name: Docker Build & Deploy

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - uses: docker/setup-buildx-action@v2

      - uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - uses: docker/build-push-action@v4
        with:
          push: true
          tags: username/myapp:latest
          cache-from: type=gha
          cache-to: type=gha,mode=max

常见问题与解决方案

# 缓存 node_modules 层
COPY package*.json ./
RUN npm ci
COPY . .  # 这不会重建 node_modules

# 直接使用 node（而不是 npm）
CMD ["node", "src/index.js"]

# 在应用中：处理 SIGTERM
process.on('SIGTERM', () => {
  server.close(() => process.exit(0));
});

在以下情况下使用 Docker 部署：

需要一致的环境（开发、预发布、生产）
部署微服务
希望轻松扩展和编排
使用云平台（AWS、GCP、Azure）
实施 CI/CD 流水线

Express REST API（容器化 API）
数据库集成（多容器设置）
测试与调试（在容器中测试）
性能优化（优化镜像）

🇺🇸English

Docker Deployment Skill

Master containerizing and deploying Node.js applications with Docker for consistent, portable deployments.

Quick Start

Dockerize Node.js app in 3 steps:

Create Dockerfile - Define container image
Build Image - docker build -t myapp .
Run Container - docker run -p 3000:3000 myapp

Core Concepts

Basic Dockerfile

FROM node:18-alpine

WORKDIR /app

COPY package*.json ./
RUN npm ci --only=production

COPY . .

EXPOSE 3000

CMD ["node", "src/index.js"]

Multi-Stage Build (Optimized)

# Build stage
FROM node:18-alpine AS builder

WORKDIR /app

COPY package*.json ./
RUN npm ci --only=production

COPY . .

# Production stage
FROM node:18-alpine

WORKDIR /app

# Copy from builder
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app .

# Create non-root user
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001

USER nodejs

EXPOSE 3000

HEALTHCHECK --interval=30s --timeout=3s \
  CMD node healthcheck.js || exit 1

CMD ["node", "src/index.js"]

Learning Path

Beginner (1-2 weeks)

✅ Understand Docker basics
✅ Create simple Dockerfile
✅ Build and run containers
✅ Manage volumes and networks

Intermediate (3-4 weeks)

✅ Multi-stage builds
✅ Docker Compose
✅ Environment variables
✅ Health checks

Advanced (5-6 weeks)

✅ Image optimization
✅ Production best practices
✅ Container orchestration
✅ CI/CD integration

Docker Compose

# docker-compose.yml
version: '3.8'

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - DATABASE_URL=postgresql://db:5432/myapp
      - REDIS_URL=redis://redis:6379
    depends_on:
      - db
      - redis
    restart: unless-stopped

  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=myapp
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=myapp
    volumes:
      - postgres-data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      - app

volumes:
  postgres-data:
  redis-data:

Docker Compose Commands

# Start services
docker-compose up -d

# View logs
docker-compose logs -f app

# Stop services
docker-compose down

# Rebuild images
docker-compose up -d --build

# Scale services
docker-compose up -d --scale app=3

.dockerignore

node_modules
npm-debug.log
.git
.gitignore
.env
.env.local
.vscode
*.md
tests
coverage
.github
Dockerfile
docker-compose.yml

Docker Commands

# Build image
docker build -t myapp:latest .

# Run container
docker run -d -p 3000:3000 --name myapp myapp:latest

# View logs
docker logs -f myapp

# Enter container
docker exec -it myapp sh

# Stop container
docker stop myapp

# Remove container
docker rm myapp

# List images
docker images

# Remove image
docker rmi myapp:latest

# Prune unused resources
docker system prune -a

Environment Variables

# In Dockerfile
ENV NODE_ENV=production
ENV PORT=3000

# Or in docker-compose.yml
environment:
  - NODE_ENV=production
  - PORT=3000

# Or from .env file
env_file:
  - .env.production

Volumes for Persistence

services:
  app:
    volumes:
      - ./logs:/app/logs              # Bind mount
      - node_modules:/app/node_modules # Named volume

volumes:
  node_modules:

Health Checks

# In Dockerfile
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s \
  CMD node healthcheck.js || exit 1



// healthcheck.js
const http = require('http');

const options = {
  host: 'localhost',
  port: 3000,
  path: '/health',
  timeout: 2000
};

const request = http.request(options, (res) => {
  console.log(`STATUS: ${res.statusCode}`);
  process.exit(res.statusCode === 200 ? 0 : 1);
});

request.on('error', (err) => {
  console.log('ERROR:', err);
  process.exit(1);
});

request.end();

Image Optimization

# Use Alpine (smaller base image)
FROM node:18-alpine  # 180MB vs node:18 (1GB)

# Multi-stage build (remove build dependencies)
# Use .dockerignore (exclude unnecessary files)
# npm ci instead of npm install (faster, deterministic)
# Only production dependencies
RUN npm ci --only=production

# Combine RUN commands (fewer layers)
RUN apk add --no-cache git && \
    npm ci && \
    apk del git

Production Best Practices

FROM node:18-alpine

# Don't run as root
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001

WORKDIR /app

COPY --chown=nodejs:nodejs package*.json ./
RUN npm ci --only=production

COPY --chown=nodejs:nodejs . .

USER nodejs

# Health check
HEALTHCHECK CMD node healthcheck.js || exit 1

# Use node instead of npm start (better signal handling)
CMD ["node", "src/index.js"]

Docker Hub Deployment

# Login
docker login

# Tag image
docker tag myapp:latest username/myapp:1.0.0
docker tag myapp:latest username/myapp:latest

# Push to Docker Hub
docker push username/myapp:1.0.0
docker push username/myapp:latest

# Pull from Docker Hub
docker pull username/myapp:latest

CI/CD with GitHub Actions

name: Docker Build & Deploy

on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - uses: docker/setup-buildx-action@v2

      - uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - uses: docker/build-push-action@v4
        with:
          push: true
          tags: username/myapp:latest
          cache-from: type=gha
          cache-to: type=gha,mode=max

Common Issues & Solutions

Node modules caching

# Cache node_modules layer
COPY package*.json ./
RUN npm ci
COPY . .  # This doesn't rebuild node_modules

Signal handling

# Use node directly (not npm)
CMD ["node", "src/index.js"]

# In app: Handle SIGTERM
process.on('SIGTERM', () => {
  server.close(() => process.exit(0));
});

When to Use

Use Docker deployment when:

Need consistent environments (dev, staging, prod)
Deploying microservices
Want easy scaling and orchestration
Using cloud platforms (AWS, GCP, Azure)
Implementing CI/CD pipelines

Related Skills

Express REST API (containerize APIs)
Database Integration (multi-container setup)
Testing & Debugging (test in containers)
Performance Optimization (optimize images)

Resources

Weekly Installs

222

Repository

pluginagentmark…n-nodejs

GitHub Stars

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode202

gemini-cli195

codex189

cursor185

github-copilot181

claude-code159

Docker部署Node.js应用教程：从入门到生产环境最佳实践

🇨🇳中文介绍

Docker 部署技能

快速开始

核心概念

基础 Dockerfile

多阶段构建（优化版）

相关 Skills

学习路径

初级（1-2 周）

中级（3-4 周）

高级（5-6 周）

Docker Compose

Docker Compose 命令

.dockerignore

Docker 命令

环境变量

用于持久化的卷

健康检查

镜像优化

生产环境最佳实践

Docker Hub 部署

使用 GitHub Actions 进行 CI/CD

常见问题与解决方案

Node 模块缓存

信号处理

何时使用

相关技能

资源

🇺🇸English

Docker Deployment Skill

Quick Start

Core Concepts

Basic Dockerfile

Multi-Stage Build (Optimized)

Learning Path

Beginner (1-2 weeks)

Intermediate (3-4 weeks)

Advanced (5-6 weeks)

Docker Compose

Docker Compose Commands

.dockerignore

Docker Commands

Environment Variables

Volumes for Persistence

Health Checks

Image Optimization

Production Best Practices

Docker Hub Deployment

CI/CD with GitHub Actions

Common Issues & Solutions

Node modules caching

Signal handling

When to Use

Related Skills

Resources

最新 Skills