ghcr.io/klboke/kkrepo-scanner:0.7.0
kkRepo
English | 中文
kkRepo 是一个社区驱动的完全开源自托管制品仓库,旨在解决 Sonatype Nexus 社区版的固有局限与使用痛点,为社区提供一套开放可靠、可持续迭代演进的制品管理解决方案。当前已支持 Maven、npm、OHPM/鸿蒙生态、PyPI、Go、Helm、Cargo/Rust、Dart/Pub、Composer/PHP、Terraform、Swift Package Registry、Ansible Galaxy、Conda、APT/Debian、Conan 2、Alpine/APK、R/CRAN、Hugging Face 模型、Git LFS、Docker/OCI、NuGet、RubyGems、Yum、Raw 等多种制品格式。
功能特性
- 共支持 24 种仓库格式,不同格式可按需启用 hosted(宿主)、proxy(代理)、group(聚合)三种仓库类型
- 支持 AOT 编译运行模式,启动就绪耗时约 1 秒,运行内存占用低于 200 MB
- 代理仓库支持按仓库维度独立配置出站 HTTP 或 SOCKS5 代理,可选择启用代理身份认证与 HTTPS 上游隧道
- 内置制品安全扫描能力,支持生成 CycloneDX 标准 SBOM、已知漏洞匹配、安全策略与豁免规则管理,还可配置强制下载校验机制
- 提供丰富的制品清理策略,可满足企业级制品全生命周期管理需求
- 完全兼容 Sonatype Nexus 的 API、用户权限模型以及
/repository/ /...路径布局 - 可直接作为 Sonatype Nexus 的无缝替代方案,支持一键迁移存量数据,完整保留原有仓库域名与访问 URL,客户端配置与 CI 工作流无需任何改动即可继续运行
- 提供完整的身份与访问控制能力,支持本地账号、LDAP、OIDC 三种认证方式,可灵活配置***访问策略,权限管控粒度精细
- 内置完善的可观测性体系,支持 Prometheus 指标导出与 Grafana 官方仪表板
- 元数据与共享运行状态存储支持 MySQL 或 PostgreSQL,默认使用 MySQL
- 制品二进制大对象(Blob)支持 OSS/S3/本地文件三类存储后端
- 支持多副本高可用部署
商标声明
Sonatype、Nexus 以及 Nexus Repository 均为 Sonatype, Inc. 的商标。kkRepo 是完全独立的开源项目,与 Sonatype, Inc. 不存在任何隶属关系、未获得其背书、赞助或关联,所有提及 Sonatype Nexus Repository 的内容仅用于描述兼容性、迁移方案或互操作特性。
快速入门
使用官方发布镜像搭配 MySQL 快速启动本地试用环境:
curl -fsSL https://raw.githubusercontent.com/klboke/kkrepo/main/scripts/quickstart.sh | bash
如需使用默认 PostgreSQL 16 启动快速试用环境(运行时兼容 PostgreSQL 12 及以上版本),执行如下命令:
curl -fsSL https://raw.githubusercontent.com/klboke/kkrepo/main/scripts/quickstart.sh | KKREPO_DATABASE_TYPE=postgresql bash
如需使用多架构原生镜像替换默认 JVM 镜像,执行如下命令:
curl -fsSL https://raw.githubusercontent.com/klboke/kkrepo/main/scripts/quickstart.sh | KKREPO_RUNTIME=native bash
KKREPO_RUNTIME 和 KKREPO_DATABASE_TYPE 两个环境变量相互独立,可以自由组合使用,例如可以配置为 KKREPO_RUNTIME=native KKREPO_DATABASE_TYPE=postgresql。
服务启动后可访问以下地址:
- 管理控制台:
http://127.0.0.1:19090/admin/ - 用户浏览界面:
http://127.0.0.1:19090/browse/ - 健康检查端点:
http://127.0.0.1:19091/actuator/health
首次访问时,你可以在界面中完成初始 Local/admin 管理员账号的密码设置。该快速启动脚本默认使用本地文件系统作为 Blob 存储用于试用场景;生产环境部署请使用 OSS/S3 存储,并配置自定义的加密密钥。
如果你希望先检查脚本内容再执行,可以先下载 scripts/quickstart.sh 文件,确认内容无误后再通过 bash 运行该脚本。
构建与部署
Spring Boot 可执行 Jar、Docker 镜像、归档包等本地快速启动方式,生产部署架构、资源容量规划以及升级流程相关说明,可参考 构建与部署指南。
如需了解默认 JVM 运行时与可选原生镜像运行时之间实测的启动速度、内存占用、镜像体积以及预热后吞吐量的差异对比,可参考 原生镜像与 JVM 选型指南。
如果 kkRepo 部署在 Nginx 或其他 HTTPS 反向代理后端,请按照 Nginx 反向代理注意事项 进行配置,确保生成的仓库 URL(例如 npm 的 dist.tarball 地址)能够正确携带公开的 https:// 协议与域名信息。
本地热重载开发与测试相关说明可参考 开发指南。
支持能力清单
| 格式 | 仓库类型 | 客户端发布/上传 | 浏览与搜索 | Nexus 迁移 |
|---|---|---|---|---|
| Maven | hosted / proxy / group | 支持 Maven deploy、PUT 上传以及管理员 UI 上传 | 已支持 | hosted 仓库默认迁移;proxy 仓库可按需选择迁移 |
| npm | hosted / proxy / group | npm publish、dist-tag 以及管理员 UI 上传 | 已支持 | hosted 仓库默认迁移;proxy 仓库可按需选择迁移 |
| OHPM / HarmonyOS | hosted / proxy / group | 支持 ohpm publish 和 ohpm install,普通/流式 HAR/HSP、标签、取消发布以及 UI/API 上传(使用指南) | 已支持包/版本元数据、校验和、浏览/搜索及使用功能 | 支持独立目录/镜像导入,支持试运行、校验和及断点续传;非标准 Nexus 迁移格式 |
| PyPI | hosted / proxy / group | twine 上传以及管理员 UI 上传 | 已支持 simple 索引 | hosted 仓库默认迁移;proxy 仓库可按需选择迁移 |
| Go | hosted / proxy / group | 兼容 Nexus 的 .zip PUT 上传,以及 UI/API 上传;Go 客户端可通过单个 group 解析私有 hosted 模块和公共代理模块 | 已支持 | hosted 仓库默认迁移;proxy 仓库可按需选择迁移 |
| Helm | hosted / proxy / group | Chart 推送、PUT 上传、有序 group 解析以及管理员 UI 上传 | 已支持 index.yaml 聚合 | hosted 仓库默认迁移;proxy 仓库为可选迁移;group 定义会一并迁移 |
| Cargo / Rust | hosted / proxy / group | cargo publish、yank/unyank、CargoToken 认证,以及 UI/API 的 .crate 上传 | 已支持稀疏索引和 cargo search | 支持 Cargo 仓库迁移 |
| Dart / Pub | hosted / proxy / group | dart pub publish、dart pub get、flutter pub get、PubToken 认证,以及 UI/API 的 .tar.gz 上传 | 已支持包/版本元数据、归档属性以及 Pub 搜索 | 支持 Nexus 3.92.0 版本的 Pub hosted 仓库迁移,以及显式选中的代理缓存迁移 |
| Composer / PHP | hosted / proxy / group | Composer 无标准发布命令;支持 Components API 和 UI 上传 zip/tar 归档,以及 Composer 2 安装 | 已支持包/版本元数据、dist、HTML 视图、浏览/搜索及使用功能 | 原生 Nexus Composer 代理配置会迁移;缓存迁移需要管理员显式选择,且需使用已验证的源配置文件 |
| Terraform Provider / Module Registry | hosted / proxy / group | 兼容 Nexus 的 PUT 上传,以及 UI/API 归档上传;terraform init 可通过 group 解析 hosted 和代理的模块/提供程序 | 已支持模块/提供程序坐标、版本、平台、浏览/搜索及使用功能 | 会迁移 Nexus Terraform hosted 数据和显式选中的代理归档缓存,同时迁移代理/组配置 |
| Swift Package Registry | hosted / proxy / group | swift package-registry publish、Basic/Bearer 登录,以及 UI/API 源码归档上传 | 已支持 Registry v1 版本的发布/清单/归档元数据、浏览/搜索及使用功能 | 仅经校验的 Nexus 3.92.x-3.94.x 数据存储形态下可全量迁移 Swift hosted 数据;出现数据漂移或代理密钥不可用时需手动处理 |
| Ansible Galaxy | hosted / proxy / group | ansible-galaxy collection publish、兼容 Nexus 的原生 PUT 上传、路由范围 Base64 Bearer/Ansible 2.9 令牌凭证、GenericToken,以及 UI/API 集合上传(使用指南) | 已支持 Galaxy v3 集合/版本/构件元数据、依赖、浏览/搜索及使用功能 | 支持 Nexus 3.93.x-3.94.x 仓库定义和受形态校验的 hosted/proxy 集合数据;未知数据存储形态会默认拦截迁移 |
| Conda | hosted / proxy / group | 兼容 Nexus 的原生 PUT 上传,以及 UI/API 上传 .tar.bz2 和 .conda 包 | 已支持通道/子目录元数据、JSON/BZ2/ZSTD 仓库元数据、channeldata、浏览/搜索及使用功能 | 支持仓库定义和 Nexus 3.92.x-3.94.x 下受形态校验的 hosted 包数据;生成的元数据会在目标端重建 |
| APT / Debian | hosted / proxy | 兼容 Nexus 的仓库根目录 POST 上传,以及 Components API/UI 上传 .deb 包;支持原生 apt update、下载、安装和升级操作(使用指南) | 已支持带签名的 Packages/Release 元数据、by-hash 机制、浏览/搜索及使用功能 | 支持仓库定义和 Nexus 3.92.x-3.94.x 下受形态校验的 hosted 包;启用迁移后的仓库前需显式导入签名密钥 |
| Conan 2 | hosted / proxy / group | conan upload、Conan Bearer 登录,以及 UI/API 修订版本文件上传(使用指南) | 已支持 RREV/PREV 元数据、与 Nexus 对齐的写入时浏览路径、搜索及使用功能 | 支持 Nexus 3.94 仓库定义和受形态校验的 hosted 或显式选中的代理缓存修订版本;Conan 1 及未知形态会默认拦截迁移 |
| Alpine / APK | hosted / proxy / group | 标准 APK v2 PUT 上传,以及 UI/Components API 上传;支持原生 apk update、搜索、策略、拉取、安装和升级操作(使用指南) | 已支持签名 APKINDEX.tar.gz、透传/验证后重签名代理、有序组源绑定、浏览/搜索及使用功能 | 支持 Nexus 3.94 定义和受形态校验的 hosted 包;生成的索引会重建,签名密钥不可用或代理密钥缺失时会默认拦截迁移 |
| R / CRAN | hosted / proxy / group | 标准源码 .tar.gz PUT 上传,以及 UI/Components API 上传;支持原生 available.packages()、安装和更新流程(使用指南) | 已支持确定性 PACKAGES.gz、任意文件代理、快照绑定组、浏览/搜索、清理、扫描及使用功能 | 支持 Nexus 3.94 定义和受形态校验的 hosted 源码包;生成的索引和绑定关系会重建 |
| Hugging Face Models | proxy | 支持 hf download、hf_hub_download、snapshot_download,以及通过 HF_ENDPOINT 适配 Transformers 和 Diffusers(使用指南) | 已支持锁定提交版本的模型元数据/文件、服务端 LFS/Xet 桥接、浏览/搜索、清理及扫描功能 | 可识别 Nexus 3.77+ 版本的定义;显式选中的 Nexus 3.94 代理缓存受形态校验,未知身份会默认拦截迁移 |
| Docker / OCI | hosted / proxy / group | 支持 Registry V2 登录、hosted 推拉、代理拉取、组拉取、OCI 引用、清理及连接器端口访问 | 已支持清单/标签/ blob 元数据 | 可通过 Nexus Repository Data 流程迁移 hosted Docker 仓库数据 |
| NuGet | hosted / proxy / group | 包推送以及管理员 UI 上传 | 已支持 v3 服务索引 / 搜索 | hosted 仓库默认迁移;proxy 仓库可按需选择迁移 |
| RubyGems | hosted / proxy / group | gem push/yank 以及管理员 UI 上传 |
从 Sonatype Nexus Repository 迁移
迁移功能位于 /admin/ 控制台上:
- 在源 Sonatype Nexus Repository 部署实例上启用 Script REST API 脚本创建功能。
- 在
Nexus Metadata页面,先运行Run preflight完成预检,待所有阻塞性问题解决后再执行Run migration。 - 在
Nexus Repository Data页面,先运行Sync metadata迁移仓库元数据,再运行Sync packages迁移实际二进制 blob 数据。 - 首次执行仓库数据迁移时,保持
Metadata since为空即可扫描全量数据;后续增量迁移可通过设置Metadata since指定数据起始时间。 - 迁移全部完成后,将原有仓库域名指向 kkRepo。非 Docker 客户端可继续沿用原有的
/repository/ /...类 URL;Docker 客户端需保持原有的/v2/...镜像仓库入口、仓库名、以及基于连接器/路径的路由规则不变。
迁移过程支持断点续传,后续重跑时会自动跳过已完成的数据。完整操作流程请查阅 Nexus Migration Guide。
兼容性与迁移上下文
| 维度 | Sonatype Nexus Repository OSS / 社区版 | kkRepo |
|---|---|---|
| 产品定位 | 通用型制品仓库管理平台,覆盖广泛的制品格式与管理能力 | 采用以关系型数据库为核心、优先适配 OSS/S3、原生支持多副本的架构,同时提供面向迁移场景的客户端行为、权限模型与 /repository/ /... URL 兼容性 |
| 支持格式 | 官方支持更多格式,实际能力随版本和分发版存在差异 | 聚焦主流常用制品格式,当前已支持 Maven、npm、OHPM/鸿蒙、PyPI、Go、Helm、Cargo/Rust、Dart/Pub、Composer/PHP、Terraform、Swift Package Registry、Ansible Galaxy、Conda、APT/Debian、Conan 2、Alpine/APK、R/CRAN、Hugging Face Models、Git LFS、Docker/OCI、NuGet、RubyGems、Yum 以及 Raw 格式。每种格式均实现为独立协议模块,便于按优先级进行扩展与验证 |
| 使用限制 | 社区版面向个人与小型团队设计,官方限制为最多 40000 个组件、每日 *** 次请求,触发上限后将暂停新建组件操作,直到使用量回落至限制值以下 | 不存在社区版风格的许可证用量限制,容量上限由选用的关系型数据库、OSS/S3 存储、副本数量以及部署规格决定,可随实际业务需求弹性扩容 |
| 高可用部署 | 开源版仅适配单实例或基础 Kubernetes 部署,官方高可用能力为专业版专属功能 | 默认面向多副本部署设计:会话信息、认证票据、目录水印、分布式锁、迁移进度与短生命周期协同状态全部存储于 MySQL 或 PostgreSQL 中,进程内缓存仅作为可重建的热缓存使用 |
| 稳定性与升级 | 版本边界复杂:3.70.x 是最后一个支持 OrientDB 的版本;3.71.0 开始新安装实例默认使用嵌入式 H2 数据库;社区版直到 3.77.0+ 才正式支持免费的外部 PostgreSQL;直到 3.88.0 版本才完全将搜索能力从 Elasticsearch 迁移至原生 SQL。旧版本基于 OrientDB/Elasticsearch/本地数据目录的部署升级窗口很长,恢复工作高度依赖备份、修复任务与人工介入 | 运行时依赖 MySQL/PostgreSQL,完全不涉及 OrientDB 或嵌入式 Elasticsearch。核心状态全部存储于共享关系型数据库中,二进制 blob 存放于 OSS/S3/文件存储后端,缓存与索引数据均可重建,滚动升级、故障转移与数据恢复操作更简便 |
| 元数据存储 | 历史版本先后使用过 OrientDB、H2、PostgreSQL,配套多轮迁移路径,旧实例在版本升级过程中必须适配数据库迁移约束 | 仓库、组件、资源、权限、令牌、审计日志、迁移状态以及可重建索引全部采用明确的 MySQL 或 PostgreSQL 表结构设计,便于问题排查、运维治理与水平扩容 |
| 二进制存储 | 常规部署默认使用本地文件 blob 存储,对象存储的可用性受版本与配置影响 | 优先采用 OSS/S3 作为 blob 存储,同时保留文件存储模式供开发测试场景使用;关系型数据库中仅存储元数据、状态、索引与引用信息,不存放大体积二进制文件 |
| 搜索与索引 | 3.88.0 版本之前,Nexus 的搜索与索引能力基于嵌入式 Elasticsearch,索引文件与数据库状态相互分离,一旦索引损坏或出现不一致,必须执行 Nexus 内置的修复/重建任务 | 采用关系型数据库的反范式索引与协议派生元数据,浏览/搜索/索引数据均设计为可重建状态,单节点本地缓存丢失不会影响业务正确性 |
| 架构复杂度 | Nexus Repository 功能非常丰富,内置大量通用管理能力与历史架构遗留机制 | kkRepo 保持架构精简,聚焦于制品仓库核心管理能力与客户端协议实现 |
选型参考
- 如果业务规模极小,包数量与流量均未超出社区版限制,且可接受偶尔出现的维护停机,开源版 Sonatype Nexus Repository 完全可以满足需求。
- 如果您对稳定性、可扩展性、多副本部署有较高要求,或者需要管理大规模的制品包数量,kkRepo 正是针对这类部署形态设计的。
- 若现有 Sonatype Nexus Repository 实例升级至新版本社区版后触发了组件数量或每日请求数的上限,kkRepo 提供了专为零停机迁移设计的一键式迁移流程。
UI 概览
用户端 UI
用户端 UI 面向制品使用者,提供仓库列表、包搜索、目录浏览、制品详情以及上传入口。
仓库列表会展示宿主仓库、代理仓库与仓库组的信息,包含对应的制品格式、运行状态与访问 URL,方便用户直接复制客户端配置地址使用。
支持按制品格式跨 Maven、npm、OHPM/鸿蒙、PyPI、Go、Helm、Cargo/Rust、Dart/Pub、Composer/PHP、Terraform、Swift Package Registry、Ansible Galaxy、Conda、APT/Debian、Conan 2、Alpine/APK、R/CRAN、Hugging Face Models、Git LFS、Docker/OCI、NuGet、RubyGems、Yum、Raw 等仓库类型搜索组件。
目录浏览功能可展示仓库路径树、制品概要信息、校验和、内容类型、更新时间以及客户端使用示例片段。
上传页面允许用户选择目标仓库、上传文件并设置资源路径,完成手动发布至宿主仓库的操作。
管理员 UI
管理员 UI 面向仓库管理员,核心覆盖仓库配置、存储健康度、安全配置、审计与迁移场景。
Blob Store 页面支持 OSS Native SDK、AWS S3 SDK 和 File 三类存储引擎配置,可实时展示读写探测的运行健康状态。
OIDC 页面可配置身份颁发者、JWKS、客户端、作用域、声明映射与令牌校验相关参数,用于对接集中式身份认证系统。
Nexus 元数据迁移页面可迁移用户、角色、权限、Blob 存储及仓库定义,同时支持预检查功能。
Nexus 仓库数据迁移页面可展示宿主型仓库数据迁移任务、并发设置、进度统计、失败计数以及单仓库详情。
AI 代理与贡献者开发说明请查阅 AGENTS.md。
路线图
平台基础设施路线图:
- ✅ PostgreSQL 数据库后端:通过公开的
persistence-jdbc契约、语义方言 SPI、后端自主维护的 Flyway 迁移脚本、双数据库契约测试以及多副本服务器冒烟测试完成实现。MySQL 仍为默认后端(参考数据库后端指南、中文设计方案)。 - ✅ 制品安全扫描:在默认关闭的部署能力闸门后实现。该功能关闭期间,升级流程不会处理历史制品,也不会添加上传出箱写入操作。在运维人员显式启用该能力后,管理员仍需在管理 UI 中逐个激活对应仓库;之后与特性无关的事务型资产变更出箱机制可保证上传操作与异步 SBOM/已知漏洞分析完全解耦。该实现包含持久化多副本协调、Docker/OCI 多平台覆盖、规则/豁免评估,以及可选的下载强制校验功能(参考使用指南、中文设计说明)。
仓库格式路线图:
镜像名称:
ghcr.io/klboke/kkrepo-scanner参考标签:
latest
- ✅ Docker / OCI 制品仓库 - 已完成(实现说明)
- ✅ Cargo / Rust - 制品仓库支持已完成,包含搜索、UI/API 上传和迁移功能(设计说明)
- ✅ Dart / Pub - 制品仓库支持已完成,包含 hosted/proxy/group 类型、客户端全链路 E2E 验证、UI/API 上传、搜索,以及 Nexus 迁移功能(中文设计说明)
- ✅ Composer / PHP - 已实现 hosted、proxy、group 类型、UI/API 上传、搜索、真实客户端全链路 E2E 验证、所需 Nexus 实时对比,以及经明确选定的 Nexus 代理缓存迁移全链路 E2E 验证(中文设计说明)
- ✅ Terraform Provider / Module Registry - 已实现 hosted、proxy、group 类型、Provider GPG 签名、Nexus 兼容路径、UI/API 上传、搜索、真实 Terraform CLI 全链路 E2E 验证、Nexus 托管数据迁移,以及经明确选定的代理缓存迁移功能(中文设计说明)
- ✅ Swift Package Registry - 已实现 hosted、GitHub 后端代理、group 类型、Registry v1 规范、不可变签名发布、UI/API 上传、浏览/搜索、多副本协同、真实 SwiftPM/Xcode 全链路 E2E 验证,以及经过格式校验的 Nexus 3.92.x-3.94.x 版本迁移功能(中文设计说明)
- ✅ Ansible Galaxy - 已实现 Galaxy v3 规范下的 hosted/proxy/group 类型、不可变集合发布、依赖解析、路由作用域的 Base64 Bearer/Ansible 2.9 Token 与 GenericToken 认证、UI/API 上传、浏览/搜索、持久化多副本导入/代理协同、真实 Ansible 2.9/当前版本客户端全链路 E2E 验证、Nexus 黑盒兼容性,以及经过格式校验的 Nexus 3.93.x-3.94.x 版本迁移功能(使用指南、中文设计说明)
- ✅ Conda - 已实现 hosted、proxy、group 类型、
.tar.bz2/.conda格式制品发布、JSON/BZ2/ZSTD 通道元数据、UI/API 上传、浏览/搜索、多副本协同、真实 Conda 客户端全链路 E2E 验证、Nexus 黑盒测试用例集,以及经过格式校验的 Nexus 3.92.x-3.94.x 托管数据迁移全链路 E2E 验证(中文设计说明) - ✅ APT / Debian - 已实现 hosted/proxy 制品仓库、签名元数据、UI/API 上传、浏览/搜索、多副本发布、真实 APT 客户端与 Nexus 黑盒校验、经过格式校验的迁移功能,以及可复现的 Nexus 性能基准测试(使用指南、中文设计说明、性能基准)
- ✅ Conan 2 - 已实现 hosted/proxy/group 类型、Conan 承载认证、清单校验的版本发布、写入时 Nexus 浏览投影、UI/API 上传、清理、复合包扫描、经过格式校验的迁移、真实 Conan 客户端全链路 E2E 验证,以及双数据库 Nexus 性能基准测试(使用指南、中文设计说明、性能基准)
- ✅ Alpine / APK - 已实现 hosted/proxy/group 类型、APK v2 包校验、不可变签名索引、透传/校验后重签名代理、有序组源绑定、UI/API 上传、浏览/搜索、清理、扫描、经过格式校验的 Nexus 3.94 版本迁移、apk-tools 2.14/3.0 客户端全链路 E2E 验证,以及可复现的 Nexus 性能校验门禁(使用指南、中文设计说明、性能基准)
- ✅ Hugging Face Models - 已实现仅含模型的代理仓库,支持绑定提交版本的元数据/文件、服务端 LFS/Xet 桥接、真实 Hub/Transformers/Diffusers 客户端对接、多副本 S3 协同、扫描、清理,以及经过格式校验的 Nexus 迁移功能(使用指南、中文设计说明、性能基准)
- ✅ R / CRAN - 已实现 hosted/proxy/group 类型、受限源码包校验、确定性
PACKAGES.gz生成、延迟校验代理、绑定快照的组依赖解析、UI/API 上传、浏览/搜索、清理、部分覆盖扫描、经过格式校验的 Nexus 3.94 版本迁移、R 4.5/4.6 客户端全链路 E2E 验证、索引化双数据库访问,以及可复现的 Nexus 性能校验门禁(使用指南、中文设计说明、性能基准) - ✅ Go - 已实现 hosted/proxy/group 适配规则、Nexus 兼容的模块 ZIP 发布、官方规范路径/版本/归档校验、有序组合聚合、清理、制品扫描、UI/API 上传、迁移、真实 Go 客户端全链路 E2E 验证、Nexus 3.94 黑盒对比,以及可复现的性能基准测试(使用指南、性能基准)
- ✅ OHPM / HarmonyOS - 已实现 hosted/proxy/group 类型、常规与流式 HAR/HSP 制品发布、校验缓存、UI/API 管理、支持断点续传的独立导入,以及可选的签名登录功能。真实客户端验收已纳入现有全量 E2E 测试矩阵(使用指南、签名登录、测试覆盖与限制)
- ✅ Helm 组仓库 - 已实现 hosted、proxy 类型与嵌套组成员的按配置顺序聚合(首成员优先)、持久化索引缓存、真实 Helm 客户端全量覆盖,以及 Nexus 定义迁移功能(使用指南)
- ✅ Git Large File Storage (LFS) - 已实现 hosted Batch/基础/校验接口、经校验的 OSS/S3 流式上传、多副本发布、仓库权限,以及经过格式校验的 Nexus 3.94 版本迁移功能;Git 托管、文件锁与自动清理功能暂未包含(使用指南、实现设计)
- Eclipse p2 - 规划中,将提供兼容 Nexus 的代理仓库,用于对接 Eclipse 和 Equinox 更新站点
- CocoaPods - 规划中,将提供兼容 Nexus 的代理仓库,用于对接 CocoaPods 依赖源
用户与管理员界面中暴露的令牌类型包含协议专属令牌(NpmToken、CargoToken、PubToken、NuGetApiKey、RubyGemsApiKey),以及用于 Terraform 服务 URL、Ansible Galaxy 客户端、CI 流水线、脚本与可发送配置 API 密钥头或承载令牌的自定义 HTTP 客户端的 GenericToken。OHPM 客户端会将 GenericToken 作为原始 Authorization 值使用;RSA 签名登录为可选功能,默认处于禁用状态。
谁在使用 kkRepo?
如果您的公司、企业或组织正在使用 kkRepo,欢迎在https://github.com/klboke/kkRepo/issues/94 中分享您的部署情况。该 Issue 仅用于使用登记;反馈漏洞和提交功能请求请使用常规 Issue 模板。
贡献
欢迎提交 Issue 和 Pull Request。请参阅 CONTRIBUTING.md 了解贡献者工作流程、PR 规范要求、兼容性测试要求以及多副本设计约束。社区行为规范已记录在 CODE_OF_CONDUCT.md 中。
本地开发与测试的相关说明请参考开发指南。构建与部署的相关说明请参考构建与部署指南。AI 代理与贡献者约束的相关说明见 AGENTS.md。
支持
您可以加入 kkRepo *** 群组 获取社区支持、参与使用交流。关于 Issue 分流、支持范围和安全上报边界的说明请查看 SUPPORT.md。
赞助
感谢所有支持 kkRepo 持续开发与维护的人士。您可以通过 https://github.com/***/klboke 支持本项目。
您也可以通过或赞助 kkRepo。
企业赞助商
活跃企业赞助商的 Logo 和链接将在此处展示。
项目支持者
活跃项目支持者的姓名或 Logo(可附带链接)将在此处公示致谢。
安全
如果您发现安全漏洞,请遵循 SECURITY.md 中的指引,优先通过 GitHub 安全公告通道上报,请勿在公开 Issue 中披露可被利用的漏洞细节。常规漏洞、兼容性问题和功能请求可以提交为公开 Issue。
许可证
kkRepo 基于 Apache License 2.0 协议开源。
文档列表
- 开发指南
- 构建与部署指南
- 制品扫描指南
- 清理策略指南
- 浏览目录删除说明
- 管理员存储用量说明
- 仓库使用指南
- Native Image 与 JVM 选型指南
- Nginx 反向代理说明
- 架构说明
- 兼容性矩阵
- 故障排查指南
- 生产环境加固指南
- 备份与恢复指南
- 安全模型说明
- 内容选择器说明
- MySQL ER 设计
- 数据库后端说明
- 数据库 schema 说明
- Nexus 迁移指南
- Nexus 迁移操作手册
- 监控与可观测性指南
- Nexus 兼容性测试说明
- 常见问题
- kkRepo 设计初衷说明
- 更新日志
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务