Docker 入门：从安装到部署的完整指南

Docker 让"在我机器上能跑"成为历史。这篇指南带你从零开始。

什么是 Docker？

简单说：Docker 把应用和它的环境打包成一个"容器"。无论在哪台机器上，这个容器都能跑。

传统部署 vs Docker：

传统：代码 → 服务器 → 安装依赖 → 配置环境 → 祈祷能跑
Docker：代码 + 环境 → 镜像 → 容器 → 一定能跑

快速安装

Ubuntu/Debian

# 一键安装
curl -fsSL https://get.docker.com | sh

# 启动 Docker
sudo systemctl start docker

# 设置开机自启
sudo systemctl enable docker

macOS

下载安装 Docker Desktop：https://docker.com/products/docker-desktop

Windows

同样下载 Docker Desktop，支持 WSL2 后端。

核心概念

镜像（Image）

镜像是模板，类似"安装包"。

# 拉取镜像
docker pull nginx:latest

# 查看本地镜像
docker images

# 删除镜像
docker rmi nginx:latest

容器（Container）

容器是运行中的镜像，类似"安装后的程序"。

# 运行容器
docker run -d -p 80:80 --name my-nginx nginx

# 查看运行中的容器
docker ps

# 查看全部容器
docker ps -a

# 停止容器
docker stop my-nginx

# 启动容器
docker start my-nginx

# 删除容器
docker rm my-nginx

Dockerfile

Dockerfile 是镜像的"配方"。

# 基础镜像
FROM python:3.11-slim

# 设置工作目录
WORKDIR /app

# 复制依赖文件
COPY requirements.txt .

# 安装依赖
RUN pip install -r requirements.txt

# 复制代码
COPY . .

# 暴露端口
EXPOSE 8000

# 启动命令
CMD ["python", "app.py"]

构建镜像

# 构建镜像
docker build -t my-app:1.0 .

# 查看构建历史
docker history my-app:1.0

实战：部署 Python 应用

1. 准备项目

my-app/
├── app.py
├── requirements.txt
└── Dockerfile

2. 编写 Dockerfile

FROM python:3.11-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

EXPOSE 8000

CMD ["python", "app.py"]

3. 构建并运行

# 构建
docker build -t my-app .

# 运行
docker run -d -p 8000:8000 --name my-app-container my-app

4. 查看日志

# 实时日志
docker logs -f my-app-container

# 查看最后 100 行
docker logs --tail 100 my-app-container

5. 进入容器

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

Docker Compose

多容器应用用 Compose 管理。

docker-compose.yml

version: "3.8"

services:
  web:
    build: .
    ports:
      - "8000:8000"
    depends_on:
      - db
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/mydb
  
  db:
    image: postgres:15
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=mydb
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

常用命令

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

# 停止所有服务
docker-compose down

# 查看日志
docker-compose logs -f

# 重启服务
docker-compose restart web

# 重建服务
docker-compose up -d --build

常用优化技巧

1. 减小镜像体积

# ❌ 体积大
FROM ubuntu:latest
RUN apt-get update && apt-get install -y python3

# ✅ 体积小
FROM python:3.11-slim

2. 利用缓存

# ❌ 每次变更代码都重新安装依赖
COPY . .
RUN pip install -r requirements.txt

# ✅ 依赖不变时用缓存
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .

3. 多阶段构建

# 构建阶段
FROM node:18 AS builder
WORKDIR /app
COPY . .
RUN npm run build

# 运行阶段
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

常见问题

容器无法启动

# 查看日志
docker logs <container-id>

# 进入调试
docker run -it --entrypoint /bin/bash <image>

端口冲突

# 查看端口占用
lsof -i :8000

# 映射到其他端口
docker run -p 8001:8000 <image>

数据丢失

# 使用数据卷
docker run -v /host/path:/container/path <image>

总结

Docker 学习路径：

1. 理解镜像和容器
2. 学会写 Dockerfile
3. 掌握 Compose 编排
4. 优化镜像体积和构建速度

容器化是现代开发的必备技能。花一个周末学习，受益整个职业生涯。