Docker 入门与实践

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

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

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

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

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

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

  • 镜像 image:只读的应用模板,包含文件系统 + 启动命令 + 元数据。用 Dockerfile 构建出来,可以分层复用。
  • 容器 container:镜像的运行实例。镜像可以起无数个容器,容器内写入的数据默认随容器删除而消失。
  • 仓库 registry:镜像的分发中心,官方的叫 Docker Hub,公司内部常用 Harbor、GitLab Registry 等。

配套的两个概念:

  • 数据卷 volume:把需要长期保存的数据放在容器之外,容器删掉数据还在。
  • 网络 network:容器之间、容器和外部世界互通的方式,同一自定义网络内的容器可以用容器名互相访问。
  • 统一开发、测试、生产环境,减少「环境不一致」类问题
  • 快速部署开源软件(数据库、中间件、监控、博客系统等)
  • 把自研服务打包成镜像,交给 CI/CD 自动发布
  • 在一台机器上跑多个互不干扰的服务

推荐用官方 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 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 重启服务。日志上限很重要,否则容器日志会把磁盘写满。

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

安装步骤(Windows 为例):

  • 到 Docker 官网下载 Docker Desktop 安装包
  • 安装时勾选使用 WSL2 后端(也可以在设置里切换),比旧的 Hyper-V 后端更快、更省资源
  • 启动后任务栏出现鲸鱼图标,状态显示 Engine running 就绪
  • 打开终端执行 docker version 验证,CLI 与 Docker Desktop 是同一套,命令和在 Linux 上完全一样

界面里几个主要页面:

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

常用操作:

  • 在 Images 页面点 Run,填上端口映射(如 8080:80 )和挂载卷,就起了一个容器
  • 容器详情页的 Logs 是排错第一现场,Exec 相当于执行 docker exec -it
  • Settings → Resources 里调整 CPU、内存、磁盘上限(默认内存偏小,跑 MySQL 建议给到 4 GB 以上)
  • Settings → Docker Engine 里可以直接改 daemon.json,把镜像加速地址粘进去,Apply & restart 生效
  • Settings → Resources → File sharing 里配置可以与容器共享的宿主机目录,否则绑定挂载会失败
  • 出问题时用 Troubleshoot 看诊断日志,实在不行 Reset to factory defaults 重置

几个容易踩的坑:

  • Windows 下的绑定挂载:路径要用 Docker Desktop 认得的写法,或直接用 WSL2 里的路径;项目放在 WSL2 文件系统(如 /home/you/project )里比放在 C 盘快很多
  • Docker Desktop 的 Linux 容器实际跑在一个小虚拟机里,所以容器里的 localhost 不是你的电脑,要访问宿主机上的服务得用 host.docker.internal
  • 它只适合开发和测试;生产服务器请直接在 Linux 上安装 Docker Engine
  • 公司规模较大时,Docker Desktop 的商业授权需要先确认

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

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

  • docker CLI:你敲的命令行,负责把请求发给守护进程
  • dockerd(守护进程):真正干活的,管理镜像、容器、网络、卷
  • containerd / runc:底层运行时,负责实际创建和启动容器进程
  • registry:镜像仓库,docker pull 从这里下载镜像,docker push 推上去

镜像采用分层存储: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 是构建镜像的说明书。一个 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"]
  • 把变化少的内容放前面:先拷贝依赖清单并安装依赖,最后才拷贝源码
  • 写 .dockerignore 文件,排除不需要进构建上下文的文件:
node_modules
.git
.env
dist
*.log
  • 合并 RUN 里相关的命令,并及时清理包管理器缓存
方式 写法 典型场景
具名卷 -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

要点:

  • 在同一个自定义网络里,容器之间可以直接用容器名当主机名,例如应用连数据库时,主机名直接写数据库的容器名 db
  • 容器里的 localhost 指的是容器自己,不是宿主机
  • 需要访问宿主机上的服务时,Linux 下用宿主机在网桥上的 IP(通常是 172.17.0.1),或者用 host.docker.internal 这个主机名(需要额外配置)
  • 默认的 bridge 网络不支持用容器名互访,所以务必建自定义网络或直接用 Compose

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

最小可用的启动命令:

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

几个关键点:

  • 数据必须落在 /var/lib/mysql 对应的卷里,容器删了数据还在
  • 端口写成 127.0.0.1:3306:3306 ,只监听本机;直接写 3306:3306 就等于对公网开放数据库
  • MYSQL_ROOT_PASSWORD 是必填项,不写容器会直接退出
  • 用 MYSQLUSER 和 MYSQLPASSWORD 建业务账号,应用不要用 root 连
  • 初次启动初始化要几秒到几十秒,用 docker logs -f mysql 看进度

进去验证:

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 脚本只在数据目录为空的第一次启动时执行,之后放进去不会跑;想重跑得换一个新卷。

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'
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 换成强密码

几个关键点:

  • Redis 默认没有密码,一旦暴露到公网很快会被扫到并植入挖矿程序,务必设 --requirepass 并只监听本机
  • --appendonly yes 打开 AOF 持久化,数据落在 /data 卷里
  • 只当缓存用、丢了也无所谓的场景,可以不挂卷,性能更好
  • 生产环境要设内存上限和淘汰策略,避免把宿主机内存吃光

连接测试:

docker exec -it redis redis-cli -a 换成强密码
> PING
PONG
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 非常方便,但生产环境这类有状态服务,优先考虑云数据库或托管服务;自建的话,备份、监控和内存上限一个都别省。

一个容器还好管,服务一多(应用 + 数据库 + 缓存 + 反向代理)就得用 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 ,机器重启后服务能自动回来。

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

  • 一台 Linux 服务器(1 核 2G 起,把域名 A 记录解析到它的公网 IP)
  • 开放 80、443 端口;不要对公网暴露数据库端口
  • 按第二章安装 Docker 并配置镜像加速、日志上限
sudo mkdir -p /srv/myapp && cd /srv/myapp
# 上传代码,或 git clone 仓库

目录结构大致是:

/srv/myapp
├── compose.yaml
├── Dockerfile
├── .env
└── src/
POSTGRES_PASSWORD=换成你的强密码
DATABASE_URL=postgres://app:换成你的强密码@db:5432/app

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

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

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

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 直接写应用的服务名。

cd /srv/myapp
git pull
docker compose pull        # 若基础镜像有更新
docker compose up -d --build
docker compose ps
docker compose exec -T db pg_dump -U app app | gzip > /srv/backup/app-$(date +%F).sql.gz

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

  • docker compose ps 看容器是不是在跑、有没有反复重启
  • docker compose logs --tail 200 服务名 看日志,90% 的问题在这里
  • docker inspect 容器名 看退出码、挂载、环境变量、网络
  • docker exec -it 容器名 sh 进去手工验证(能不能连数据库、文件在不在)
现象 原因与处理
容器起来几秒就退出 主进程执行完或报错,先看 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       # 配置改动后的干净重启
  • 一个容器只跑一个主进程,别把应用和数据库塞进同一个镜像
  • 基础镜像选精简版(alpine 、slim 、distroless ),并固定版本 tag,不要用 latest
  • 用多阶段构建缩小产物体积
  • 用非 root 用户运行(USER ),只读挂载不需要写入的目录
  • 敏感信息用环境变量、secret 或外部配置中心,不进镜像、不进 Git
  • 数据一律放卷,容器本身当作可随时丢弃的
  • 给关键服务配 healthcheck 和 restart 策略
  • 限制日志大小与容器资源(--memory 、--cpus )
  • 定期清理与更新镜像,扫描漏洞(如 trivy image )
  • 编排:单机用 Compose,多机再上 Kubernetes(Docker Swarm 已较少用于新项目)
  • CI/CD:GitHub Actions / GitLab CI 里 build 并 push 镜像,服务器上只做 pull + up
  • 镜像仓库:自建 Harbor,做镜像签名、复制和权限管理
  • 可观测性:cAdvisor + Prometheus + Grafana 看资源,Loki 收日志
  • 构建优化:BuildKit、Buildx 多平台构建(--platform linux/amd64,linux/arm64 ),构建缓存
  • 安全:Rootless 模式、镜像漏洞扫描、最小权限运行
  • Docker 的核心是镜像—容器—仓库三件套,加上卷和网络
  • 日常操作记牢几条:docker run -d -p 、docker ps 、docker logs -f 、docker exec -it 、docker build -t
  • 多服务用 compose.yaml 描述,docker compose up -d 一条命令起停
  • 上线要做的三件事:数据放卷、凭据放 .env 、日志设上限
  • 出问题先看日志,再 inspect,最后进容器手工验证

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • docker.1791452972.txt.gz
  • 最后更改: 2026/10/08 17:49
  • 由 张叶安