docker 搜索
| 描述 | 在 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 (布尔值 - true 或 false) - 镜像是否为自动构建（已弃用）
- is-official (布尔值 - 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