软件仓库：未选型能力与通用制品治理

软件仓库：未选型能力与制品治理

图示边界与待决策项

原图的软件仓库没有连到外部产品，必须保留“未选型”状态。它与代码仓库、镜像仓库及 Maven 仓库不是同一概念：此处关注安装包、压缩包、内部工具和离线分发材料。是否使用通用制品库、操作系统软件源或其他存储，应由真实格式、客户端和权限需求决定。

Nexus 是可评估候选而非既定实现。站内工具条目对应 Nexus Repository Core；官方当前代码库说明 Core 提供 Maven、raw、APT 和内嵌 H2，而 Community Edition 的格式及数据库能力不同，不能把 CE 或 Pro 文档中的功能直接套给 Core。Nexus Core 官方说明

前提依赖与选型清单

先列出需要分发的格式、客户端、上传主体、下载量、最大文件、离线要求和外部上游来源。分别评估格式原生元数据、签名机制、访问控制、审计、保留、备份和故障恢复。若需要 npm、PyPI 或其他格式，必须重新核对候选发行形态，不通过把文件上传到 raw 仓库就宣称已支持原生协议。

登记选定版本、许可、数据库类型和 blob 存储形态。软件仓库与 Maven 仓库是否共用实例可以评审，但命名、授权、清理和容量配额仍要隔离，不能因同用 Nexus 就混为一个无限制目录。当前没有作出选型或部署，所有验证均待目标环境授权。

受控接入与制品晋级

先在隔离空间上传一份无敏感信息的样例工具，记录来源 URL、作者或供应方、版本、构建编号、校验和、签名验证结果及许可审阅结论。下载后核对校验和，再以实际客户端验证安装或解包；上传成功并不能证明包可用。

为候选、已批准和废弃制品定义独立状态与批准人，已发布对象的路径或标识应稳定。确需替换时发布新版本并记录原版本影响范围，不静默覆盖同名包。批量主机初始化应引用明确版本与校验值，避免每次运行从外网抓取不确定内容。

日常巡检

检查下载成功率、上传拒绝、校验失败、空间增长、上游失败和即将到期凭据。抽查常用安装包能否从批准入口取回、其校验值是否与发布记录一致，以及离线环境所需依赖是否完整。对内部自研制品与可重新下载的公共缓存采用不同保留策略。

发现有授权限制的供应商软件时，核对分发受众和访问期限；未获许可的包不要因已有一份本地副本就扩大共享。软件清理前核对仍在使用的主机、自动化任务和灾备安装清单，保留至少满足已批准回退需求的版本。

故障分支

下载失败先区分对象不存在、身份拒绝、仓库离线和上游不可达。能下载但校验不匹配时停止分发，比较原上传校验、存储对象和客户端结果，禁止把新校验值直接替换到脚本中让检查通过。

安装失败需比较系统架构、运行时依赖、包来源和客户端格式要求；文件存储可用不代表原生包元数据正确。上游限流时先评估缓存和重试预算，不把所有客户端回退成直连未知公共源。

安全与备份恢复

备份清单包括批准的内部制品、目录及版本元数据、仓库配置、访问策略和密钥；公共代理缓存可重建的前提是上游仍存在且允许下载，不能一概排除。若选 Nexus，数据库和 blob 必须采用与发行形态匹配的一致性恢复方案。Sonatype 备份恢复入口

Core 的 H2 与其他发行形态可能使用的数据库不能互用恢复指令。先核对实际版本和官方适用范围，再在隔离目标恢复并比对对象清单与校验值。回滚仓库配置不会恢复已经删除的包，恢复点后的新增制品需从受控发布记录补回。

验收与停止点

选型验收以实际客户端下载、未授权拒绝、校验一致、回退版本可取和隔离恢复为准。对于未验证格式、许可不清、来源不明、签名或校验失败及无恢复路径的包，停止接入和分发。选型未完成时站点仍标注候选，不提供真实服务入口或生产可用性承诺。

官方参考

评估 Nexus 时先阅读 Core 官方仓库，再选择适配版本的产品文档。Maven 专用的坐标与发布策略见Maven 仓库手册；主机分发可关联批量初始化场景。