科技 · 实用指南
Podman 提示短镜像名无法解析？修改全局搜索顺序前先证明注册表和别名
先区分本地镜像与远程拉取，检查生效的别名和缓存，再选择完整限定名、局部别名或获批搜索列表，并核验最终镜像身份。
短名称失败首先是身份问题，其次才是配置问题；先保存原始引用和失败上下文。
安全顺序是本地镜像、生效别名与缓存、注册表政策、最窄修复，最后核验来源。
保存原始引用与执行上下文
保存原命令和镜像文本。`alpine` 等短名称省略注册表，也可能把命名空间交给政策；记录 Podman 版本、有效用户、rootless/rootful、TTY 和完整错误。
不要凭记忆改写成 docker.io。发行版默认值不同，CI 或 systemd 不能回答交互提示。
证明目标是否已在本地
列出本地镜像的仓库、标签、ID 与摘要；若 build、load 或 commit 创建了镜像，就赋予明确本地仓库名并使用该身份。
若任务应使用本地镜像就在此停止；注册表改动不能修复错误标签，远程拉取还可能得到别的发布者。
审计生效配置和别名缓存
读取失败用户实际使用的用户、系统与 drop-in 配置，记录搜索列表、模式、别名与缓存选择；rootless 与 rootful 可能不同。
别名键值不能带标签或摘要；查找时会剥离它们再附加到目标。用户配置还可能覆盖系统政策。
选择最窄的确定性修复
自动化应使用完整注册表、命名空间和镜像；稳定缩写可使用审查过的别名；只有管理员明确授权时才改全局搜索列表。
交互提示不是 CI 合同；不要仅为消除错误而降低解析模式。
核验解析来源并闭环
通过同一用户和启动器重跑，检查仓库摘要、镜像 ID 与限定名称，并与预期发布者或部署记录比对。
完成标准是原上下文确定地得到目标镜像，规则没有过度放宽，并留下回滚说明；无法证明注册表或命名空间时应停止。
