distribution/distribution

GitHub: distribution/distribution

OCI Distribution Specification 的官方开源实现,提供容器镜像及其他内容存储与分发的核心 Registry 服务。

Stars: 10326 | Forks: 2724

[![构建状态](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/7899f560f2151926.svg)](https://github.com/distribution/distribution/actions/workflows/build.yml?query=workflow%3Abuild) [![GoDoc](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/github.com/distribution/distribution) [![许可证:Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE) [![codecov](https://codecov.io/gh/distribution/distribution/branch/main/graph/badge.svg)](https://codecov.io/gh/distribution/distribution) [![FOSSA 状态](https://app.fossa.com/api/projects/custom%2B162%2Fgithub.com%2Fdistribution%2Fdistribution.svg?type=shield)](https://app.fossa.com/projects/custom%2B162%2Fgithub.com%2Fdistribution%2Fdistribution?ref=badge_shield) [![OCI 一致性](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/8d25dcd6a0151935.svg)](https://github.com/distribution/distribution/actions?query=workflow%3Aconformance) [![OpenSSF 记分卡](https://api.securityscorecards.dev/projects/github.com/distribution/distribution/badge)](https://securityscorecards.dev/viewer/?uri=github.com/distribution/distribution) 用于打包、传输、存储和交付内容的工具集。 本仓库的主要产品是开源 Registry(注册中心)实现, 用于使用 [OCI Distribution Specification](https://github.com/opencontainers/distribution-spec) 存储和分发容器镜像及其他内容。 本项目的目标是提供一个简单、安全且可扩展的基础, 以便构建大规模 Registry 解决方案或运行简单的私有 Registry。 它是许多 Registry 运营商的核心库,包括 Docker Hub、GitHub Container Registry、 GitLab Container Registry 和 DigitalOcean Container Registry,以及 CNCF Harbor 项目和 VMware Harbor Registry。 本仓库包含以下组件: |**组件** |描述 | |--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **registry** | [OCI Distribution Specification](https://github.com/opencontainers/distribution-spec) 的一个实现。 | | **libraries** | 用于与 distribution 组件交互的丰富库集。详情请参阅 [godoc](https://pkg.go.dev/github.com/distribution/distribution)。**注意**:这些库的接口是 **不稳定** 的。 | | **documentation** | 完整文档可在 [https://distribution.github.io/distribution](https://distribution.github.io/distribution/) 获取。 ### 它是如何与 Docker, containerd 以及其他 OCI 客户端集成的? 客户端根据 OCI 规范实现,并通过 HTTP 与 Registry 通信。本项目包含一个客户端实现, 目前正被 Docker 使用,但是,它已被 [containerd 中的实现](https://github.com/containerd/containerd/tree/master/remotes/docker) 取代, 并且将不再支持新功能。 ### Distribution 项目的长期目标是什么? _Distribution_ 项目的长期目标是提供一个安全的内容分发工具链。这些规范、API 和工具 在有无 Docker 的情况下都应同样有用。 我们的目标是设计一个专业级且可扩展的内容分发系统,允许用户: * 享受高效、安全且可靠的方式来存储、管理、打包和交换内容 * 基于健康的开源组件进行定制/组装 * 通过良好的规范和稳固的扩展机制实现自己的定制解决方案。 ## 贡献 关于如何为此项目贡献问题、修复和补丁的详细信息,请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。如果您正在贡献代码,请参阅 [构建开发环境](BUILDING.md) 的说明。 ## 交流 对于异步交流和长期讨论,请在 GitHub 仓库上使用 issues 和 pull requests。 这将是讨论设计和实现的最佳场所。 对于同步交流,我们在 [CNCF Slack](https://slack.cncf.io/) 中有一个 #distribution 频道, 欢迎大家加入并聊聊开发。 ## 许可证 distribution 代码库在 [Apache 2.0 许可证](LICENSE) 下发布。 README.md 文件和 "docs" 文件夹中的文件根据知识共享署名 4.0 国际许可协议进行许可。您可以在 http://creativecommons.org/licenses/by/4.0/ 获取名为 CC-BY-4.0 的许可证副本。
标签:DevOps 工具链, DNS解析, Docker, Docker Hub, Docker Registry, EVTX分析, Go 语言, OCI Distribution Spec, OCI 标准, Python脚本, Web截图, 制品库, 安全防御评估, 容器交付, 容器安全, 容器技术, 容器镜像仓库, 开源项目, 微服务基础设施, 日志审计, 私有仓库, 请求拦截, 镜像分发, 镜像存储, 镜像管理