使用Podman无法推送镜像至本地Registry求助

排查步骤 #

1. 确认本地Registry服务状态 #

• 检查Registry容器/进程是否运行：

  # 容器运行的Registry
  podman ps | grep registry
  # 检查端口监听情况
  ss -tulnp | grep 5030
  

• 查看Registry日志排查服务报错：

  podman logs <registry-container-id>
  

• 确认端口映射正确性：默认Registry容器监听5000端口，若映射到5030，启动命令需包含-p 5030:5000

2. 验证Registry服务响应能力 #

• 重启Registry服务后重新测试：

  podman restart <registry-container-id>
  # 二进制运行的服务执行对应重启命令
  

• 用telnet测试服务是否能处理请求：

  telnet localhost 5030
  

  连接后输入GET /v2/ HTTP/1.1\nHost: localhost:5030\n\n，若无响应则说明服务存在异常。

3. 确保Podman配置生效 #

• 重启Podman服务加载最新配置：

  systemctl restart podman
  

• 统一推送地址与标签地址，避免解析差异：

  podman --log-level=debug push --tls-verify=false 127.0.0.1:5030/hello-world
  

4. 排查系统层面限制 #

• 临时关闭防火墙测试：

  systemctl stop firewalld
  

  若恢复正常，添加端口允许规则：

  firewall-cmd --add-port=5030/tcp --permanent && firewall-cmd --reload
  

• 临时关闭SELinux测试：

  setenforce 0
  

  若正常，配置SELinux端口规则：

  semanage port -a -t http_port_t -p tcp 5030
  

5. 检查Registry配置与存储权限 #

• 若使用自定义Registry配置，确认未开启强制认证（否则推送需携带用户名密码）
• 检查Registry存储目录权限：容器需对存储目录有读写权限，例如：

  chown -R 10000:10000 /path/to/registry/storage
  

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