目录

Docker 入门与实践

Docker 是目前最主流的容器化工具:把应用和它的运行环境一起打包成一个「盒子」,在任何装好 Docker 的机器上用同样的方式运行。

本页按「是什么 → 怎么装 → 核心概念 → 常用命令 → 构建镜像 → 编排 → 实际部署 → 运维排错」的顺序组织,可以按需跳读。

一、Docker 是什么

一句话:Docker 把「程序和它的运行环境」打包成镜像,用容器的方式隔离运行。

传统的痛点是「在我机器上是好的」:Python 版本、系统库、环境变量、依赖版本对不上,换台机器就跑不起来。Docker 把这些东西一起固化进镜像,运行环境随程序走。

容器和虚拟机的区别

对比项 虚拟机(VM) Docker 容器
隔离方式 硬件虚拟化,每台跑一个完整操作系统 共享宿主机内核,进程级隔离
启动速度 分钟级 毫秒到秒级
资源开销 每台通常几 GB 内存 通常几十 MB
体积 镜像常见 GB 级 常见几十 MB 到几百 MB
隔离强度 强(各自独立内核) 较弱(共用内核,安全边界不如 VM)

结论:容器不是轻量虚拟机,它就是一个被限制了视野的进程。

三个核心概念

配套的两个概念:

它一般用来做什么

二、安装与环境准备

Linux(以 Ubuntu / Debian 为例)

推荐用官方 apt 仓库安装,这样能跟着系统一起升级:

sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo $VERSION_CODENAME) stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

只想在个人测试机上快速装完,也可以执行官方一键脚本(不适合生产环境):

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

验证安装

docker version          # 客户端 + 服务端版本
docker info             # 服务端详情:存储驱动、镜像数、根目录
docker run hello-world  # 跑一个最小镜像,能输出提示就说明通了

免 sudo 使用

sudo usermod -aG docker $USER
# 重新登录(或 newgrp docker)后生效

注意:加入 docker 组等于给了这台机器的 root 权限,生产服务器上要谨慎。

配置国内镜像加速与日志上限

编辑 /etc/docker/daemon.json 这个文件:

{
  "registry-mirrors": ["https://docker.m.daocloud.io"],
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" }
}

改完用 sudo systemctl restart docker 重启服务。日志上限很重要,否则容器日志会把磁盘写满。

Docker Desktop(Windows / macOS)

Windows 和 macOS 没有 Linux 内核,官方给出的图形化方案是 Docker Desktop:它内置了 Docker Engine、CLI、Compose、Buildx,还带一个可选的单节点 Kubernetes。

安装步骤(Windows 为例):

界面里几个主要页面:

页面 用途
Containers 查看和启停容器;点进去能看日志(Logs)、进终端(Exec)、浏览容器内文件(Files)
Images 本地镜像列表,可以直接 Run 成容器,也能 Pull 新镜像
Volumes / Builds 管理数据卷、查看构建历史与缓存
Settings 资源分配、镜像加速、文件共享、Kubernetes 开关

常用操作:

几个容易踩的坑:

在 Docker Desktop 的终端里,本页后面所有命令都能直接执行,用法与 Linux 完全一致。

三、架构与工作原理

Docker 采用客户端/服务端架构:

镜像采用分层存储:Dockerfile 里每条构建指令生成一层,层可以被多个镜像共享。容器启动时在镜像最上面加一个可写层,所有修改都写在这层里,因此:

四、常用命令速查

镜像

docker pull nginx:1.27-alpine     # 下载镜像,不写 tag 默认 latest(不建议)
docker images                     # 列出本地镜像
docker image inspect nginx:1.27   # 查看镜像详情
docker rmi nginx:1.27             # 删除镜像
docker tag myapp:1.0 registry.example.com/myapp:1.0
docker push registry.example.com/myapp:1.0

容器

docker run -d --name web -p 8080:80 nginx:1.27-alpine   # 后台运行并映射端口
docker run -it --rm ubuntu:22.04 bash                   # 交互式临时容器,退出即删
docker ps                       # 运行中的容器
docker ps -a                    # 包括已停止的
docker logs -f --tail 100 web   # 跟踪日志
docker exec -it web sh          # 进入容器
docker stop web / docker start web / docker restart web
docker rm web                   # 删除容器(先 stop)
docker cp web:/etc/nginx/nginx.conf ./nginx.conf
docker inspect web              # 完整信息(JSON)
docker stats                    # 实时资源占用

端口映射的写法是 -p 宿主机端口:容器端口 ,比如 8080:80 表示访问宿主机 8080 就打到容器里的 80。

卷与网络

docker volume create app-data
docker volume ls
docker network create appnet
docker network ls

清理(会删数据,执行前确认)

docker system df                # 先看看占了多少
docker system prune             # 清理停止的容器、悬空镜像、未用网络
docker system prune -a --volumes  # 更彻底,慎用

五、构建镜像:Dockerfile

Dockerfile 是构建镜像的说明书。一个 Node.js 服务的例子:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
ENV NODE_ENV=production
EXPOSE 3000
USER node
CMD ["node", "server.js"]

构建并运行:

docker build -t myapp:1.0 .
docker run -d --name myapp -p 3000:3000 myapp:1.0

常用指令

指令 作用
FROM 基础镜像,必须是第一条有效指令
WORKDIR 设置后续指令的工作目录
COPY 从构建上下文拷贝文件进镜像
ADD 类似 COPY,还能解压 tar、拉远程 URL(一般优先用 COPY)
RUN 构建时执行命令,结果固化进镜像层
ENV 设置镜像内的环境变量(运行时可被覆盖)
ARG 构建期参数,只在构建时可见
EXPOSE 声明监听端口,只是文档性质,不发布端口
VOLUME 声明匿名数据卷挂载点
USER 切换运行用户,避免用 root
HEALTHCHECK 定义健康检查命令
CMD 容器启动的默认命令,可被 docker run 后面的参数覆盖
ENTRYPOINT 容器入口,不易被覆盖,常配合 CMD 传默认参数

多阶段构建

把编译环境和运行环境分开,最终镜像只留运行需要的文件:

FROM golang:1.22 AS builder
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o /out/app ./cmd/app
 
FROM gcr.io/distroless/static
COPY --from=builder /out/app /app
ENTRYPOINT ["/app"]

利用缓存的三个技巧

node_modules
.git
.env
dist
*.log

六、数据持久化与网络

数据卷 vs 绑定挂载

方式 写法 典型场景
具名卷 -v app-data:/var/lib/postgresql/data 数据库等需要长期保存的数据,由 Docker 管理
绑定挂载 -v /srv/app/logs:/app/logs 需要直接在宿主机上查看或编辑的文件(配置、日志)
匿名卷 只写容器内路径 临时使用,不推荐依赖

一句话原则:容器里只放代码,数据一律放卷或挂载目录。

网络

docker network create appnet
docker run -d --name api --network appnet myapp:1.0
docker run -d --name db --network appnet postgres:16-alpine

要点:

七、部署 MySQL 与 Redis

有状态服务是最常自建的一类,套路基本一致:官方镜像 + 数据卷 + 环境变量初始化 + 只对内网暴露端口。

MySQL

最小可用的启动命令:

docker run -d --name mysql \
  -e MYSQL_ROOT_PASSWORD=换成强密码 \
  -e MYSQL_DATABASE=app \
  -e MYSQL_USER=app \
  -e MYSQL_PASSWORD=换成强密码 \
  -e TZ=Asia/Shanghai \
  -p 127.0.0.1:3306:3306 \
  -v mysql-data:/var/lib/mysql \
  --restart unless-stopped \
  mysql:8.4

几个关键点:

进去验证:

docker exec -it mysql mysql -uroot -p
# 输入密码后
SHOW DATABASES;

初始化建表脚本:把 sql 文件挂到镜像约定的目录,首次启动会自动执行。

docker run -d --name mysql \
  -e MYSQL_ROOT_PASSWORD=换成强密码 \
  -v mysql-data:/var/lib/mysql \
  -v /srv/mysql/init:/docker-entrypoint-initdb.d:ro \
  mysql:8.4

注意:init 脚本只在数据目录为空的第一次启动时执行,之后放进去不会跑;想重跑得换一个新卷。

用 Compose 管理

services:
  mysql:
    image: mysql:8.4
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: app
      MYSQL_USER: app
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
      TZ: Asia/Shanghai
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
    ports:
      - "127.0.0.1:3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1"]
      interval: 10s
      timeout: 5s
      retries: 10

volumes:
  mysql-data:

应用连接时,主机名写服务名 mysql (在同一个 Compose 网络里),不要写 localhost 。

备份与恢复

# 备份
docker exec mysql sh -c 'exec mysqldump -uroot -p"$MYSQL_ROOT_PASSWORD" app' \
  | gzip > /srv/backup/app-$(date +%F).sql.gz
 
# 恢复
gunzip < /srv/backup/app-2026-01-01.sql.gz \
  | docker exec -i mysql sh -c 'exec mysql -uroot -p"$MYSQL_ROOT_PASSWORD" app'

Redis

docker run -d --name redis \
  -p 127.0.0.1:6379:6379 \
  -v redis-data:/data \
  --restart unless-stopped \
  redis:7-alpine \
  redis-server --appendonly yes --requirepass 换成强密码

几个关键点:

连接测试:

docker exec -it redis redis-cli -a 换成强密码
> PING
PONG

用 Compose 管理

services:
  redis:
    image: redis:7-alpine
    restart: unless-stopped
    command:
      - redis-server
      - --appendonly
      - "yes"
      - --requirepass
      - ${REDIS_PASSWORD}
      - --maxmemory
      - 512mb
      - --maxmemory-policy
      - allkeys-lru
    ports:
      - "127.0.0.1:6379:6379"
    volumes:
      - redis-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "PING"]
      interval: 10s
      timeout: 3s
      retries: 5

volumes:
  redis-data:

想用配置文件,可以把 redis.conf 挂到 /usr/local/etc/redis/redis.conf ,启动命令改成 redis-server /usr/local/etc/redis/redis.conf 。

常见问题

现象 处理
应用连不上这两个服务 确认在同一网络里;主机名写服务名,不要写 localhost
容器起来就退出 多半缺必需的环境变量(MySQL 的 root 密码、Redis 的密码),看 docker logs
数据不见了 没挂卷,或者容器内路径写错了(MySQL 是 /var/lib/mysql ,Redis 是 /data )
中文乱码 MySQL 启动参数加上 utf8mb4 相关设置
宿主机内存被打满 Redis 设 maxmemory 和淘汰策略,容器也可加内存限制

一点提醒:本地开发用 Docker 跑 MySQL、Redis 非常方便,但生产环境这类有状态服务,优先考虑云数据库或托管服务;自建的话,备份、监控和内存上限一个都别省。

八、Docker Compose 编排

一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 Compose 把配置写进 compose.yaml ,一条命令起停整套。

services:
  web:
    build: .
    ports:
      - "8080:3000"
    environment:
      DATABASE_URL: postgres://app:secret@db:5432/app
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: app
    volumes:
      - db-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U app"]
      interval: 5s
      timeout: 3s
      retries: 10

volumes:
  db-data:

常用命令:

docker compose up -d          # 后台启动整套
docker compose up -d --build  # 重新构建镜像再启动
docker compose ps             # 查看状态
docker compose logs -f web    # 看某个服务的日志
docker compose exec web sh    # 进某个服务
docker compose restart web    # 重启单个服务
docker compose down           # 停止并删除容器(卷默认保留)
docker compose config         # 检查配置是否正确

旧的 docker-compose (带连字符)是 v1,已停止维护;现在统一用 v2 插件形式 docker compose 。

restart 策略值得记住:no 、always 、on-failure 、unless-stopped 。生产环境一般用 unless-stopped ,机器重启后服务能自动回来。

九、实战:部署一个 Web 应用

下面是最常见的一套流程:一台云服务器 + 域名 + 应用容器 + 数据库容器 + Nginx 反向代理 + HTTPS。

1. 准备服务器

2. 放置项目

sudo mkdir -p /srv/myapp && cd /srv/myapp
# 上传代码,或 git clone 仓库

目录结构大致是:

/srv/myapp
├── compose.yaml
├── Dockerfile
├── .env
└── src/

3. 用 .env 管理密码

POSTGRES_PASSWORD=换成你的强密码
DATABASE_URL=postgres://app:换成你的强密码@db:5432/app

.env 要放到 compose.yaml 同级目录,并在 compose.yaml 里用 ${POSTGRES_PASSWORD} 引用。凭据绝不写进镜像,也不提交到 Git。

4. 启动

docker compose up -d --build
docker compose ps
docker compose logs -f

看到服务状态正常、日志没有报错,应用就在 8080 上跑起来了。

5. 配置 Nginx 反向代理

server {
    listen 80;
    server_name example.com;
 
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

再执行 sudo certbot --nginx -d example.com 自动签发并续期 HTTPS 证书。

也可以把 Nginx 本身做成一个 Compose 服务,放到同一个网络里,proxy_pass 直接写应用的服务名。

6. 上线后的更新流程

cd /srv/myapp
git pull
docker compose pull        # 若基础镜像有更新
docker compose up -d --build
docker compose ps

7. 备份(以 PostgreSQL 为例)

docker compose exec -T db pg_dump -U app app | gzip > /srv/backup/app-$(date +%F).sql.gz

用 cron 定时执行,并定期验证备份文件能不能恢复。

十、日常运维与排错

查问题的一般顺序

常见问题

现象 原因与处理
容器起来几秒就退出 主进程执行完或报错,先看 docker logs ;容器需要一个前台进程撑着
端口被占用 ss -lntp 找到占用者,或换一个宿主机端口
容器里连不上宿主机服务 容器内的 localhost 是自己,用服务名或网桥 IP
容器之间互相访问失败 不在同一自定义网络里,用 Compose 或 docker network connect
挂载目录没有权限 容器内用户 uid/gid 与宿主机目录属主不匹配,chown 或指定 user
时区不对 加参数 -e TZ=Asia/Shanghai ,或挂载 /etc/localtime
磁盘被占满 docker system df 定位,限制日志大小,用 docker system prune 清理
拉取镜像超时 配置 registry 镜像加速,或给 dockerd 设置 HTTP 代理
.env 改了不生效 环境变量在容器创建时注入,需要 docker compose up -d 重建容器

几个好用的小命令

docker inspect -f '{{.State.Status}}' web        # 只看状态
docker inspect -f '{{json .NetworkSettings.Networks}}' web
docker compose top                                # 看容器里的进程
docker compose down && docker compose up -d       # 配置改动后的干净重启

十一、最佳实践与进阶方向

最佳实践清单

进阶方向

小结