Podman拉取Docker Hub官方镜像报404或格式错误如何解决？

核心错误原因 #

你之前使用的命令存在两个核心问题：

• Docker Hub的网页端域名hub.docker.com不是容器镜像注册中心的API接口域名，实际镜像拉取需要使用的注册中心域名为docker.io
• Docker Hub官方镜像统一存放于library命名空间下，使用下划线_/__的路径写法不符合官方命名规则

正确拉取方式 #

方式1：简化写法（推荐） #

Podman默认配置会将Docker Hub加入镜像搜索源列表，拉取官方镜像直接写镜像名即可，可按需指定版本标签：

# 拉取postgres最新版官方镜像
podman pull postgres
# 拉取指定版本的官方镜像
podman pull postgres:16-alpine

如果简化写法失效，检查/etc/containers/registries.conf配置文件，确认unqualified-search-registries配置项的列表中包含docker.io即可。

方式2：完整注册中心路径写法 #

如果需要明确指定注册中心，使用如下格式：

# 通用格式：podman pull docker.io/library/[镜像名]
podman pull docker.io/library/postgres

非官方镜像拉取规则 #

如果要拉取Docker Hub上个人/组织发布的非官方镜像，对应格式如下：

# 简化写法
podman pull [用户名/组织名]/[镜像名]:[标签]
# 完整路径写法
podman pull docker.io/[用户名/组织名]/[镜像名]:[标签]

拉取完成后可执行podman images命令验证镜像是否存在于本地镜像列表。

内容的提问来源于stack exchange，提问作者Antony Hutchison