Path: 宝塔面板 API 参考 › Docker

`GET /btdocker/image/search`

搜索 Docker Hub 上的公开镜像。

## Query parameters

- `opGetBtdockerImageSearch.query.request_time` (string, required) — Unix 时间戳。
- `opGetBtdockerImageSearch.query.request_token` (string, required) — 按 API 概览中的双重 MD5 签名算法生成。
- `opGetBtdockerImageSearch.query.keyword` (string, required) — 搜索关键词，如 `nginx`

## Code samples

### cURL（填写面板地址与签名）

```curl
curl --request GET \
  --url "https://your-panel.example.com:8888/btdocker/image/search" \
  --get \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "keyword=<keyword>"
```

## Responses

### default

接口响应，业务状态见下方详细说明。

#### Example

```json
[
  {
    "name": "nginx",
    "description": "Nginx的官方版本。",
    "star_count": 19712,
    "is_official": 1
  }
]
```


## search (镜像)

搜索 Docker Hub 上的公开镜像。

- **路由**：`GET /btdocker/image/search`

## 输入参数

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| keyword | 是 | String | 搜索关键词，如 `nginx` |

## 输出参数

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| - | Array&lt;Object&gt; | 搜索结果，每项含 `name`、`description`、`star_count`、`is_official` |

## 示例

```json
[{"name": "nginx", "description": "Nginx的官方版本。", "star_count": 19712, "is_official": 1}]
```