docker search

说明在 Docker Hub 中搜索镜像
用法docker search [OPTIONS] TERM

说明

在 Docker Hub 中搜索镜像

选项

选项默认值说明
-f, --filter根据提供的条件过滤输出
--format使用 Go 模板美化打印搜索结果
--limit最大搜索结果数
--no-trunc不截断输出

示例

按名称搜索镜像

此示例显示名称包含 'busybox' 的镜像

$ docker search busybox

NAME                             DESCRIPTION                                     STARS     OFFICIAL
busybox                          Busybox base image.                             316       [OK]
progrium/busybox                                                                 50
radial/busyboxplus               Full-chain, Internet enabled, busybox made...   8
odise/busybox-python                                                             2
azukiapp/busybox                 This image is meant to be used as the base...   2
ofayau/busybox-jvm               Prepare busybox to install a 32 bits JVM.       1
shingonoide/archlinux-busybox    Arch Linux, a lightweight and flexible Lin...   1
odise/busybox-curl                                                               1
ofayau/busybox-libc32            Busybox with 32 bits (and 64 bits) libs         1
peelsky/zulu-openjdk-busybox                                                     1
skomma/busybox-data              Docker image suitable for data volume cont...   1
elektritter/busybox-teamspeak    Lightweight teamspeak3 container based on...    1
socketplane/busybox                                                              1
oveits/docker-nginx-busybox      This is a tiny NginX docker image based on...   0
ggtools/busybox-ubuntu           Busybox ubuntu version with extra goodies       0
nikfoundas/busybox-confd         Minimal busybox based distribution of confd     0
openshift/busybox-http-app                                                       0
jllopis/busybox                                                                  0
swyckoff/busybox                                                                 0
powellquiring/busybox                                                            0
williamyeh/busybox-sh            Docker image for BusyBox's sh                   0
simplexsys/busybox-cli-powered   Docker busybox images, with a few often us...   0
fhisamoto/busybox-java           Busybox java                                    0
scottabernethy/busybox                                                           0
marclop/busybox-solr

显示未截断的说明 (--no-trunc)

此示例显示名称包含 'busybox'、至少 3 颗星且说明未截断的镜像

$ docker search --filter=stars=3 --no-trunc busybox

NAME                 DESCRIPTION                                                                               STARS     OFFICIAL
busybox              Busybox base image.                                                                       325       [OK]
progrium/busybox                                                                                               50
radial/busyboxplus   Full-chain, Internet enabled, busybox made from scratch. Comes in git and cURL flavors.   8

限制搜索结果数 (--limit)

--limit 标志指定搜索返回的最大结果数。如果未设置值，则使用守护进程设置的默认值。

过滤 (--filter)

过滤标志（-f 或 --filter）的格式为 key=value 对。如果存在多个过滤器，则传递多个标志（例如 --filter is-official=true --filter stars=3）。

当前支持的过滤器有

  • stars (int - 镜像拥有的星数)
  • is-automated (boolean - true 或 false) - 镜像是否自动化构建（已弃用）
  • is-official (boolean - true 或 false) - 镜像是否为官方镜像

stars

此示例显示名称包含 'busybox' 且至少有 3 颗星的镜像

$ docker search --filter stars=3 busybox

NAME                 DESCRIPTION                                     STARS     OFFICIAL
busybox              Busybox base image.                             325       [OK]
progrium/busybox                                                     50
radial/busyboxplus   Full-chain, Internet enabled, busybox made...   8

is-official

此示例显示名称包含 'busybox'、至少有 3 颗星且为官方构建的镜像

$ docker search --filter is-official=true --filter stars=3 busybox

NAME      DESCRIPTION           STARS     OFFICIAL
busybox   Busybox base image.   325       [OK]

格式化输出 (--format)

格式化选项（--format）使用 Go 模板美化打印搜索输出。

Go 模板的有效占位符有

占位符说明
.Name镜像名称
.Description镜像说明
.StarCount镜像的星数
.IsOfficial如果镜像是官方镜像，则显示“OK”
.IsAutomated如果镜像是自动化构建，则显示“OK”（已弃用）

使用 --format 选项时，search 命令将完全按照模板声明的方式输出数据。如果使用 table 指令，还将包含列标题。

以下示例使用不带标题的模板，并为所有镜像输出以冒号（:）分隔的 Name 和 StarCount 条目

$ docker search --format "{{.Name}}: {{.StarCount}}" nginx

nginx: 5441
jwilder/nginx-proxy: 953
richarvey/nginx-php-fpm: 353
million12/nginx-php: 75
webdevops/php-nginx: 70
h3nrik/nginx-ldap: 35
bitnami/nginx: 23
evild/alpine-nginx: 14
million12/nginx: 9
maxexcloo/nginx: 7

此示例输出表格格式

$ docker search --format "table {{.Name}}\t{{.IsOfficial}}" nginx

NAME                                     OFFICIAL
nginx                                    [OK]
jwilder/nginx-proxy
richarvey/nginx-php-fpm
jrcs/letsencrypt-nginx-proxy-companion
million12/nginx-php
webdevops/php-nginx