Skip to main content

1 / 4概念

Private Registry

私有仓库是团队自己的包与制品的解析入口:它托管内部包,代理上游公共源,并用认证和分组规则决定一次构建能拿到什么。判断标准不是“能不能装包”,而是解析是否可复现、来源是否可审计。

1 概念​

1.1 一句话定义​

私有仓库是一个带存储与代理能力的包索引服务。客户端按 scope 或格式把请求发给它,它从 hosted 仓库返回内部包,或从 proxy 仓库回源上游并缓存,group 仓库把多个来源聚合成一个逻辑源。

1.2 它解决什么问题​

  • 内部包不能发到公共源:需要私有命名空间和访问控制。
  • 上游公共源不稳定或延迟高:需要缓存与代理,减少外网依赖。
  • 多个团队/环境需要不同可见性:需要 hosted、proxy、group 的组合。

没有私有仓库,内部包靠文件拷贝,上游依赖靠每个开发者直连,来源和权限都无法统一。

1.3 不属于本页的内容​

主题去哪
包管理器、lockfile 与 workspaceJavaScript / TypeScript Toolchain
流水线中的认证与发布阶段CI/CD
SBOM、签名与漏洞扫描Supply Chain Security
容器镜像仓库与编排Containers & Cloud Native

1.4 关键术语​

术语含义容易混淆的点
hosted仓库自己存储包不是代理缓存
proxy回源上游并缓存不是 hosted 的副本
group把多个仓库聚合成一个逻辑源不是复制数据
scopenpm 包名前的 @team 命名空间不是权限组
upstream被代理的公共源不是内部发布源
dist-tag指向某个版本的标签,如 latest不是语义化版本
tarball包的实际压缩内容不是元数据 JSON