Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

3.5. 配置短名称别名

红帽建议始终通过其完全限定名称拉取镜像。但是，通常按短名称拉取镜像。例如，您可以使用 ubi8 而不是 registry.access.redhat.com/ubi8:latest。

registries.conf 文件允许为短名称指定别名，使管理员能够完全控制从何处拉取镜像。别名在 [aliases] 表中指定，格式为 "name" = "value" 。您可以在 /etc/containers/registries.conf.d 目录中看到别名列表。红帽在此目录中提供了一组别名。例如，podman pull ubi8 直接解析到正确的镜像，即 registry.access.redhat.com/ubi8:latest。

例如： 

unqualified-search-registries=["registry.fedoraproject.org", “quay.io"]

[aliases]
"fedora"="registry.fedoraproject.org/fedora"
Copy to Clipboard Toggle word wrap

简短名称模式为：

  • enforcing ：如果在镜像拉取过程中未找到匹配的别名，Podman 会提示用户选择一个非限定搜索注册表。如果所选镜像拉取成功，Podman 将自动在 $HOME/.cache/containers/short-name-aliases.conf 文件（非 root 用户）或在 /var/cache/containers/short-name-aliases.conf （root 用户）中记录一个新的短名称别名。如果无法提示用户（例如，stdin 或 stdout 而不是 TTY），则 Podman 会失败。请注意，如果都指定了同一别名，short-name-aliases.conf 文件优先于 registries.conf 文件。
  • permissive ：与 enforcing 模式类似，但如果用户无法得到提示，Podman 不会失败。相反，Podman 会按照指定顺序搜索所有非限定 registry。请注意，没有记录别名。
  • disabled ：以给定顺序尝试所有非限定搜索注册表，不会记录任何别名。
注意

红帽建议使用包括注册中心、命名空间、镜像名称和标签的完全限定镜像名称。在使用短名称时，通常会存在欺骗风险。添加受信任的注册表，也就是不允许未知或匿名用户创建任意名称帐户的注册表。例如，用户希望从 example.registry.com registry 中拉取示例容器镜像。如果 example.registry.com 不是搜索列表中的第一个，则攻击者可以将不同的示例镜像放在搜索列表较前的注册中心中。用户会意外拉取并运行攻击者的镜像，而不是预期的内容。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat