推送Windows Docker镜像至Ubuntu Registry遇500内部服务器错误求助

可能的原因及解决方案 #

1. 更新Registry镜像至最新版本 #

老版本的registry:2对Windows镜像的Manifest V2格式支持存在兼容性问题，先拉取最新镜像并重启服务：

# 拉取最新registry镜像
docker pull registry:2

# 停止并删除旧容器（替换为你的容器名）
docker stop my-registry && docker rm my-registry

# 重新启动容器（保留原有存储卷）
docker run -d -p 5000:5000 --name my-registry -v registry-data:/var/lib/registry registry:2

2. 检查并修复Registry存储目录权限 #

Linux环境下，registry:2容器默认使用UID为10000的用户运行，本地挂载的存储目录权限需匹配，否则会导致写入失败触发500错误：

# 假设你的存储目录是/opt/registry-data，修改权限
sudo chown -R 10000:10000 /opt/registry-data

# 重启Registry容器
docker restart my-registry

3. 推送时禁用内容信任校验 #

Windows镜像中的foreign layer（官方基础镜像层）会被客户端跳过推送，但Registry可能因内容信任校验失败报错，推送时添加--disable-content-trust参数：

docker push --disable-content-trust [你的Registry地址]/[镜像名]:[标签]

4. 启用Registry调试日志定位具体错误 #

默认日志仅显示模糊的unknown error，添加LOG_LEVEL=debug环境变量获取详细日志，便于排查：

# 重新启动容器并开启调试日志
docker stop my-registry && docker rm my-registry
docker run -d -p 5000:5000 --name my-registry -e LOG_LEVEL=debug -v registry-data:/var/lib/registry registry:2

# 实时查看日志
docker logs -f my-registry

根据调试日志中的具体错误信息，可进一步定位是存储驱动问题、Manifest解析问题还是其他权限/配置问题。

5. 配置Registry支持跨OS镜像存储 #

创建自定义配置文件config.yml，确保存储驱动和HTTP配置正确：

version: 0.1
storage:
  filesystem:
    rootdirectory: /var/lib/registry
http:
  addr: :5000
# 若需要删除镜像功能，可添加以下配置
# delete:
#   enabled: true

挂载配置文件启动容器：

docker run -d -p 5000:5000 --name my-registry -v $(pwd)/config.yml:/etc/docker/registry/config.yml -v registry-data:/var/lib/registry registry:2

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