regctl

OCI Registry 命令行客户端

补充说明

regctl 直接操作兼容 OCI 的 registry，支持镜像复制、清单查看、标签管理和 OCI artifact。它不需要 Docker daemon，适合 CI 和制品仓库运维。

常用示例

regctl registry login registry.example.com -u user -p "$PASSWORD"
regctl repo ls registry.example.com
regctl tag ls registry.example.com/app
regctl image inspect registry.example.com/app:1.0
regctl image digest registry.example.com/app:1.0
regctl manifest get registry.example.com/app:1.0
regctl image copy registry.example.com/app:1.0 registry.example.com/app:stable
regctl artifact list registry.example.com/app:1.0
regctl image put registry.example.com/app:1.0 --file app.tar

易错点与排错

• 认证信息按 registry 保存；换 registry 或换账号后要重新登录。
• tag 和 digest 的语义不同；复制和部署前确认用的是哪一个。
• OCI artifact 和镜像共用 registry，但媒体类型不同；artifact list 才能看到附属物。
• 复制多平台镜像会保留 manifest list；只复制单个平台要显式指定。
• 自签名或 HTTP registry 需要配置；默认校验会失败。
• 速率限制会导致批量复制中断；加重试和退避。
• tag 不可变策略会拒绝覆盖；发布流程要适配。
• regctl 不负责构建；镜像内容仍由 buildx/buildctl 等工具生成。

相关命令

• crane — 另一款 registry 客户端
• docker-buildx — 构建镜像
• dive — 分析镜像层