9.1 常用命令分类速查表：按任务场景归位
9.1 常用命令分类速查表：按任务场景归位
本节摘要：速查表的索引方式按"我想做什么"组织：装机验证、拉镜像、起容器、进容器、看状态、管数据、组网络、排错清理八大场景。每条命令附使用时机与出处部号，易混命令（ps 与 images、rm 与 rmi、save 与 export）单独对账。本节适合贴墙，也适合当作全书复习提纲。
工位墙上贴过另一本册子里的容器原理图，贴完一年没翻开过；真正天天用的是半张便签——上面全是命令。本节就是那半张便签的正式版：一张全书命令全景图加八张场景小表，每条命令的回答只有一句：什么时候用它。
全景地图：全书词条的一张图
场景小表：带语境的命令条目
装机与交接（壹部）：接手陌生机器，顺序固定——version 看版本错位，info 看容器与镜像存量，hello-world 验最小闭环。交接单上写清这三条的输出截图，能省后来人大量考古。
找镜像与造镜像（贰部）：search 加 is-official 初选，pull 显式标签；自研服务 build 加 -t 打可追溯的版本标签，顺手写 .dockerignore。镜像名里写明版本号，是对拉取端的基本礼貌。
起与进（叁部）：生产起容器五件套 -d --name --restart unless-stopped -p -v，样样有理由；进容器首选 exec -it 容器 bash，镜像精简没有 bash 时退而求次 sh，attach 留给要看主进程输出的特殊场合。
停与删（叁部、贰部）：对账口诀——容器 rm、镜像 rmi，两个字母之差对象全变；停容器用 stop 给善后窗口，rm 前确认取证结束。
易混命令对账表：
| 易混对 | 差别 | 一句话记忆 |
|---|---|---|
| ps 与 images | 容器清单与镜像清单 | ps 看进程态，images 看硬盘态 |
| rm 与 rmi | 删容器与删镜像 | 多的 i 是 image |
| stop 与 kill | 优雅停与强杀 | stop 先礼后兵，kill 直接拔电源 |
| save 与 export | 镜像包与容器快照 | save 保分层，export 是扁平盘 |
| restart 命令与 --restart | 手动按钮与自动策略 | 前者人按的，后者守护进程管的 |
| exec 与 attach | 开新进程与挂主进程 | 进去办事用 exec，看现场用 attach |
⚠️ 常见坑：速查表用久了容易"只记命令不记条件"——比如 rm 了还没取证完的异常容器。每条命令的完整义项与前置条件，回出处部核对；速查表负责快，不负责替你思考。
补全场景：状态、数据、网络、排错的速查段落
看状态与日志（叁部）：ps -a 是每场排错对话的开场白；stats --no-stream 取资源快照；logs 加 --tail 100 -f 看近期流；top 看容器内进程树。一行口诀：状态问 ps，资源问 stats，遗言问 logs，进程问 top。
| 想知道什么 | 命令 | 读什么 |
|---|---|---|
| 容器在不在、什么状态 | docker ps -a |
STATUS 列与退出码 |
| 此刻吃多少资源 | docker stats --no-stream |
CPU 与内存占限额比例 |
| 死前说了什么 | docker logs --tail 100 容器 |
最后的报错与堆栈 |
| 里面跑了哪些进程 | docker top 容器 |
PID 与命令行 |
管数据（伍部）：卷盘点用 volume ls 与 inspect，备份走临时容器套路；绑定挂载查容器 inspect 的 Mounts 数组；tmpfs 核对 HostConfig.Tmpfs 字段。数据命令纪律重于技巧：删卷先点名，备份后演练恢复。
组网络（陆部）：network ls 看有哪些网，inspect 看成员名单，connect 与 disconnect 动态进出；互访只记一句——自定义网络里容器名即主机名。
排错清理（捌部）：inspect --format 抽字段，events --since 回放时间线，system df 盘点，prune 分级收拾。取证链顺序不可乱：分类、遗言、档案、录像、盘点。
报错文案速查：看到什么字，先查哪条
求助帖的一半是报错文案。高频文案、病根与首查动作对照如下：
| 报错关键词 | 病根 | 首查动作 |
|---|---|---|
| port is already allocated | 宿主机端口被占 | docker ps 找占用者，或换映射端口 |
| The container name ... is already in use | 重名容器存在（多为停止态） | docker ps -a --filter name=xx 找到后 rm 或改名 |
| executable file not found | 入口命令路径不存在 | 核对镜像内路径与 COMMAND 拼写（3.1） |
| no such file or directory（挂载时） | 宿主路径不存在且用了 --mount | 检查 src 拼写（-v 会静默建目录，更危险） |
| permission denied（写挂载目录） | 容器用户与宿主文件属主错位 | 对齐 UID（5.2 坑一） |
| denied: requested access（push 时） | 引用名的地址或命名空间不对 | 先 images 核对引用名，再 login（4.3） |
| server gave HTTP response to HTTPS client | 私有仓库未放行 | 客户端 daemon.json 配 insecure-registries（4.2） |
| has active endpoints（删网时） | 网内还有容器 | 先 disconnect 或 rm 容器（6.2） |
| oom（events 里） | 内存限额触顶 | inspect 核 OOMKilled，调限额或修泄漏（捌部） |
| version is obsolete（compose） | 顶部 version 字段已废弃 | 删字段即可（柒部） |
这张表是"第一眼"工具：文案命中后仍要回对应部读完整词条再动手，免得按下葫芦浮起瓢。
本节要点回顾
- 索引按任务不按字母：八大场景覆盖日常九成操作，色块即出处。
- 交接三件套：version、info、hello-world，新机器与交接单的固定动作。
- 易混六对：rm 与 rmi、save 与 export 这类一字母之差的词条，用对账表钉死。
- 速查表不替代义项：拿不准就回出处部查完整词条与坑点。
下一节给速查表装上放大镜：format 模板与过滤谓词，让输出与查询都能按需定制。