科技 · 實用指南

Podman 顯示短映像名稱無法解析？修改全域搜尋前先證明 registry 與 alias

先區分本機映像與遠端 pull，檢查有效 alias 與 cache，再選完整名稱、範圍 alias 或核准的搜尋清單並驗證映像身份。

作者 Watch at Ease News · 2 分鐘閱讀發布於 2026年10月18日下午6:41 UTC

short-name failure 首先是 identity 問題；先保存 literal reference 與失敗 context。

安全順序是 local image、effective alias/cache、registry policy、最窄修復與來源驗證。

保存 literal reference 與 context

保存原 command 與 image text，記錄 Podman version、effective user、rootless/rootful、TTY 與完整 error。

不要憑記憶假設 docker.io；distro defaults 不同，CI/systemd 無法回答 prompt。

列出 local repository、tag、ID、digest；若 build/load/commit 產生映像，給它明確 local name。

若應使用 local image 就停止，registry 變更不能修錯 tag。

讀取該 user 的 user/system/drop-in config 與 alias cache，記錄 search list、mode、alias。

alias key/value 不含 tag/digest；user config 可能 override system policy。

automation 使用 fully qualified reference；穩定 shorthand 用 scoped alias；global search 只在明確核准時修改。

interactive prompt 不是 CI contract，不要只為靜音而降低 policy。

從同一 user/launcher 重跑，驗證 qualified name、ID、repository digest。

只有原 context 確定取得預期 image 且規則不過寬才算完成；不能證明就停止。