容器化已经成为现代应用部署的标准方式。这篇文章带你从零掌握 Docker。

为什么要用 Docker

在传统部署方式中,我们经常遇到「在我电脑上能跑」的问题。Docker 通过容器化技术彻底解决了这个烦恼。

容器 vs 虚拟机

很多人会拿容器和虚拟机做对比。实际上,它们有各自的优势场景。

特性容器虚拟机
启动速度秒级分钟级
资源消耗极小较大
隔离性进程级系统级
性能近原生有损耗

核心优势

  • 环境一致性:开发、测试、生产环境完全一致
  • 快速部署:秒级启动新实例
  • 资源隔离:应用之间相互独立,互不影响
  • 弹性扩展:根据负载动态扩缩容

Docker 安装与配置

在 macOS 上安装

# 使用 Homebrew 安装
brew install --cask docker

# 或者下载 Docker Desktop
# https://www.docker.com/products/docker-desktop

在 Linux 上安装

# Ubuntu/Debian
curl -fsSL https://get.docker.com | sh

# 启动 Docker 服务
sudo systemctl start docker
sudo systemctl enable docker

# 验证安装
docker --version

配置 Docker 镜像加速

国内访问 Docker Hub 较慢,建议配置镜像加速。

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

常用命令详解

镜像管理

# 拉取镜像
docker pull nginx:latest

# 查看本地镜像
docker images

# 构建自定义镜像
docker build -t my-app:1.0.0 .

# 删除镜像
docker rmi my-app:1.0.0

# 清理未使用的镜像
docker image prune -a

容器操作

# 运行容器(前台)
docker run -p 3000:3000 my-app

# 运行容器(后台守护态)
docker run -d -p 3000:3000 --name my-container my-app

# 查看运行中的容器
docker ps

# 查看所有容器(包括已停止)
docker ps -a

# 停止容器
docker stop my-container

# 启动已停止的容器
docker start my-container

# 重启容器
docker restart my-container

# 删除容器
docker rm my-container

# 查看容器日志
docker logs -f my-container

# 进入容器内部
docker exec -it my-container /bin/bash

数据管理

# 创建数据卷
docker volume create my-data

# 挂载数据卷
docker run -v my-data:/app/data my-app

# 挂载本地目录
docker run -v $(pwd):/app my-app

Dockerfile 最佳实践

基本结构

# 使用官方基础镜像
FROM node:20-alpine

# 设置工作目录
WORKDIR /app

# 复制依赖文件
COPY package*.json ./

# 安装依赖
RUN npm ci --only=production

# 复制应用代码
COPY . .

# 暴露端口
EXPOSE 3000

# 启动命令
CMD ["node", "server.js"]

多阶段构建

多阶段构建可以大幅减小镜像体积。

# 构建阶段
FROM node:20 AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# 运行阶段
FROM node:20-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/server.js"]

.dockerignore

避免把不需要的文件打包进镜像。

node_modules
.git
.env*
dist
*.log
.DS_Store

Docker Compose 多服务编排

Docker Compose 是 Docker 官方提供的多容器管理工具,特别适合开发、测试、部署多服务应用。

安装 Docker Compose

# Docker Desktop 自带 docker-compose
# Linux 安装
sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

快速开始

创建一个简单的 Web 应用,包含 Node.js 后端和 Redis 缓存。

# docker-compose.yml
version: '3.8'

services:
  web:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - REDIS_HOST=redis
    depends_on:
      - redis

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    volumes:
      - redis-data:/data

volumes:
  redis-data:

启动和管理

# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

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

# 停止服务
docker-compose down

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

# 扩展服务(负载均衡)
docker-compose up -d --scale web=3

常用命令速查

# 启动
docker-compose up -d

# 停止并移除容器
docker-compose down

# 查看状态
docker-compose ps

# 查看日志
docker-compose logs -f

# 执行命令
docker-compose exec web node --version

# 暂停/恢复
docker-compose pause/unpause

# 重启
docker-compose restart

实战:部署 Node.js + PostgreSQL 应用

项目结构

my-app/
├── docker-compose.yml
├── Dockerfile
├── src/
│   └── server.js
├── package.json
└── .dockerignore

Dockerfile

FROM node:20-alpine

WORKDIR /app

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

COPY src/ ./src/

EXPOSE 3000

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

docker-compose.yml

version: '3.8'

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:password@db:5432/myapp
      - NODE_ENV=production
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=myapp
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
      interval: 5s
      timeout: 5s
      retries: 5

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

volumes:
  postgres-data:

Nginx 配置

server {
    listen 80;
    server_name localhost;

    location / {
        proxy_pass http://app:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

生产环境注意事项

安全建议

# 不要使用 root 用户运行容器
services:
  app:
    user: "1000:1000"

# 限制资源使用
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 512M

# 保护敏感信息
# 使用 Docker Secrets 或环境变量

日志管理

services:
  app:
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

健康检查

services:
  app:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

常见问题排查

容器无法启动

# 查看详细日志
docker-compose logs service-name

# 检查端口占用
netstat -tlnp | grep 3000

# 检查镜像是否存在
docker images

网络连接问题

# 查看网络
docker network ls

# 检查容器网络
docker inspect container-name | grep Networks -A 10

磁盘空间不足

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

# 清理构建缓存
docker builder prune

# 查看磁盘使用
docker system df

总结

Docker 容器化部署已经成为了现代 DevOps 的标配技能。通过这篇文章,你应该已经掌握了:

  • Docker 的核心概念和优势
  • 常用命令的使用方法
  • Dockerfile 的编写技巧
  • Docker Compose 多服务编排
  • 生产环境的最佳实践

容器化让部署变得如此简单,你还在等什么?赶紧动手实践吧!