Podman配置私有仓库凭证后可无感拉取镜像；需确认仓库支持Registry v2协议、启用TLS，通过podman login写入auth.json，或手动配置Base64认证信息，测试环境可配置insecure registry。
在 Podman 中配置私有仓库凭证后，就能像拉取 Docker Hub 镜像一样无感拉取私有镜像，无需每次输入用户名密码或加 --authfile 参数。
确认私有仓库支持标准 Registry v2 协议
Podman 的认证机制依赖于符合 OCI/Docker Registry v2 规范的私有仓库（如 Harbor、Nexus Repository、GitLab Container Registry、自建 registry:2）。若使用非标实现（如某些定制化镜像服务），可能无法通过标准方式登录。
- 检查仓库是否可通过
curl -I https://your-registry.example.com/v2/返回200 OK或401 Unauthorized - 确保仓库启用了 TLS（Podman 默认拒绝 HTTP 仓库，除非显式配置
insecure = true）
使用 podman login 写入认证凭据
这是最直接、推荐的方式。Podman 会将加密后的凭据写入本地认证文件（默认为 $HOME/.config/containers/auth.json），后续所有操作自动复用。
- 执行登录：
podman login your-registry.example.com，按提示输入用户名和密码 - 若使用 token 或 robot account（如 Harbor robot account），同样适用，Podman 不区分认证类型
- 登录成功后，可查看凭据：
cat $HOME/.config/containers/auth.json | jq '.auths."your-registry.example.com".auth'（需安装 jq） - 注意：
podman login默认作用于当前用户；root 用户需单独运行sudo podman login
手动配置 auth.json（适合批量部署或 CI 场景）
当无法交互式登录（如容器内、自动化脚本），可预先生成并注入 auth.json。
- 格式示例（Base64 编码的
username:password）：{ "auths": { "your-registry.example.com": { "auth": "dXNlcjpwYXNz" } } } - 生成 auth 字段：
echo -n 'user:pass' | base64 - 确保文件权限为
600：chmod 600 $HOME/.config/containers/auth.json - 若使用非默认路径，可通过
--authfile /path/to/auth.json指定，但拉取时仍需显式传参，无法做到“无感”
配置不安全仓库（仅限测试环境）
若私有仓库使用自签名证书或 HTTP 协议，需额外配置跳过校验，否则 podman login 和拉取均会失败。
- 编辑
/etc/containers/registries.conf（系统级）或$HOME/.config/containers/registries.conf（用户级） - 添加 insecure registry 配置：
[[registry]]<br>location = "your-registry.example.com"<br>insecure = true
- 若用自签名证书，把 CA 证书放入
/etc/containers/certs.d/your-registry.example.com:443/ca.crt，无需设insecure = true
