清理Docker的container，image与volume · 零壹軒·笔记

# 清理Docker的container，image与volume

Docker的镜像（image）、容器（container）、数据卷（volume）， 都是由daemon托管的。 因此，在需要清理时，也需要使用其自带的手段。

本文介绍一些Docker的清理技巧，以及它们的来源。

## 清理技巧

清理所有停止运行的容器：

```
docker container prune
# or
docker rm $(docker ps -aq)

```

清理所有悬挂（`<none>`）镜像：

```
docker image prune
# or
docker rmi $(docker images -qf "dangling=true")

```

清理所有无用数据卷：

```
docker volume prune

```

由于`prune`操作是批量删除类的危险操作，所以会有一次确认。 如果不想输入`y<CR>`来确认，可以添加`-f`操作。慎用！

## 清理停止的容器
```
docker rm -lv CONTAINER

```

`-l`是清理link，`v`是清理volume。 这里的CONTAINER是容器的name或ID，可以是一个或多个。

参数列表：

Name, shorthand

Default

Description

–force, -f

false

Force the removal of a running container (uses SIGKILL)

–link, -l

false

Remove the specified link

–volumes, -v

false

Remove the volumes associated with the container

### 清理所有停止的容器

通过`docker ps`可以查询当前运行的容器信息。 而通过`docker ps -a`，可以查询所有的容器信息，包括已停止的。

在需要清理所有已停止的容器时，通常利用shell的特性，组合一下就好。

```
docker rm $(docker ps -aq)

```

其中，`ps`的`-q`，是只输出容器ID，方便作为参数让`rm`使用。 假如给`rm`指定`-f`，则可以清理所有容器，包括正在运行的。

这条组合命令，等价于另一条命令：

```
docker container prune

```

`container`子命令，下面包含了所有和容器相关的子命令。 包括`docker ps`，等价于`docker container ps`或`docker container ls`。 其余还有`start`、`stop`、`kill`、`cp`等，一级子命令相当于二级子命令在外面的alias。 而`prune`则是特别提供的清理命令，这在其它的管理命令里还可以看到，比如`image`、`volume`。

### 按需批量清理容器

清除所有已停止的容器，是比较常用的清理。 但有时会需要做一些特殊过滤。

这时就需要使用`docker ps --filter`。

比如，显示所有返回值为0，即正常退出的容器：

```
docker ps -a --filter 'exited=0'

```

同理，可以得到其它非正常退出的容器。

目前支持的过滤器有：

> -   id (container’s id)
> -   label (`label=<key>` or `label=<key>=<value>`)
> -   name (container’s name)
> -   exited (int - the code of exited containers. Only useful with –all)
> -   status (`created|restarting|running|removing|paused|exited|dead`)
> -   ancestor (`<image-name>[:<tag>]`, `<image id>` or `<image@digest>`) - filters containers that were created from the given image or a descendant.
> -   before (container’s id or name) - filters containers created before given id or name
> -   since (container’s id or name) - filters containers created since given id or name
> -   isolation (`default|process|hyperv`) (Windows daemon only)
> -   volume (volume name or mount point) - filters containers that mount volumes.
> -   network (network id or name) - filters containers connected to the provided network
> -   health (`starting|healthy|unhealthy|none`) - filters containers based on healthcheck status

### 清理失败

如果在清理容器时发生失败，通过重启Docker的Daemon，应该都能解决问题。

```
# systemd
sudo systemctl restart docker.service

# initd
sudo service docker restart

```

## 清理镜像

与清理容器的`ps`、`rm`类似，清理镜像也有`images`、`rmi`两个子命令。 `images`用来查看，`rmi`用来删除。

清理镜像前，应该确保该镜像的容器，已经被清除。

```
docker rmi IMAGE

```

其中，IMAGE可以是name或ID。 如果是name，不加TAG可以删除所有TAG。

另外，这两个命令也都属于alias。 `docker images`等价于`docker image ls`，而`docker rmi`等价于`docker image rm`。

### 按需批量清理镜像

与`ps`类似，`images`也支持`--filter`参数。

与清理相关，最常用的，当属`<none>`了。

```
docker images --filter "dangling=true"

```

这条命令，可以列出所有悬挂（dangling）的镜像，也就是显示为`<none>`的那些。

```
docker rmi $(docker images -qf "dangling=true")

```

这条组合命令，如果不写入Bash的alias，几乎无法使用。 不过还有一条等价命令，非常容易使用。

```
docker image prune

```

`prune`和`images`类似，也同样支持`--filter`参数。 其它的filter有：

> -   dangling (boolean - true or false)
> -   label (`label=<key>` or `label=<key>=<value>`)
> -   before (`<image-name>[:<tag>]`, `<image id>` or `<image@digest>`) - filter images created before given id or references
> -   since (`<image-name>[:<tag>]`, `<image id>` or `<image@digest>`) - filter images created since given id or references
> -   reference (pattern of an image reference) - filter images whose reference matches the specified pattern

### 清理所有无用镜像

这招要慎用，否则需要重新下载。

```
docker image prune -a

```

## 清理数据卷

数据卷不如容器或镜像那样显眼，但占的硬盘却可大可小。

数据卷的相关命令，都在`docker volume`中了。

一般用`docker volume ls`来查看，用`docker volume rm VOLUME`来删除一个或多个。

不过，绝大多数情况下，不需要执行这两个命令的组合。 直接执行`docker volume prune`就好，即可删除所有无用卷。

注意：**这是一个危险操作！甚至可以说，这是本文中最危险的操作！** 一般真正有价值的运行数据，都在数据卷中。 （当然也可能挂载到了容器外的文件系统里，那就没关系。） 如果在关键服务停止期间，执行这个操作，很可能会**丢失所有数据**！

## 从文件系统删除

除配置文件以为，Docker的内容相关文件，基本都放在`/var/lib/docker/`目录下。

该目录下有下列子目录，基本可以猜测出用途：

-   aufs
-   containers
-   image
-   network
-   plugins
-   swarm
-   tmp
-   trust
-   volumes

一般不推荐直接操作这些目录，除非一些极特殊情况。 操作不当，后果难料，需要慎重。

## 参考

本文发布时的Docker版本：**17.05.0-ce**，API版本：**1.29**。 在一些比较老的版本，文中提到的一些做法未必可行。

-   [docker rm | Docker Documentation](https://docs.docker.com/engine/reference/commandline/rm/)
-   [docker ps | Docker Documentation](https://docs.docker.com/engine/reference/commandline/ps/)
-   [docker images | Docker Documentation](https://docs.docker.com/engine/reference/commandline/images/)
-   [docker rmi | Docker Documentation](https://docs.docker.com/engine/reference/commandline/rmi/)
-   [docker volume ls | Docker Documentation](https://docs.docker.com/engine/reference/commandline/volume_ls/)
-   [docker volume rm | Docker Documentation](https://docs.docker.com/engine/reference/commandline/volume_rm/)
-   [docker volume prune | Docker Documentation](https://docs.docker.com/engine/reference/commandline/volume_prune/)