NAME¶ 名称

podman-image-prune - Remove all unused images from the local store
podman-image-prune - 从本地存储中删除所有未使用的镜像

SYNOPSIS¶ 概要

podman image prune [options]
podman image prune [选项]

DESCRIPTION¶ 描述

podman image prune removes all dangling images from local storage. With the all option, all unused images are deleted (i.e., images not in use by any container).
podman image prune 从本地存储中删除所有悬空镜像。使用 all 选项，将删除所有未使用的镜像（即，任何容器都不使用的镜像）。

The image prune command does not prune cache images that only use layers that are necessary for other images.
image prune 命令不会清理仅被其他镜像所需层使用的缓存镜像。

OPTIONS¶ 选项

--all, -a¶

Remove dangling images and images that have no associated containers.
删除悬空镜像和没有关联容器的镜像。

--external¶ --外部 ¶

Remove images even when they are used by external containers (e.g., build containers).
即使被外部容器（例如构建容器）使用，也会删除镜像。

--filter=filters¶

Provide filter values. 提供过滤器值。

The filters argument format is of key=value. If there is more than one filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.
过滤器参数格式为 key=value 。如果有多个过滤器，则传递多个选项：--filter foo=bar --filter bif=baz。

Supported filters: 支持的过滤器：

Filter	Description
label	Only remove images, with (or without, in the case of label!=[…] is used) the specified labels. 仅删除带有（或不带有，在使用 label！=[…] 的情况下）指定标签的图像。
until	Only remove images created before given timestamp. 仅删除在给定时间戳之前创建的图像。

The label filter accepts two formats. One is the label=key or label=key=value, which removes containers with the specified labels. The other format is the label!=key or label!=key=value, which removes containers without the specified labels.
label 过滤器接受两种格式。一种是 label =key 或 label =key=value，用于移除具有指定标签的容器。另一种格式是 label! =key 或 label! =key=value，用于移除不具有指定标签的容器。

The until filter can be Unix timestamps, date formatted timestamps or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.
until 过滤器可以是 Unix 时间戳、日期格式化的时间戳或相对于机器时间计算的 Go 时长字符串（例如 10m，1h30m）。

--force, -f¶

Do not provide an interactive prompt for container removal.
不要为容器删除提供交互提示。

--help, -h¶ --help，-h ¶

Print usage statement 打印使用说明

EXAMPLES¶ 示例

Remove all dangling images from local storage:
从本地存储中删除所有悬空镜像：

$ sudo podman image prune

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907

Remove all unused images from local storage without confirming:
从本地存储中删除所有未使用的镜像，无需确认：

$ sudo podman image prune -a -f
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
6125002719feb1ddf3030acab1df6156da7ce0e78e571e9b6e9c250424d6220c
91e732da5657264c6f4641b8d0c4001c218ae6c1adb9dcef33ad00cafd37d8b6
e4e5109420323221f170627c138817770fb64832da7d8fe2babd863148287fca
77a57fa8285e9656dbb7b23d9efa837a106957409ddd702f995605af27a45ebe

Remove all unused images from local storage since given time/hours:
自指定时间/小时起删除本地存储中的所有未使用图像

$ sudo podman image prune -a --filter until=2019-11-14T06:15:42.937792374Z

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y
e813d2135f17fadeffeea8159a34cfdd4c30b98d8111364b913a91fd930643e9
5e6572320437022e2746467ddf5b3561bf06e099e8e6361df27e0b2a7ed0b17b
58fda2abf5042b35dfe04e5f8ee458a3cc26375bf309efb42c078b551a2055c7
6d2bd30fe924d3414b64bd3920760617e6ced872364bc3bc6959a623252da002
33d1c829be64a1e1d379caf4feec1f05a892c3ef7aa82c0be53d3c08a96c59c5
f9f0a8a58c9e02a2b3250b88cc5c95b1e10245ca2c4161d19376580aaa90f55c
1ef14d5ede80db78978b25ad677fd3e897a578c3af614e1fda608d40c8809707
45e1482040e441a521953a6da2eca9bafc769e15667a07c23720d6e0cafc3ab2

$ sudo podman image prune -f --filter until=10h
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907

Remove all unused images from local storage with label version 1.0:
使用标签版本 1.0 从本地存储中删除所有未使用图像

$ sudo podman image prune -a -f --filter label=version=1.0
e813d2135f17fadeffeea8159a34cfdd4c30b98d8111364b913a91fd930643e9
5e6572320437022e2746467ddf5b3561bf06e099e8e6361df27e0b2a7ed0b17b
58fda2abf5042b35dfe04e5f8ee458a3cc26375bf309efb42c078b551a2055c7
6d2bd30fe924d3414b64bd3920760617e6ced872364bc3bc6959a623252da002
33d1c829be64a1e1d379caf4feec1f05a892c3ef7aa82c0be53d3c08a96c59c5
f9f0a8a58c9e02a2b3250b88cc5c95b1e10245ca2c4161d19376580aaa90f55c
1ef14d5ede80db78978b25ad677fd3e897a578c3af614e1fda608d40c8809707
45e1482040e441a521953a6da2eca9bafc769e15667a07c23720d6e0cafc3ab2

HISTORY¶ 历史 ¶

December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com) December 2020, converted filter information from docs.docker.com documentation by Dan Walsh (dwalsh at redhat dot com)
2018 年 12 月，最初由 Brent Baude（bbaude at redhat dot com）编写。2020 年 12 月，由 Dan Walsh（dwalsh at redhat dot com）从 docs.docker.com 文档中转换过滤器信息。