DEVOPS · CONTAINER FIELD GUIDE
Docker 全景指南:从概念到实践
从「在我机器上明明是好的」到「一次构建,到处运行」—— 本页串起 Docker 的 核心概念、常用命令、镜像构建、数据与网络、Compose 编排与最佳实践, 配交互图表与架构图解,适合作为团队速查手册。
概览:为什么是容器
软件交付的长期痛点是「环境」:依赖版本不一致、配置漂移、部署脚本在不同机器上行为不同。 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、强合规隔离 |
共享内核意味着:Linux 容器只能运行 Linux 程序。macOS / Windows 上的 Docker Desktop 实际是在一个轻量 Linux 虚拟机里运行容器的——「容器替代 VM」并不准确,二者更多是互补关系。
核心概念:镜像 / 容器 / 仓库
理解这三个概念的关系(类比 OOP:类 → 对象,代码 → 包仓库),Docker 的全部命令都在操作这三样东西。
镜像 — 只读的分层模板
应用 + 运行时 + 依赖 + 配置的只读快照。由多条指令逐层堆叠而成,层可被多个镜像共享复用。类比:类 / 程序安装包。
容器 — 镜像的运行实例
docker run 在镜像顶部加一个可写层启动的隔离进程。可启停、删除,同一镜像可同时跑 N 个容器。类比:对象 / 进程。
仓库 — 镜像的分发中心
集中存储与分发镜像的服务。公共如 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.27 | registry 省略即 Docker Hub |
| 官方镜像 | name:tag | nginx:1.27-alpine | library/ 前缀可省 |
| 摘要锁定 | name@sha256:… | nginx@sha256:6af… | 内容寻址,绝对不变,生产推荐 |
latest 陷阱:省略 tag 时默认拉 latest,但它只是「名叫 latest 的普通 tag」,既不保证最新、也可能被覆盖。生产环境务必固定具体版本 tag 或 digest。
安装与配置
按平台选择安装方式;国内网络环境建议同时配置镜像加速器。
| 平台 | 推荐方式 | 要点 |
|---|---|---|
| macOS | Docker Desktop / OrbStack | 容器运行在内置 Linux VM 中(Apple 芯片为 arm64);文件挂载跨 VM 边界有性能损耗 |
| Windows | Docker Desktop + WSL2 | 启用 WSL2 后端性能最佳;Linux 容器直接在 WSL 内核上运行 |
| Ubuntu / Debian | apt 官方仓库 或 get.docker.com | 生产建议锁版本的官方仓库;脚本适合快速体验 |
| RHEL / CentOS 系 | dnf(docker-ce 仓库) | 注意系统自带 podman 冲突,先移除 |
# 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
配置镜像加速与日志限制
{
"registry-mirrors": ["https://<你的加速器地址>"],
"log-driver": "json-file",
"log-opts": { "max-size": "10m", "max-file": "3" },
"builder": { "gc": { "enabled": true, "defaultKeepStorage": "20GB" } }
}
修改后执行 sudo systemctl restart docker 生效;macOS / Windows 在 Docker Desktop 的 Settings → Docker Engine 中编辑同一份 JSON。国内加速地址以云厂商控制台提供的为准(如阿里云容器镜像服务的个人加速器),可用 docker info | grep -A2 Mirrors 验证。
常用命令速查
覆盖 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 web | JSON 详情 | 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 |
$ 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 # 验证服务
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
| 对比项 | ENTRYPOINT | CMD |
|---|---|---|
| 角色 | 固定入口:容器「是什么程序」 | 默认值:程序的默认参数 |
| docker run 追加参数 | 作为参数传给 ENTRYPOINT | 整体替换 CMD |
| 典型组合 | ["java","-jar","app.jar"] | ["--spring.profiles.active=prod"] |
最佳实践是两者组合:ENTRYPOINT 定程序,CMD 定默认参数——用户既开箱即用,又能一行参数覆盖配置。
完整示例:多阶段构建
多阶段构建(multi-stage)用一个 Dockerfile 完成「编译」和「运行」两阶段,最终镜像只保留产物与运行时, 编译器、源码、构建工具全部被丢弃。同时注意层缓存:把变化最少的步骤放前面(先 COPY 依赖清单再装依赖,最后才 COPY 源码),改一行代码就不会重装全部依赖。
# ---- 构建阶段 ---- 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"]
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 等被意外打进镜像。
.git .gitignore node_modules dist build *.log .env* Dockerfile docker-compose*.yml README.md
数据管理:卷与挂载
容器可写层随容器删除而消失,且写入性能与可移植性差——凡是要「活得比容器久」的数据,都应放到容器外。
| 方式 | 宿主侧位置 | 由谁管理 | 可移植性 | 典型用途 |
|---|---|---|---|---|
| 命名卷 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
$ 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
-v 是简写,--mount 是更显式的等价语法(--mount type=volume,source=pgdata,target=/var/lib/.../data);新脚本建议用 --mount,语义更清楚、不易写错。
容器网络
每个容器都在自己的 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
$ 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 | 断开 / 删除 / 清理网络 |
-p 8080:80 默认绑定 0.0.0.0(所有网卡),在云服务器上等于对公网开放;仅本机访问请显式写 -p 127.0.0.1:8080:80,并在安全组层面收紧。
Docker Compose
当一个应用需要多个容器协作(Web + 数据库 + 缓存),逐条 docker run 既难维护也无法复现。
Compose 用一个 YAML 声明式描述全部服务、网络与卷,一条命令拉起整套环境。
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 合并问题的利器 |
Compose V2 是 docker compose(空格,插件形态),老式 docker-compose(连字符)已停止维护;V2 中顶层 version: 字段已废弃,直接以 services: 开头即可。多环境可用 -f base.yml -f prod.yml 叠加,或 --profile 按需启用服务组。
最佳实践
从体积、安全、健壮性到 CI/CD 的检查清单——生产镜像的及格线。
让镜像小而专一
- 多阶段构建:产物与运行时分离
- 选 slim / alpine / distroless 基础镜像
- 合并 RUN 并清理包缓存:
rm -rf /var/lib/apt/lists/* - 配好 .dockerignore,别把 .git 打进镜像
默认不信任镜像内容
- 固定 tag / digest,不用 latest
- 非 root 运行:USER 指定低权用户
- 密钥用 secret mount,不写 ENV / ARG
- 定期
docker scout cves扫描漏洞
让容器可被运维
- 写 HEALTHCHECK,暴露真实健康度
- 日志输出 stdout/stderr,配 轮转上限
- 设
--restart=unless-stopped - 资源限额:
-m --cpus防止互相挤占
构建又快又稳
- 依赖清单前置,最大化层缓存命中
- BuildKit:
--cache-from / --cache-to共享缓存 - buildx 一次产出 amd64 + arm64 多架构
- 镜像 tag 用 git sha + 版本号,可追溯
构建期注入密钥:secret mount
ENV / ARG 里的值会永久留在镜像层(docker history 可见)。需要私有 npm / maven 仓库凭证时,用 secret mount——只在构建进程内存中存在,不落镜像层。
# 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 .
$ docker buildx create --use # 启用多架构构建器 $ docker buildx build \ --platform linux/amd64,linux/arm64 \ -t yourname/app:1.0 --push .
常见问题 FAQ
点击展开问题与解决方案。
Q1permission denied 连接 Docker 守护进程›
当前用户不在 docker 组。执行 sudo usermod -aG docker $USER 后注销重新登录;macOS / Windows 使用 Desktop 无此问题。
Q2Cannot connect to the Docker daemon›
守护进程未启动:Linux 上 sudo systemctl start docker;Desktop 平台确认应用已运行。若配置了远程 DOCKER_HOST,检查网络与 TLS 证书。
Q3拉取镜像超时 / manifest unknown›
依次排查:① 网络受限 → 配置镜像加速器(见第 03 节);② tag 拼写 → docker manifest inspect nginx:1.27 验证存在性;③ 私有仓库 → 先 docker login。
Q4Bind for 0.0.0.0:8080 failed: port is already allocated›
宿主端口被占: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›
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。
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 管家」。
没有守护进程
podman run 由 CLI 进程直接创建容器,每个容器只配一个轻量 conmon 看护进程;不存在全局 daemon,也就没有全局单点与全局状态。
默认无 root 运行
普通用户直接运行容器,宿主侧全程不需要任何 root 权限:用户命名空间(userns)把容器内 root 映射为宿主普通用户,天然压缩攻击面。
兼容 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)完全通用。
| 时间 | 里程碑 | 与两者关系 |
|---|---|---|
| 2013 | Docker 开源,容器化浪潮起点 | 生态奠基者 |
| 2015 | OCI 联盟成立,镜像 / 运行时规范标准化 | 两者共同的「宪法」 |
| 2017 | containerd 捐赠 CNCF;K8s 以 CRI 标准对接运行时 | 生态与单一引擎解耦 |
| 2018 | Red Hat 发布 Podman 1.0(前身 libpod) | 主打无守护进程替代 |
| 2019 | RHEL 8 起官方默认引擎为 Podman | 企业发行版原生入场 |
| 2022 | K8s 1.24 移除 dockershim,运行时转向 containerd / CRI-O | 编排层两者均退居幕后 |
| 2024+ | Podman 5.x 与 Podman Desktop 成熟 | 在 OCI 标准下长期共存 |
所以「Podman 替代 Docker」更准确的说法是:Podman 替代的是 Docker Engine 那套 C/S 工具链,而不是替代容器本身——镜像、Dockerfile、OCI 标准原封不动,本指南讲的构建、网络、存储知识对两者同样适用。
核心差异对照
| 维度 | Docker | Podman |
|---|---|---|
| 架构模型 | C/S:CLI → REST API → 常驻 dockerd | Daemonless:CLI 进程直接创建容器 |
| 守护进程 | 必须常驻(传统以 root 运行;另有可选 rootless dockerd 模式) | 无:每个容器一个轻量 conmon 看护进程 |
| 运行权限 | root 或 docker 组(≈ root 权限) | 默认 rootless:普通用户即可,无需任何特权 |
| 安全模型 | root daemon 是单点:一旦失守波及全部容器 | userns 映射:宿主侧无 root,多用户之间互不可见 |
| 生命周期托管 | --restart 策略由 daemon 掌控 | systemd 原生托管(Quadlet),随系统开机自启 |
| 多容器编排 | Compose(官方)+ 内置 Swarm | podman 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 / Windows | Desktop 内置 Linux VM | podman machine init / start 管理轻量 VM |
定位雷达:怎么选,一目了然
ECHARTS · 定性示意 · 1–5 分分值为 1–5 的定性示意(非基准测试):Docker 胜在生态与开箱即用,Podman 胜在安全模型与 systemd 集成——不是谁碾压谁,而是「默认场景不同」。
命令几乎一致:迁移成本极低
# ① 别名包:装完后 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
| 能力 | Docker | Podman | 说明 |
|---|---|---|---|
| 运行 / 列出 / 构建 | docker run / ps / build | podman run / ps / build | 参数与行为基本一致 |
| 推拉镜像 | docker pull / push | podman pull / push | 同一 registry 通用 |
| Compose | docker compose | podman compose | Podman 需 Compose V2 或 podman-compose 兼容层 |
| 桌面 VM(macOS / Win) | Docker Desktop 内置 | podman machine init/start | 两者都在轻量 Linux VM 中跑容器 |
| systemd 托管 | 手写 unit 文件 | Quadlet / generate systemd | Podman 原生一等公民 |
| Pod / K8s YAML | — | podman pod · kube generate/play | Podman 独有 |
| docker 命令别名 | — | podman-docker 包 | 装完 docker 命令即 Podman |
[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
Quadlet(Podman 4.4+,推荐用法)让容器成为 systemd 原生单元:文件名即服务名,journalctl --user -u web 直接查日志;再配 loginctl enable-linger $USER,无需登录也能开机自启——这是「无守护进程」路线的杀手锏。
各自的应用场景
桌面开发 · CI/CD · 团队标准
- 开箱即用:Docker Desktop 一键安装,自带 GUI 与 K8s
- 生态最全:教程、CI 模板、第三方资料的事实标准
- Compose / Swarm:多容器编排官方一体化
- 商业支持完善(注意大型企业 Desktop 需付费订阅)
共享服务器 · 企业 Linux · 无 root
- 多用户隔离:每人 rootless 自治,宿主侧零特权、互不可见
- RHEL / Fedora 原生:系统默认引擎,无额外安装与订阅
- systemd 服务化:Quadlet 让容器像服务一样开机自启
- K8s 预演:pod 概念 + kube YAML 直接生成 / 回放
- 安全合规:不允许 root 常驻守护进程的环境
不必二选一:一套镜像,随时切换
- 镜像 / 仓库 / Dockerfile 完全互通,构建一次两边运行
- 开发机用 Docker、生产单机用 Podman 的组合很常见
- 脚本层面:换前缀或装别名包即可迁移
- 进了 Kubernetes 后都交给 containerd / CRI-O,CLI 之争到此为止
一句话选型:个人学习、桌面开发、CI 流水线 → Docker(生态与工具链最省心);共享 / 生产单机、多用户、无 root 与 systemd 环境 → Podman。更重要的结论是:两者共享 OCI 标准,镜像构建、网络、存储等核心知识完全通用——真正值得学的是容器本身,而非某一家 CLI。
参考来源
-
Docker Docs — Get Started & Core Concepts
https://docs.docker.com/get-started/ -
Dockerfile Reference(官方指令规范)
https://docs.docker.com/reference/dockerfile/ -
Compose File Reference(服务编排配置)
https://docs.docker.com/reference/compose-file/ -
Docker CLI Reference(命令行手册)
https://docs.docker.com/reference/cli/docker/ -
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/ -
Podman Documentation — Daemonless / Rootless / Quadlet
https://docs.podman.io/ · github.com/containers/podman -
本仓库《Docker 主要版本演进史 · 倒序时间轴(2013–2026)》
../docker-version-timeline/docker-version-timeline.html -
本地基线文档 docker-version-history.md(版本数据基线,截至 2026-10-29)
本地源文档(同目录上一级)