DEVOPS · CONTAINER FIELD GUIDE

Docker 全景指南:从概念到实践

从「在我机器上明明是好的」到「一次构建,到处运行」—— 本页串起 Docker 的 核心概念、常用命令、镜像构建、数据与网络、Compose 编排与最佳实践, 配交互图表与架构图解,适合作为团队速查手册。

2013
首次开源发布,容器生态起点
3 大概念
镜像 · 容器 · 仓库
≈ 0.5s
容器典型启动时间(亚秒级)
1 份镜像
贯穿开发 / 测试 / 生产环境
适用 Docker Engine 24+ / Compose V2 更新于 2026-11 图表:ECharts + Mermaid
01

概览:为什么是容器

软件交付的长期痛点是「环境」:依赖版本不一致、配置漂移、部署脚本在不同机器上行为不同。 Docker 的答案是——把应用连同它的全部依赖打包成一个标准化、可移植、隔离的运行单元。

Docker 是一个开源的应用容器引擎。它利用 Linux 内核的 Namespace(隔离视图:进程、网络、文件系统、用户)、Cgroups(限制 CPU / 内存等资源) 与 UnionFS 联合文件系统(分层镜像),实现操作系统级虚拟化——容器里的应用看到的是一个「独占」的系统, 实际上只是宿主机上被隔离的普通进程。

这带来三个直接收益:一致性(开发、测试、生产运行同一份镜像)、效率(秒级启动、MB 级体积、高密度部署)、 标准化(镜像成为与 Jar / npm 包同级的分发单元,配合 CI/CD 形成「构建即发布」流水线)。

核心工作流:Build → Ship → Run

MERMAID · 生命周期总览
flowchart LR
    SRC["源代码 + Dockerfile"] -->|"docker build"| IMG["镜像 Image<br/>只读分层模板"]
    IMG -->|"docker push"| REG[("镜像仓库 Registry<br/>Docker Hub · 私有仓库")]
    REG -->|"docker pull / run"| C1["容器 Container<br/>隔离的运行实例"]
    IMG -->|"docker run"| C1
    REG -->|"docker pull / run"| C2["另一台机器上的容器<br/>同样的镜像 · 同样的行为"]

容器 vs 虚拟机

虚拟机通过 Hypervisor 虚拟出一整套硬件,每个 VM 都要安装独立的 Guest OS;容器则共享宿主机内核, 只打包应用与依赖。一句话:容器不是「更轻的虚拟机」,而是「被隔离的进程」。

资源开销对比:容器 vs 虚拟机

ECHARTS · 对数刻度 · 典型示意值

注:为常见场景的量级示意(具体数值随负载与配置浮动);虚拟机开销主要来自独立 Guest OS,容器开销仅为宿主机上多一个进程。

维度容器(Docker)虚拟机(VM)
虚拟化级别OS 级,共享宿主内核硬件级,Hypervisor + 独立内核
典型启动时间亚秒 ~ 秒级30 秒 ~ 分钟级
磁盘占用MB 级(镜像分层共享)GB 级(每台完整 OS)
性能损耗接近原生有一定损耗(指令翻译 / IO 路径)
隔离强度进程级,相对较弱(共享内核)内核级,强隔离
单机密度成百上千数十
典型场景微服务、CI/CD、批处理任务多租户、异构 OS、强合规隔离
NOTE

共享内核意味着:Linux 容器只能运行 Linux 程序。macOS / Windows 上的 Docker Desktop 实际是在一个轻量 Linux 虚拟机里运行容器的——「容器替代 VM」并不准确,二者更多是互补关系。

02

核心概念:镜像 / 容器 / 仓库

理解这三个概念的关系(类比 OOP:类 → 对象,代码 → 包仓库),Docker 的全部命令都在操作这三样东西。

IMAGE

镜像 — 只读的分层模板

应用 + 运行时 + 依赖 + 配置的只读快照。由多条指令逐层堆叠而成,层可被多个镜像共享复用。类比:类 / 程序安装包。

CONTAINER

容器 — 镜像的运行实例

docker run 在镜像顶部加一个可写层启动的隔离进程。可启停、删除,同一镜像可同时跑 N 个容器。类比:对象 / 进程。

REGISTRY

仓库 — 镜像的分发中心

集中存储与分发镜像的服务。公共如 Docker Hub,私有可自建 Harbor / Registry。类比:Maven Central / npm registry。

整体架构:Client / Daemon / Registry

Docker 架构一图流

MERMAID · C/S 架构
flowchart LR
    CLI["docker CLI<br/>build · run · push · ps"]
    subgraph HOST["Docker 宿主机"]
        DAEMON["dockerd 守护进程"]
        subgraph CS["容器(隔离进程)"]
            C1["web :80"]
            C2["db :5432"]
        end
        STORE["本地镜像 / 容器 / 卷<br/>/var/lib/docker"]
    end
    REG[("Docker Hub<br/>registry-1.docker.io")]
    CLI -->|"REST API · unix socket"| DAEMON
    DAEMON --> C1
    DAEMON --> C2
    DAEMON --- STORE
    DAEMON <-->|"pull · push"| REG

docker CLI 并不直接操作容器:所有请求经 REST API 发给 dockerd,由守护进程完成构建、运行与存储管理——这也是远程 DOCKER_HOST 与 CI 集成的基础。

镜像是「分层」的:UnionFS 与写时复制

每条 Dockerfile 指令生成一个只读层,层层叠加即为镜像;运行时在顶部再盖一个可写层(容器层)。 读取时自上而下命中即返回;修改时触发写时复制(CoW)——把文件从只读层复制到可写层再改。 因此 100 个基于同一镜像的容器,磁盘上共享同一份只读内容,各自只持有薄薄的可写差异。

镜像分层结构示意

MERMAID · 自下而上堆叠
flowchart TB
    W["可写容器层 —— 运行时读写落在这里,容器删除即消失"]
    L3["COPY . /app"]
    L2["RUN pip install -r requirements.txt"]
    L1["ENV APP_ENV=production · WORKDIR /app"]
    B["基础镜像 python:3.12-slim(只读)"]
    W --> L3 --> L2 --> L1 --> B

镜像命名与 Tag

组成格式示例说明
完整引用[registry/]repository[:tag][@digest]docker.io/library/nginx:1.27registry 省略即 Docker Hub
官方镜像name:tagnginx:1.27-alpinelibrary/ 前缀可省
摘要锁定name@sha256:…nginx@sha256:6af…内容寻址,绝对不变,生产推荐
WARN

latest 陷阱:省略 tag 时默认拉 latest,但它只是「名叫 latest 的普通 tag」,既不保证最新、也可能被覆盖。生产环境务必固定具体版本 tag 或 digest。

03

安装与配置

按平台选择安装方式;国内网络环境建议同时配置镜像加速器。

平台推荐方式要点
macOSDocker Desktop / OrbStack容器运行在内置 Linux VM 中(Apple 芯片为 arm64);文件挂载跨 VM 边界有性能损耗
WindowsDocker Desktop + WSL2启用 WSL2 后端性能最佳;Linux 容器直接在 WSL 内核上运行
Ubuntu / Debianapt 官方仓库 或 get.docker.com生产建议锁版本的官方仓库;脚本适合快速体验
RHEL / CentOS 系dnf(docker-ce 仓库)注意系统自带 podman 冲突,先移除
install.sh — Linux 安装与验证
# Ubuntu / Debian:官方仓库安装(生产推荐)
sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io

# 通用脚本安装(快速体验)
curl -fsSL https://get.docker.com | sh
sudo systemctl enable --now docker

# 免 sudo:把当前用户加入 docker 组(需重新登录生效)
sudo usermod -aG docker $USER

# 验证
docker version && docker run --rm hello-world

配置镜像加速与日志限制

/etc/docker/daemon.json
{
  "registry-mirrors": ["https://<你的加速器地址>"],
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "3" },
  "builder": { "gc": { "enabled": true, "defaultKeepStorage": "20GB" } }
}
TIP

修改后执行 sudo systemctl restart docker 生效;macOS / Windows 在 Docker Desktop 的 Settings → Docker Engine 中编辑同一份 JSON。国内加速地址以云厂商控制台提供的为准(如阿里云容器镜像服务的个人加速器),可用 docker info | grep -A2 Mirrors 验证。

04

常用命令速查

覆盖 90% 日常操作的命令地图;支持下方输入框实时过滤。

容器生命周期

容器状态机

MERMAID · stateDiagram
stateDiagram-v2
    [*] --> Created: docker create
    Created --> Running: docker start
    Running --> Paused: docker pause
    Paused --> Running: docker unpause
    Running --> Exited: docker stop · 主进程退出
    Exited --> Running: docker start · restart
    Exited --> [*]: docker rm

docker run = create + start;容器退出的本质是「1 号主进程结束」——容器内必须有一个前台常驻进程。

镜像命令

命令作用备注
docker pull nginx:1.27拉取镜像默认源 Docker Hub,受加速器影响
docker images列出本地镜像等价 docker image ls;-a 含中间层
docker rmi nginx:1.27删除镜像被容器引用时需先删容器或 -f
docker tag web:1.0 user/web:1.0打标签推送前的必备步骤
docker build -t web:1.0 .从 Dockerfile 构建结尾的 . 是构建上下文路径
docker history web:1.0查看分层历史排查镜像体积时非常有用
docker save -o web.tar web:1.0导出镜像为 tar离线分发 / 备份
docker load -i web.tar从 tar 导入镜像与 save 成对使用
docker image prune -a清理无引用镜像-a 连同未被容器使用的镜像一起清
docker login registry.example.com登录私有仓库凭证存于 ~/.docker/config.json

容器命令

命令作用备注
docker run …创建并启动容器最常用,参数见下表
docker ps -a列出容器默认只显示运行中;-a 含已退出
docker stop / start / restart web生命周期控制stop 先 SIGTERM,超时(默认 10s)后 SIGKILL
docker rm web删除容器-f 可删运行中;不能删数据卷
docker logs -f --tail 100 web查看 / 跟踪日志输出主进程 stdout/stderr
docker exec -it web sh进入运行中容器新开进程,不影响主进程
docker inspect webJSON 详情IP、挂载、env、重启策略全在这
docker stats --no-stream资源占用快照CPU / 内存 / 网络 IO
docker top web容器内进程列表宿主机视角
docker diff web可写层文件改动A 添加 / C 修改 / D 删除
docker cp web:/path ./local容器 ↔ 宿主机互拷双向皆可,容器不必运行
docker system df磁盘占用总览镜像 / 容器 / 卷 / 构建缓存四类
docker system prune -a --volumes一键清理慎用:删除所有未使用资源与匿名卷

docker run 高频参数

参数含义示例
-d后台运行(detached)docker run -d nginx
--name指定容器名(默认随机)--name web
-p 宿主:容器端口映射-p 8080:80
-v 宿主:容器挂载卷 / 目录-v pgdata:/var/lib/postgresql/data
-e KEY=VAL注入环境变量-e TZ=Asia/Shanghai
--network加入指定网络--network app-net
-it交互 + 终端(前台调试)docker run -it alpine sh
--rm退出即自动删除docker run --rm hello-world
--restart重启策略--restart=unless-stopped
-m / --cpus内存 / CPU 限制-m 512m --cpus 1.5
--platform指定目标架构--platform linux/amd64
terminal — 一条命令跑起一个站点
$ docker run -d --name web \
    -p 8080:80 \
    -v "$(pwd)/html":/usr/share/nginx/html:ro \
    --restart=unless-stopped \
    nginx:1.27-alpine

$ docker exec -it web sh          # 进入容器排查
$ docker logs -f web               # 跟踪日志
$ curl -I http://localhost:8080    # 验证服务
05

Dockerfile 与镜像构建

Dockerfile 是镜像的「源代码」:一条指令一层,自上而下执行。写好它的核心是两件事—— 利用层缓存加速构建,以及选择合适的基础镜像控制体积。

常用指令一览

指令作用要点
FROM指定基础镜像必须是第一条有效指令;多阶段可出现多次
WORKDIR设置工作目录不存在会自动创建;代替 RUN cd
COPY复制上下文文件进镜像绝大多数场景用它而非 ADD
ADD复制 + 自动解压 tar / 远程 URL行为易 surprises,仅确需解压时使用
RUN构建期执行命令(产生新层)合并同批命令并清理缓存可显著减小体积
ENV持久环境变量运行期可见;不要放敏感信息
ARG构建期变量仅构建过程可见,不进运行时 env
EXPOSE声明监听端口仅文档作用,实际映射靠 -p
USER切换运行用户安全最佳实践:避免 root 运行
VOLUME声明匿名卷挂载点防止数据写进可写层;更推荐 -v 显式挂载
ENTRYPOINT固定入口命令容器「是什么」;run 追加的参数会传给它
CMD默认命令 / 默认参数容器「默认做什么」;可被 run 参数整体覆盖
HEALTHCHECK健康检查让编排系统能感知「活着但不可用」

CMD vs ENTRYPOINT

对比项ENTRYPOINTCMD
角色固定入口:容器「是什么程序」默认值:程序的默认参数
docker run 追加参数作为参数传给 ENTRYPOINT整体替换 CMD
典型组合["java","-jar","app.jar"]["--spring.profiles.active=prod"]
TIP

最佳实践是两者组合:ENTRYPOINT 定程序,CMD 定默认参数——用户既开箱即用,又能一行参数覆盖配置。

完整示例:多阶段构建

多阶段构建(multi-stage)用一个 Dockerfile 完成「编译」和「运行」两阶段,最终镜像只保留产物与运行时, 编译器、源码、构建工具全部被丢弃。同时注意层缓存:把变化最少的步骤放前面(先 COPY 依赖清单再装依赖,最后才 COPY 源码),改一行代码就不会重装全部依赖。

Dockerfile — Node 应用
# ---- 构建阶段 ----
FROM node:20-alpine AS build
WORKDIR /app
# 先复制依赖清单,命中层缓存
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# ---- 运行阶段:只留产物 ----
FROM node:20-alpine
WORKDIR /app
ENV NODE_ENV=production
COPY --from=build /app/node_modules ./node_modules
COPY --from=build /app/dist ./dist
USER node
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
  CMD wget -qO- http://127.0.0.1:3000/health || exit 1
CMD ["node", "dist/main.js"]
Dockerfile — Spring Boot 应用
FROM maven:3.9-eclipse-temurin-21 AS build
WORKDIR /src
COPY pom.xml .
RUN mvn -B dependency:go-offline
COPY src ./src
RUN mvn -B package -DskipTests

FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
COPY --from=build /src/target/app.jar app.jar
USER 10001
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

基础镜像怎么选

常见基础镜像典型压缩体积

ECHARTS · 约值

体积越小攻击面越小,但 alpine 使用 musl libc,个别依赖 glibc 的程序(如某些二进制、JIT 特性)需实测;distroless 连 shell 都没有,调试需 docker debug 或临时换镜像。

.dockerignore:构建上下文瘦身

docker build 会把上下文目录整体发给守护进程——把无关文件排除在外,既加速构建、又避免 .git、.env 等被意外打进镜像。

.dockerignore
.git
.gitignore
node_modules
dist
build
*.log
.env*
Dockerfile
docker-compose*.yml
README.md
06

数据管理:卷与挂载

容器可写层随容器删除而消失,且写入性能与可移植性差——凡是要「活得比容器久」的数据,都应放到容器外。

方式宿主侧位置由谁管理可移植性典型用途
命名卷 volume/var/lib/docker/volumes/<name>Docker好(不依赖宿主路径)数据库数据、应用状态
绑定挂载 bind mount宿主任意路径你差(路径写死)开发时源码热更新、注入配置
tmpfs内存(不落盘)Docker无敏感临时文件、密钥

挂载方式示意

MERMAID · volume 与 bind mount
flowchart LR
    subgraph HOST["宿主机"]
        VOL["命名卷 pgdata<br/>/var/lib/docker/volumes/pgdata"]
        BIND["绑定挂载 ./src<br/>/home/me/project/src"]
    end
    subgraph BOX["容器"]
        DB["postgres 容器<br/>/var/lib/postgresql/data"]
        APP["node 容器(开发)<br/>/app 源码热更新"]
    end
    VOL -. "挂载" .-> DB
    BIND -. "挂载 :rw" .-> APP
terminal — 卷的增删查与挂载
$ docker volume create pgdata          # 创建命名卷
$ docker volume ls                     # 列出全部卷
$ docker volume inspect pgdata         # 详情(含真实路径)

$ docker run -d --name db \
    -v pgdata:/var/lib/postgresql/data \
    -e POSTGRES_PASSWORD=secret postgres:16

$ docker volume rm pgdata              # 删卷(数据同时消失)
$ docker volume prune                  # 清理所有未使用卷

# 绑定挂载 + 只读:宿主目录注入容器,:ro 防止容器改写
$ docker run -d -p 8080:80 \
    -v "$(pwd)/html":/usr/share/nginx/html:ro nginx:alpine
NOTE

-v 是简写,--mount 是更显式的等价语法(--mount type=volume,source=pgdata,target=/var/lib/.../data);新脚本建议用 --mount,语义更清楚、不易写错。

07

容器网络

每个容器都在自己的 Network Namespace 里。默认 bridge 网络下容器间只能靠 IP 互访; 而自定义网络内置 DNS,让容器直接用名字找到彼此——这是单机多容器协作的关键。

网络模式说明典型场景
bridge(默认)虚拟网桥 + NAT,容器在私有网段绝大多数应用;配合 -p 暴露端口
host直接共享宿主网络栈,无 NAT追求网络性能;端口与宿主直接冲突
none只有 lo,完全无网络离线批处理、安全敏感任务
container:<name>复用另一容器的网络栈Sidecar / 工具容器共享 localhost

bridge 网络与端口映射

MERMAID · 自定义网络拓扑
flowchart LR
    EXT["外部客户端<br/>curl localhost:8080"]
    subgraph HOST["Docker 宿主机"]
        NATPT["iptables NAT<br/>-p 8080:3000 端口映射"]
        subgraph NET["自定义 bridge 网络 app-net"]
            API["api 容器<br/>172.18.0.2"]
            DB["db 容器<br/>172.18.0.3"]
        end
    end
    EXT --> NATPT --> API
    API <-->|"内置 DNS · 按主机名互访"| DB
terminal — 自定义网络 + DNS 互访
$ docker network create app-net
$ docker run -d --name db --network app-net \
    -e POSTGRES_PASSWORD=secret postgres:16
$ docker run -d --name api --network app-net \
    -p 8080:3000 my-api:1.0

# api 容器内:连接串直接写主机名 db,无需关心 IP
# DATABASE_URL=postgres://app:secret@db:5432/app

# 仅绑定本机回环,避免数据库暴露到外部网络
$ docker run -d -p 127.0.0.1:5432:5432 postgres:16
网络命令作用
docker network ls列出网络(bridge / host / none + 自定义)
docker network create app-net创建自定义 bridge 网络
docker network inspect app-net查看网段、网关与已接入容器
docker network connect app-net web把运行中容器再接入一个网络
docker network disconnect / rm / prune断开 / 删除 / 清理网络
WARN

-p 8080:80 默认绑定 0.0.0.0(所有网卡),在云服务器上等于对公网开放;仅本机访问请显式写 -p 127.0.0.1:8080:80,并在安全组层面收紧。

08

Docker Compose

当一个应用需要多个容器协作(Web + 数据库 + 缓存),逐条 docker run 既难维护也无法复现。 Compose 用一个 YAML 声明式描述全部服务、网络与卷,一条命令拉起整套环境。

docker-compose.yml — Web + Postgres
services:
  web:
    build: .                        # 用当前目录 Dockerfile 构建
    ports: ["8080:3000"]
    environment:
      DATABASE_URL: postgres://app:secret@db:5432/app
    depends_on:
      db:
        condition: service_healthy  # 等 db 健康后再启动
    restart: unless-stopped

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

volumes:
  pgdata:
命令作用备注
docker compose up -d创建并后台启动全部服务首次会自动 build / pull
docker compose down停止并删除容器与网络-v 连带删除卷(数据!)
docker compose ps查看服务状态含健康检查状态
docker compose logs -f web跟踪某服务日志--tail 100 限制行数
docker compose exec web sh进入服务容器服务名即容器组前缀
docker compose build --pull重新构建镜像--pull 强制更新基础镜像
docker compose pull拉取服务镜像更新配合 up -d 滚动更新
docker compose restart web重启某服务不重建容器
docker compose config校验并展开最终配置排查 YAML 合并问题的利器
NOTE

Compose V2 是 docker compose(空格,插件形态),老式 docker-compose(连字符)已停止维护;V2 中顶层 version: 字段已废弃,直接以 services: 开头即可。多环境可用 -f base.yml -f prod.yml 叠加,或 --profile 按需启用服务组。

09

最佳实践

从体积、安全、健壮性到 CI/CD 的检查清单——生产镜像的及格线。

SIZE · 体积

让镜像小而专一

  • 多阶段构建:产物与运行时分离
  • 选 slim / alpine / distroless 基础镜像
  • 合并 RUN 并清理包缓存:rm -rf /var/lib/apt/lists/*
  • 配好 .dockerignore,别把 .git 打进镜像
SECURITY · 安全

默认不信任镜像内容

  • 固定 tag / digest,不用 latest
  • 非 root 运行:USER 指定低权用户
  • 密钥用 secret mount,不写 ENV / ARG
  • 定期 docker scout cves 扫描漏洞
ROBUST · 健壮

让容器可被运维

  • 写 HEALTHCHECK,暴露真实健康度
  • 日志输出 stdout/stderr,配 轮转上限
  • 设 --restart=unless-stopped
  • 资源限额:-m --cpus 防止互相挤占
CI/CD · 流水线

构建又快又稳

  • 依赖清单前置,最大化层缓存命中
  • BuildKit:--cache-from / --cache-to 共享缓存
  • buildx 一次产出 amd64 + arm64 多架构
  • 镜像 tag 用 git sha + 版本号,可追溯

构建期注入密钥:secret mount

ENV / ARG 里的值会永久留在镜像层(docker history 可见)。需要私有 npm / maven 仓库凭证时,用 secret mount——只在构建进程内存中存在,不落镜像层。

Dockerfile + build — 构建期密钥
# Dockerfile 内
RUN --mount=type=secret,id=npmrc \
    cp /run/secrets/npmrc /root/.npmrc && npm ci && rm /root/.npmrc

# 构建命令
$ docker build --secret id=npmrc,src=$HOME/.npmrc -t app:1.0 .
terminal — 多架构构建与推送
$ docker buildx create --use            # 启用多架构构建器
$ docker buildx build \
    --platform linux/amd64,linux/arm64 \
    -t yourname/app:1.0 --push .
10

常见问题 FAQ

点击展开问题与解决方案。

Q1permission denied 连接 Docker 守护进程›
docker: permission denied while trying to connect to the Docker daemon socket at /var/run/docker.sock

当前用户不在 docker 组。执行 sudo usermod -aG docker $USER 后注销重新登录;macOS / Windows 使用 Desktop 无此问题。

Q2Cannot connect to the Docker daemon›
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

守护进程未启动:Linux 上 sudo systemctl start docker;Desktop 平台确认应用已运行。若配置了远程 DOCKER_HOST,检查网络与 TLS 证书。

Q3拉取镜像超时 / manifest unknown›
Error response from daemon: ... manifest for nginx:1.27 not found / i/o timeout

依次排查:① 网络受限 → 配置镜像加速器(见第 03 节);② tag 拼写 → docker manifest inspect nginx:1.27 验证存在性;③ 私有仓库 → 先 docker login。

Q4Bind for 0.0.0.0:8080 failed: port is already allocated›
Error starting userland proxy: listen tcp4 0.0.0.0:8080: bind: address already in use

宿主端口被占:lsof -i :8080(或 lsof -i :8080 -sTCP:LISTEN)找到占用进程后停掉,或换映射端口 -p 8081:80。

Q5no space left on device›

镜像 / 停止容器 / 卷 / 构建缓存堆积。先用 docker system df 看占用分布,再分项清理:镜像 docker image prune -a、构建缓存 docker builder prune、全量 docker system prune -a --volumes(会删未使用卷,先确认数据)。

Q6容器一启动就退出(Exited (0) / (1))›

容器 = 主进程,1 号进程结束容器就退出。先 docker logs <name> 看退出原因(配置错误、依赖连不上等);若是「正常跑完」类程序,改用 -d + 常驻前台进程,或调试时 docker run --rm -it <img> sh 保持交互。

Q7exec 报 bash: executable file not found›
OCI runtime exec failed: exec: "bash": executable file not found in $PATH

alpine / distroless 镜像没有 bash。alpine 用 docker exec -it <name> sh;distroless 连 sh 都没有,用 docker debug <name> 附加调试容器,或临时换带 shell 的镜像排查。

Q8Apple Silicon 上跑 amd64 镜像失败 / 极慢›

ARM 机器默认按 arm64 拉镜像。确需 amd64 时加 --platform linux/amd64(QEMU 模拟,性能有损);根本解法是让镜像提供多架构 manifest(见第 09 节 buildx)。

Q9容器内时间 / 时区不对›

镜像默认多为 UTC。通用做法:-e TZ=Asia/Shanghai(镜像需含 tzdata;slim/alpine 可在构建期 RUN apk add --no-cache tzdata),或挂载宿主时区 -v /etc/localtime:/etc/localtime:ro。

11

Podman:无守护进程的容器引擎

学完 Docker 后最常见的追问:「Podman 和 Docker 什么关系?我该用哪个?」——答案是同根同源、不同架构: 两者共享同一套 OCI 标准与镜像格式,命令近乎一致;真正的分野在于 Docker 选择「常驻守护进程」, Podman 选择「无守护进程 + 无 root」。

Podman(Pod Manager)由 Red Hat 主导、2018 年首发,如今是 RHEL / CentOS / Fedora 系发行版的 默认容器引擎。它完全实现 OCI 镜像与运行时规范,直接使用现有 Dockerfile 构建镜像, CLI 子命令(run / build / ps / push…)与 Docker 几乎一一对应, 官方还提供 podman-docker 别名包,让 docker 命令无缝由 Podman 接管。

「另起炉灶」的原因在于架构哲学:Docker 是 C/S 架构——一切经 REST API 交给以 root 身份常驻的 dockerd,守护进程既是能力中枢也是单点风险;Podman 是 daemonless——CLI 进程直接创建并看护容器, 随用随走,不存在那个「万能 root 管家」。

DAEMONLESS

没有守护进程

podman run 由 CLI 进程直接创建容器,每个容器只配一个轻量 conmon 看护进程;不存在全局 daemon,也就没有全局单点与全局状态。

ROOTLESS

默认无 root 运行

普通用户直接运行容器,宿主侧全程不需要任何 root 权限:用户命名空间(userns)把容器内 root 映射为宿主普通用户,天然压缩攻击面。

COMPATIBLE

兼容 Docker 生态

同一份 Dockerfile、同一个 OCI 镜像、同一个 Docker Hub / Quay / Harbor 仓库;docker save / podman load 即可互导,多数场景只需把前缀从 docker 换成 podman。

架构对比:有没有那个「管家」

Docker C/S 架构 vs Podman 无守护架构

MERMAID · 并排对照
flowchart TB
    subgraph DK["Docker · C/S 架构"]
        direction TB
        DCLI["docker CLI"]
        DD["dockerd 常驻守护进程<br/>传统以 root 身份运行"]
        DC1["容器进程<br/>dockerd 的子进程"]
        DCLI -->|"REST API · unix socket"| DD
        DD --> DC1
    end
    subgraph PM["Podman · Daemonless"]
        direction TB
        PCLI["podman CLI<br/>你的普通用户进程"]
        CON["conmon 看护进程<br/>每个容器一个"]
        PC1["容器进程<br/>以你的用户身份运行"]
        PCLI -->|"直接创建"| CON
        CON --> PC1
    end

左边:CLI 只发请求,所有容器挂在常驻 dockerd 之下——支持远程 DOCKER_HOST 与集中管理,但守护进程是全局单点;右边:没有中间商,CLI 退出后容器由 conmon 继续看护,开机自启则交还给 systemd 托管。

关系:同一套标准,两条实现路线

容器世界在 2015 年迎来分水岭:Docker 联手 CoreOS 等成立 OCI(Open Container Initiative), 把「镜像是什么、运行时怎么跑」沉淀为开放规范。此后 Docker 与 Podman 便是同一规范下的两条实现路线—— 如同两款浏览器之于 Web 标准:镜像完全互通,语法彼此借鉴,仓库(Docker Hub / Quay / Harbor)完全通用。

时间里程碑与两者关系
2013Docker 开源,容器化浪潮起点生态奠基者
2015OCI 联盟成立,镜像 / 运行时规范标准化两者共同的「宪法」
2017containerd 捐赠 CNCF;K8s 以 CRI 标准对接运行时生态与单一引擎解耦
2018Red Hat 发布 Podman 1.0(前身 libpod)主打无守护进程替代
2019RHEL 8 起官方默认引擎为 Podman企业发行版原生入场
2022K8s 1.24 移除 dockershim,运行时转向 containerd / CRI-O编排层两者均退居幕后
2024+Podman 5.x 与 Podman Desktop 成熟在 OCI 标准下长期共存
NOTE

所以「Podman 替代 Docker」更准确的说法是:Podman 替代的是 Docker Engine 那套 C/S 工具链,而不是替代容器本身——镜像、Dockerfile、OCI 标准原封不动,本指南讲的构建、网络、存储知识对两者同样适用。

核心差异对照

维度DockerPodman
架构模型C/S:CLI → REST API → 常驻 dockerdDaemonless:CLI 进程直接创建容器
守护进程必须常驻(传统以 root 运行;另有可选 rootless dockerd 模式)无:每个容器一个轻量 conmon 看护进程
运行权限root 或 docker 组(≈ root 权限)默认 rootless:普通用户即可,无需任何特权
安全模型root daemon 是单点:一旦失守波及全部容器userns 映射:宿主侧无 root,多用户之间互不可见
生命周期托管--restart 策略由 daemon 掌控systemd 原生托管(Quadlet),随系统开机自启
多容器编排Compose(官方)+ 内置 Swarmpodman compose 兼容 Compose V2;原生 pod;Quadlet 多单元;无 Swarm
镜像构建docker build(BuildKit)podman build(Buildah)——同一 Dockerfile
Pod 概念无(Swarm 以 service 抽象)有:podman pod,贴近 K8s Pod(组内共享网络命名空间)
单机 ⇄ K8s需 kompose 等第三方转换podman kube generate / play 直接生成与回放 YAML
桌面产品Docker Desktop(大型企业需商业订阅)Podman Desktop(开源免费)
macOS / WindowsDesktop 内置 Linux VMpodman machine init / start 管理轻量 VM

定位雷达:怎么选,一目了然

ECHARTS · 定性示意 · 1–5 分

分值为 1–5 的定性示意(非基准测试):Docker 胜在生态与开箱即用,Podman 胜在安全模型与 systemd 集成——不是谁碾压谁,而是「默认场景不同」。

命令几乎一致:迁移成本极低

migrate.sh — 从 Docker 平滑迁移
# ① 别名包:装完后 docker 命令实际由 Podman 接管(Fedora / RHEL 系)
$ sudo dnf install -y podman podman-docker

# ② 镜像互导:同为 OCI 格式,无需重新构建
$ docker save -o app.tar myapp:1.0
$ podman load -i app.tar

# ③ rootless:普通用户直接跑,没有 sudo 也没有 docker 组
$ podman run -d --name web -p 8080:80 nginx:1.27-alpine

# ④ 现有 Compose 文件直接复用(由 Compose V2 / podman-compose 驱动)
$ podman compose up -d
能力DockerPodman说明
运行 / 列出 / 构建docker run / ps / buildpodman run / ps / build参数与行为基本一致
推拉镜像docker pull / pushpodman pull / push同一 registry 通用
Composedocker composepodman composePodman 需 Compose V2 或 podman-compose 兼容层
桌面 VM(macOS / Win)Docker Desktop 内置podman machine init/start两者都在轻量 Linux VM 中跑容器
systemd 托管手写 unit 文件Quadlet / generate systemdPodman 原生一等公民
Pod / K8s YAML—podman pod · kube generate/playPodman 独有
docker 命令别名—podman-docker 包装完 docker 命令即 Podman
~/.config/containers/systemd/web.container — Quadlet 开机自启
[Container]
Image=docker.io/library/nginx:1.27-alpine
PublishPort=8080:80

[Service]
Restart=always

[Install]
WantedBy=default.target

# 生效:systemctl --user daemon-reload && systemctl --user start web.service
TIP

Quadlet(Podman 4.4+,推荐用法)让容器成为 systemd 原生单元:文件名即服务名,journalctl --user -u web 直接查日志;再配 loginctl enable-linger $USER,无需登录也能开机自启——这是「无守护进程」路线的杀手锏。

各自的应用场景

WHEN DOCKER

桌面开发 · CI/CD · 团队标准

  • 开箱即用:Docker Desktop 一键安装,自带 GUI 与 K8s
  • 生态最全:教程、CI 模板、第三方资料的事实标准
  • Compose / Swarm:多容器编排官方一体化
  • 商业支持完善(注意大型企业 Desktop 需付费订阅)
WHEN PODMAN

共享服务器 · 企业 Linux · 无 root

  • 多用户隔离:每人 rootless 自治,宿主侧零特权、互不可见
  • RHEL / Fedora 原生:系统默认引擎,无额外安装与订阅
  • systemd 服务化:Quadlet 让容器像服务一样开机自启
  • K8s 预演:pod 概念 + kube YAML 直接生成 / 回放
  • 安全合规:不允许 root 常驻守护进程的环境
MIX & MATCH

不必二选一:一套镜像,随时切换

  • 镜像 / 仓库 / Dockerfile 完全互通,构建一次两边运行
  • 开发机用 Docker、生产单机用 Podman 的组合很常见
  • 脚本层面:换前缀或装别名包即可迁移
  • 进了 Kubernetes 后都交给 containerd / CRI-O,CLI 之争到此为止
NOTE

一句话选型:个人学习、桌面开发、CI 流水线 → Docker(生态与工具链最省心);共享 / 生产单机、多用户、无 root 与 systemd 环境 → Podman。更重要的结论是:两者共享 OCI 标准,镜像构建、网络、存储等核心知识完全通用——真正值得学的是容器本身,而非某一家 CLI。

REF

参考来源

  1. Docker Docs — Get Started & Core Concepts
    https://docs.docker.com/get-started/
  2. Dockerfile Reference(官方指令规范)
    https://docs.docker.com/reference/dockerfile/
  3. Compose File Reference(服务编排配置)
    https://docs.docker.com/reference/compose-file/
  4. Docker CLI Reference(命令行手册)
    https://docs.docker.com/reference/cli/docker/
  5. Docker Blog — What's new in Docker Engine 28.0 / 29.0
    https://www.docker.com/blog/whats-new-in-docker-engine-28-0/ · …/docker-engine-29-0/
  6. Podman Documentation — Daemonless / Rootless / Quadlet
    https://docs.podman.io/ · github.com/containers/podman
  7. 本仓库《Docker 主要版本演进史 · 倒序时间轴(2013–2026)》
    ../docker-version-timeline/docker-version-timeline.html
  8. 本地基线文档 docker-version-history.md(版本数据基线,截至 2026-10-29)
    本地源文档(同目录上一级)