434 lines
10 KiB
Markdown
434 lines
10 KiB
Markdown
---
|
||
tags:
|
||
- docker
|
||
- devops
|
||
- containerization
|
||
- reference
|
||
create time: 2026-04-28 14:40
|
||
---
|
||
|
||
# Docker 常用命令
|
||
|
||
> 按「容器生命周期」组织的命令速查手册。从拉取镜像到清理收尾，日常 90% 的操作都在以下命令中。建议收藏，用时直接翻。
|
||
|
||
## 概述
|
||
|
||
Docker 的命令体系看似庞杂，但本质上围绕四个核心对象展开：**镜像（Image）→ 容器（Container）→ 网络（Network）→ 数据卷（Volume）**。
|
||
|
||
> [!tip] 记忆框架
|
||
> 理解这个生命周期，所有命令就不需要死记了：
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
A["拉取镜像"] --> B["构建镜像"]
|
||
B --> C["运行容器"]
|
||
C --> D["调试/监控"]
|
||
D --> E["停止/删除"]
|
||
E --> F["清理回收"]
|
||
F --> A
|
||
|
||
style A fill:#e3f2fd
|
||
style B fill:#fff3e0
|
||
style C fill:#e8f5e9
|
||
style D fill:#f3e5f5
|
||
style E fill:#fce4ec
|
||
style F fill:#efebe9
|
||
```
|
||
|
||
---
|
||
|
||
## 正文
|
||
|
||
### 一、镜像管理（Image）
|
||
|
||
> [!info] 镜像 = 只读模板
|
||
> 镜像是容器的"蓝图"。同一个镜像可以运行多个容器实例，它们互不影响。
|
||
|
||
```bash
|
||
# 拉取镜像
|
||
docker pull nginx:latest # 拉取最新标签
|
||
docker pull redis:7-alpine # 拉取精简版（alpine 体积更小）
|
||
docker pull node:20-slim
|
||
|
||
# 查看所有镜像
|
||
docker images # 或 docker image ls
|
||
|
||
# 搜索镜像
|
||
docker search nginx # 搜索官方和社区镜像
|
||
|
||
# 给镜像打标签
|
||
docker tag my-app:latest myrepo/my-app:v1.0
|
||
|
||
# 删除镜像
|
||
docker rmi nginx # 删除单个
|
||
docker rmi $(docker images -q) # 删除所有镜像（谨慎！）
|
||
|
||
# 构建镜像
|
||
docker build -t my-app:v1.0 . # 当前目录构建（默认用 Dockerfile）
|
||
docker build -t my-app:v1.0 -f Dockerfile.prod . # 指定 Dockerfile
|
||
```
|
||
|
||
> [!tip] 镜像分层缓存
|
||
> `docker build` 从上到下逐行执行，每一行都会生成一层缓存。把**不变的部分放前面**（安装依赖），**变化的部分放后面**（复制代码），充分利用缓存加速。
|
||
|
||
---
|
||
|
||
### 二、容器管理（Container）
|
||
|
||
> [!abstract] 容器 = 镜像的运行实例
|
||
> 容器是轻量级、隔离的进程。删除容器 = 停止进程 + 释放资源，容器内部写入的数据默认会丢失（除非挂载了 Volume）。
|
||
|
||
```bash
|
||
# 运行容器
|
||
docker run -d -p 8080:80 --name web nginx
|
||
# -d 后台运行（detached）
|
||
# -p 8080:80 宿主机端口:容器端口
|
||
# --name 容器名称（方便后续操作）
|
||
|
||
# 前台运行（查看日志用）
|
||
docker run -it --rm nginx bash
|
||
# -i 交互式 -t 终端 --rm 退出后自动删除
|
||
|
||
# 查看所有容器（含已停止的）
|
||
docker ps -a # 或 docker container ls -a
|
||
|
||
# 查看运行中的容器
|
||
docker ps
|
||
|
||
# 启动/停止/重启容器
|
||
docker start web
|
||
docker stop web # 优雅停止（发 SIGTERM，等 10s 后 SIGKILL）
|
||
docker restart web
|
||
docker kill web # 强制停止（发 SIGKILL）
|
||
|
||
# 进入运行中的容器
|
||
docker exec -it web bash # 在运行中的容器里执行命令
|
||
docker exec -it web sh # 有些精简镜像没有 bash，用 sh
|
||
|
||
# 删除容器
|
||
docker rm web # 删除已停止的容器
|
||
docker rm -f web # 强制删除运行中的容器
|
||
|
||
# 查看容器日志
|
||
docker logs web
|
||
docker logs -f web # 实时跟踪日志（类似 tail -f）
|
||
docker logs --tail 100 web # 只看最后 100 行
|
||
```
|
||
|
||
**`docker run` 常用参数速查：**
|
||
|
||
| 参数 | 作用 |
|
||
|------|------|
|
||
| `-d` | 后台运行 |
|
||
| `-p host:container` | 端口映射 |
|
||
| `-v host:container` | 挂载卷 |
|
||
| `-e KEY=VALUE` | 设置环境变量 |
|
||
| `--name` | 容器名称 |
|
||
| `--network` | 指定网络 |
|
||
| `--restart=always` | 容器崩溃/开机自动重启 |
|
||
| `--rm` | 退出后自动删除（临时调试用） |
|
||
| `-it` | 交互式终端 |
|
||
| `--gpus all` | 启用 GPU（NVIDIA） |
|
||
|
||
---
|
||
|
||
### 三、网络管理（Network）
|
||
|
||
> [!question] 为什么容器能互相"看见"？
|
||
> 答：Docker 为每个容器分配独立 IP，同一网络下的容器可以通过**容器名**（自动 DNS 解析）互相通信。
|
||
|
||
```bash
|
||
# 查看所有网络
|
||
docker network ls
|
||
|
||
# 创建自定义网络
|
||
docker network create my-network
|
||
|
||
# 容器加入指定网络
|
||
docker run -d --name web1 --network my-network nginx
|
||
docker run -d --name db1 --network my-network mysql
|
||
|
||
# 容器间通过名称互相访问（自动 DNS 解析）
|
||
docker exec web1 ping db1 # 在同一网络下可直接 ping 容器名
|
||
|
||
# 删除网络
|
||
docker network rm my-network
|
||
```
|
||
|
||
> [!note] 为什么需要自定义网络？
|
||
> Docker 默认的 `bridge` 网络不支持容器名 DNS 解析。自定义网络可以让容器通过**名字**互相通信。
|
||
|
||
---
|
||
|
||
### 四、数据卷（Volume）
|
||
|
||
> [!danger] 容器是易失的（ephemeral）
|
||
> 删除容器 = 容器内数据消失！必须用 `-v` 把数据持久化到 Volume 或宿主机目录。
|
||
|
||
```bash
|
||
# 查看所有卷
|
||
docker volume ls
|
||
|
||
# 创建卷
|
||
docker volume create my-data
|
||
|
||
# 挂载卷到容器
|
||
docker run -d -v my-data:/data --name app nginx
|
||
|
||
# 挂载宿主机目录到容器（bind mount）
|
||
docker run -d -v /host/path:/container/path nginx
|
||
|
||
# 只读挂载
|
||
docker run -d -v my-data:/data:ro nginx
|
||
|
||
# 查看卷详情
|
||
docker volume inspect my-data
|
||
```
|
||
|
||
---
|
||
|
||
### 五、日志与调试
|
||
|
||
```bash
|
||
# 进入容器
|
||
docker exec -it <容器名> bash
|
||
|
||
# 查看容器资源占用
|
||
docker stats
|
||
|
||
# 查看容器详情（JSON 格式）
|
||
docker inspect web
|
||
|
||
# 查看容器进程
|
||
docker top web
|
||
|
||
# 拷贝文件进出容器
|
||
docker cp container.log web:/tmp/
|
||
docker cp web:/tmp/remote.log ./local.log
|
||
|
||
# 查看镜像构建历史
|
||
docker history my-app:v1.0
|
||
```
|
||
|
||
---
|
||
|
||
### 六、清理命令（重要！）
|
||
|
||
> [!warning] 磁盘占用会持续增长
|
||
> 停止的容器、未使用的镜像、悬空卷会悄悄吃掉磁盘空间。定期清理是好习惯。
|
||
|
||
```bash
|
||
# 删除所有已停止的容器
|
||
docker container prune
|
||
|
||
# 删除所有未使用的镜像
|
||
docker image prune -a
|
||
|
||
# 删除所有未使用的卷
|
||
docker volume prune
|
||
|
||
# 一键清理（容器+镜像+卷+网络，谨慎使用）
|
||
docker system prune -a
|
||
|
||
# 查看磁盘占用
|
||
docker system df
|
||
```
|
||
|
||
---
|
||
|
||
### 七、常用完整命令场景
|
||
|
||
#### 7.1 运行 Nginx
|
||
|
||
```bash
|
||
docker run -d \
|
||
-p 80:80 \
|
||
-v ./nginx.conf:/etc/nginx/nginx.conf:ro \
|
||
-v ./html:/usr/share/nginx/html \
|
||
--name my-nginx \
|
||
--restart=always \
|
||
nginx:alpine
|
||
```
|
||
|
||
#### 7.2 运行 MySQL
|
||
|
||
```bash
|
||
docker run -d \
|
||
-p 3306:3306 \
|
||
-e MYSQL_ROOT_PASSWORD=root123 \
|
||
-e MYSQL_DATABASE=mydb \
|
||
-v mysql-data:/var/lib/mysql \
|
||
--name my-mysql \
|
||
--restart=always \
|
||
mysql:8.0
|
||
```
|
||
|
||
#### 7.3 运行 Redis
|
||
|
||
```bash
|
||
docker run -d \
|
||
-p 6379:6379 \
|
||
-v redis-data:/data \
|
||
--name my-redis \
|
||
--restart=always \
|
||
redis:7-alpine redis-server --appendonly yes
|
||
```
|
||
|
||
#### 7.4 运行 Node 开发环境
|
||
|
||
```bash
|
||
docker run -it \
|
||
-p 3000:3000 \
|
||
-v $(pwd):/app \
|
||
-w /app \
|
||
node:20 \
|
||
bash
|
||
# -v $(pwd):/app 挂载项目目录，修改代码实时生效
|
||
# -w /app 设置工作目录
|
||
```
|
||
|
||
---
|
||
|
||
### 八、进阶：Docker 网络模式
|
||
|
||
Docker 提供四种网络模式：
|
||
|
||
| 模式 | 特点 | 适用场景 |
|
||
|------|------|----------|
|
||
| `bridge`（默认） | 容器有独立 IP | 大多数场景 |
|
||
| `host` | 共享宿主机网络，性能最好 | 高性能需求 |
|
||
| `none` | 无网络（完全隔离） | 安全隔离 |
|
||
| `container` | 共享另一个容器的网络命名空间 | 特殊协作 |
|
||
|
||
```bash
|
||
# bridge（默认）
|
||
docker run -d --network bridge nginx
|
||
|
||
# host
|
||
docker run -d --network host nginx
|
||
|
||
# none
|
||
docker run -d --network none nginx
|
||
|
||
# container（共享 web 容器的网络）
|
||
docker run -d --network container:web nginx
|
||
|
||
# 推荐：自定义 bridge 网络
|
||
docker network create my-net
|
||
docker run -d --network my-net --name app nginx
|
||
```
|
||
|
||
---
|
||
|
||
### 九、进阶：日志驱动
|
||
|
||
```bash
|
||
# 查看容器的日志配置
|
||
docker inspect web | grep LogConfig
|
||
```
|
||
|
||
| 驱动类型 | 说明 |
|
||
|----------|------|
|
||
| `json-file` | 默认，日志写入文件 |
|
||
| `local` | 循环写入，控制大小 |
|
||
| `syslog` | 发送到 syslog |
|
||
| `journald` | 发送到 systemd journal |
|
||
| `none` | 不记录日志 |
|
||
|
||
```yaml
|
||
# docker-compose 中限制日志大小
|
||
services:
|
||
api:
|
||
logging:
|
||
driver: json-file
|
||
options:
|
||
max-size: "10m" # 单个日志文件最大 10MB
|
||
max-file: "3" # 最多保留 3 个文件
|
||
```
|
||
|
||
---
|
||
|
||
### 十、进阶：资源限制
|
||
|
||
> [!tip] 为什么需要限制资源？
|
||
> 防止某个容器吃光 CPU/内存导致宿主机崩溃，这是多容器环境的必修课。
|
||
|
||
```bash
|
||
# 限制 CPU 和内存
|
||
docker run -d \
|
||
--cpus="1.5" \
|
||
--memory="512m" \
|
||
--memory-swap="1g" \
|
||
--pids-limit=100 \
|
||
nginx
|
||
# --cpus 限制 1.5 个 CPU 核心
|
||
# --memory 限制 512MB 内存
|
||
# --memory-swap 允许使用的 swap 总量
|
||
# --pids-limit 最多 100 个进程（防 fork 炸弹）
|
||
```
|
||
|
||
---
|
||
|
||
### 十一、进阶：Docker Swarm（简易集群）
|
||
|
||
> [!info] Swarm vs Kubernetes
|
||
> Swarm 适合单节点或小团队快速上手。大规模生产环境建议直接用 Kubernetes。
|
||
|
||
```bash
|
||
# 初始化集群（单节点）
|
||
docker swarm init
|
||
|
||
# 查看节点
|
||
docker node ls
|
||
|
||
# 创建服务（Swarm 管理方式）
|
||
docker service create --name web -p 80:80 --replicas 3 nginx
|
||
|
||
# 扩容
|
||
docker service scale web=5
|
||
|
||
# 查看服务
|
||
docker service ls
|
||
|
||
# 零停机滚动更新
|
||
docker service update --image nginx:1.25 web
|
||
|
||
# 删除服务
|
||
docker service rm web
|
||
|
||
# 退出集群
|
||
docker swarm leave
|
||
|
||
# 多节点集群
|
||
docker swarm init --advertise-addr <IP>
|
||
docker swarm join-token manager # 获取管理节点令牌
|
||
docker swarm join-token worker # 获取工作节点令牌
|
||
```
|
||
|
||
---
|
||
|
||
## 快速速查表
|
||
|
||
| 操作 | 命令 |
|
||
|------|------|
|
||
| 启动 Docker 服务 | `systemctl start docker` |
|
||
| 查看版本 | `docker --version` |
|
||
| 查看信息 | `docker info` |
|
||
| 登录镜像仓库 | `docker login` |
|
||
| 推送镜像 | `docker push my-app:v1.0` |
|
||
| 导出镜像 | `docker save -o my-app.tar my-app:v1.0` |
|
||
| 导入镜像 | `docker load -i my-app.tar` |
|
||
| 查看容器日志 | `docker logs -f <容器名>` |
|
||
| 进入容器 | `docker exec -it <容器名> bash` |
|
||
| 停止所有容器 | `docker stop $(docker ps -q)` |
|
||
| 删除所有容器 | `docker rm -f $(docker ps -aq)` |
|
||
| 查看磁盘占用 | `docker system df` |
|
||
| 全面清理 | `docker system prune -a` |
|
||
|
||
---
|
||
|
||
## 关联笔记
|
||
|
||
- [[Dockerfile编写指南]] — 编写高效的 Dockerfile
|
||
- [[docker-compose]] — 用 Compose 编排多容器应用
|