Docker镜像仓库常见命令详解

一、镜像搜索与拉取

1.1 搜索镜像

docker search命令是查找Docker Hub或私有仓库中镜像的首选工具，其基本语法为：

docker search [OPTIONS] TERM

常用参数包括：

--limit：限制返回结果数量（如--limit 5）
--no-trunc：显示完整描述
--filter：按星级（STARS）、是否官方（IS-OFFICIAL）等过滤

实战示例：

# 搜索官方Nginx镜像（按星级排序）
docker search --filter=is-official=true --limit 3 nginx
# 搜索包含"python"的镜像（显示完整描述）
docker search --no-trunc python

1.2 拉取镜像

docker pull命令用于从仓库下载镜像，支持指定标签（默认为latest）：

docker pull [OPTIONS] NAME[:TAG|@DIGEST]

关键参数：

--platform：指定架构（如linux/amd64）
--disable-content-trust：跳过镜像签名验证

最佳实践：

# 拉取特定版本的Ubuntu镜像
docker pull ubuntu:22.04
# 拉取多架构镜像（需Docker 19.03+）
docker pull --platform linux/arm64 nginx

二、镜像推送与标签管理

2.1 标记镜像

docker tag命令用于为镜像创建别名，格式为：

docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]

典型场景：

# 将本地镜像标记为私有仓库格式
docker tag myapp:v1 registry.example.com/myteam/myapp:v1
# 修改标签（不创建新镜像）
docker tag nginx:latest nginx:stable

2.2 推送镜像

docker push命令将镜像上传到仓库，需先通过docker login认证：

docker push [OPTIONS] NAME[:TAG]

注意事项：

镜像名称必须包含仓库地址（如registry.example.com/user/repo）
推送前需确保标签存在
私有仓库需配置TLS证书

完整流程示例：

# 登录私有仓库
docker login registry.example.com
# 标记并推送镜像
docker tag myapp:v1 registry.example.com/myteam/myapp:v1
docker push registry.example.com/myteam/myapp:v1

三、仓库认证与配置管理

3.1 登录/登出仓库

docker login和docker logout命令管理仓库认证：

# 登录（支持--username/--password参数，但推荐交互式输入）
docker login [SERVER]
# 登出
docker logout [SERVER]

安全建议：

避免在命令行直接传递密码
使用~/.docker/config.json管理凭证
定期轮换访问令牌

3.2 配置镜像加速器

国内用户可通过配置镜像加速器提升下载速度，修改/etc/docker/daemon.json：

{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://mirror.baidubce.com"
  ]
}

修改后需重启Docker服务：

sudo systemctl restart docker

四、高级管理命令

4.1 镜像清单操作

Docker 1.10+引入清单（Manifest）功能，支持多架构镜像管理：

# 查看镜像清单
docker manifest inspect nginx:latest
# 创建多架构镜像（需Docker Buildx）
docker buildx build --platform linux/amd64,linux/arm64 -t myapp:multi .

4.2 仓库内容清理

docker system prune命令可清理未使用的镜像、容器等资源：

# 清理所有未使用的资源
docker system prune -a
# 仅清理悬空镜像
docker image prune

生产环境建议：

定期执行清理（如每周）
结合--filter参数精准控制
备份重要镜像后再清理

五、私有仓库部署与管理

5.1 部署Registry

使用官方Registry镜像快速搭建私有仓库：

docker run -d -p 5000:5000 --name registry \
  -v /mnt/registry:/var/lib/registry \
  registry:2

高级配置：

添加基本认证：
```bash
mkdir -p auth
docker run —entrypoint htpasswd httpd:2 -Bbn username password > auth/htpasswd

docker run -d -p 5000:5000 —name registry \
-v /mnt/registry:/var/lib/registry \
-v $(pwd)/auth:/auth \
-e “REGISTRY_AUTH=htpasswd” \
-e “REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm” \
-e “REGISTRY_AUTH_HTPASSWD_PATH=/auth/htpasswd” \
registry:2


### 5.2 仓库镜像管理
通过API管理私有仓库内容：
```bash
# 列出所有镜像
curl -X GET http://registry.example.com/v2/_catalog
# 删除特定标签
curl -X DELETE http://registry.example.com/v2/myapp/manifests/sha256:abc123