距离上个版本 0.8.0 时隔一周，这次 v0.9.0 也正式发布了。

这一版不只是继续增加仓库格式，还补上了全局制品搜索、版本更新提醒、代理重定向白名单，以及一批界面和稳定性改进。

• 项目地址：https://github.com/klboke/kkRepo

• v0.9.0 Release：https://github.com/klboke/kkRepo/releases/tag/v0.9.0

kkRepo 是什么？

kkRepo 是一款社区驱动、完全开源的自托管制品仓库，目标是解决 Sonatype Nexus Community Edition 在格式支持、容量限制、迁移和高可用部署等方面的痛点。

项目围绕 Nexus 的客户端协议、权限模型和 /repository/<repo>/... URL 布局实现兼容，并提供存量仓库、制品、用户、角色和权限迁移能力，尽量让原有客户端配置与 CI 流程保持不变。

目前已经支持 20+ 种仓库格式，包括：

Maven 、npm 、PyPI 、Go 、Helm 、Cargo/Rust 、Dart/Pub 、Composer/PHP 、Terraform 、Swift Package Registry 、Ansible Galaxy 、Conda 、APT/Debian 、Conan 2 、Alpine/APK 、Hugging Face Models 、Docker/OCI 、NuGet 、RubyGems 、Yum 和 Raw 。

不同格式按协议能力支持 hosted 、proxy 或 group 仓库。

v0.9.0 主要更新

1. 新增 Alpine / APK 仓库

本次新增 Alpine/APK 的 hosted 、proxy 和 group 三种仓库类型：

• Hosted 支持 APK v2 软件包发布和签名索引生成

• Proxy 支持上游索引透传，以及验签后重新签名

• Group 支持按成员顺序统一解析多个 Alpine 仓库

• 支持 Browse 、Search 、Cleanup 和安全扫描

• 使用真实 apk 客户端验证 update、search、fetch、add 和 upgrade

• 支持从经过验证的 Nexus 3.94 数据结构迁移

2. 新增 Hugging Face Models 代理仓库

现在可以把 kkRepo 作为团队内部的 Hugging Face Models 代理：

• 支持通过 HF_ENDPOINT 接入

• 支持 hf download、huggingface_hub 和 snapshot_download

• 支持 Transformers 与 Diffusers 下载模型

• 服务端桥接 Git LFS 与 Xet 存储

• 按 commit 固定并缓存模型文件，避免 mutable revision 带来的不确定性

• 支持多副本协调、Browse 、Search 、Cleanup 和安全扫描

当前版本聚焦 Models proxy ，不包含 hosted/group 、Datasets 、Spaces 和推理 API 。

3. 新增带权限校验的全局制品搜索

Browse 和 Admin 现在都可以跨仓库搜索制品：

• 搜索前校验仓库权限和 Content Selector

• 无权限的仓库与制品不会出现在结果中

• 使用稳定的 keyset pagination

• 针对大规模 MySQL 数据做了自适应查询优化

• 修复了 MySQL FULLTEXT 无法匹配短词坐标的问题

这项功能解决了仓库数量较多时，需要先进入某个仓库才能查找制品的问题。

4. 其他改进

• 新增基于 GitHub Release 的版本更新提醒

• Proxy 仓库可以配置可信的重定向目标域名，同时保留全局 SSRF 防护

• 统一节点本地 TTL 缓存抽象，继续保持多副本下缓存可丢失、可重建

• 优化 Browse 仓库详情、OIDC/LDAP 、账号、登录、顶部导航和欢迎页

• 修复 URL 中经过百分号编码的 + 被错误解析为空格的问题

• 修复长代理地址写入审计字段时可能导致 MySQL 请求失败的问题

现有核心能力

除仓库格式外，kkRepo 目前还支持：

• Nexus 存量仓库、制品、用户、角色和权限迁移

• Local 、LDAP 、OIDC 认证与细粒度权限管理

• CycloneDX SBOM 、漏洞扫描、策略、豁免和下载阻断

• 面向全部仓库格式的 Cleanup Policy

• Prometheus 指标和 Grafana 面板

• MySQL 或 PostgreSQL 元数据存储

• OSS 、S3 和 File blob storage

• JVM 与 GraalVM Native 两种运行时

• 多副本高可用部署

• 按仓库配置 HTTP 或 SOCKS5 出站代理

Native 版本通常约 1 秒启动就绪，内存占用低于 200 MB 。

快速体验

机器上安装好 Docker 与 Docker Compose 后，执行：

curl -fsSL https://raw.githubusercontent.com/klboke/kkrepo/main/scripts/quickstart.sh | bash

启动 Native 版本：

curl -fsSL https://raw.githubusercontent.com/klboke/kkrepo/main/scripts/quickstart.sh | KKREPO_RUNTIME=native bash

启动后访问：

• 管理控制台：http://127.0.0.1:19090/admin/

• 用户侧浏览器：http://127.0.0.1:19090/browse/

• 健康检查：http://127.0.0.1:19091/actuator/health

首次进入页面时，在 UI 中创建 Local/admin 管理员密码。

Quickstart 默认使用 File blob storage ，适合本地试用；生产环境建议使用独立的 MySQL/PostgreSQL 和 OSS/S3 。

容器镜像：

ghcr.io/klboke/kkrepo:0.9.0
ghcr.io/klboke/kkrepo:0.9.0-native
ghcr.io/klboke/kkrepo-scanner:0.9.0

均提供 Linux AMD64 和 ARM64 镜像。

从 v0.8.0 升级

v0.8.0 的 MySQL 和 PostgreSQL 部署可以通过 Flyway V46–V48 原地升级。

升级前请同时备份关系数据库和 blob store ，并等待数据库迁移完成后再恢复流量。新 schema 应用后，不要继续混合运行 v0.8.0 与 v0.9.0 实例。

组件数据量较大的部署，建议在低 I/O 时段执行 V47 索引迁移。

项目目前仍处于 1.0 之前，生产升级前请先阅读完整 Release Notes 。

如果你正在使用 Nexus ，也欢迎拿真实仓库和客户端测试 kkRepo 。遇到兼容性问题或缺少的仓库格式，可以直接在 GitHub 提 Issue 。

如果项目对你有帮助，也欢迎 Star 、反馈和参与贡献。