使用 kkRepo 搭建 Python PyPI 私服

在 Python 项目中，PyPI 私服通常承担两个角色：一是托管公司内部的 Python 包，二是代理和缓存 PyPI 官方仓库的第三方依赖。这样既能让 CI/CD 发布内部包有统一入口，也能减少公网网络波动对 pip install 的影响。

kkRepo 是一个兼容 Nexus 客户端访问习惯的自托管制品仓库，支持 Maven 、npm 、PyPI 、Go 、Helm 、Docker/OCI 等多种制品格式。对于 PyPI 场景，它支持 hosted 、proxy 和 group 仓库，并保留常见的 /repository/<repo>/... URL 结构，方便从 Nexus 迁移或替换。

• https://github.com/klboke/kkrepo


• https://gitee.com/kailing/kkRepo

一、快速启动 kkRepo

本地体验可以直接使用官方 quickstart 脚本，它会拉起 kkRepo 和 MySQL：

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

启动完成后访问：

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

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

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

首次进入管理控制台时，需要创建初始 Local/admin 管理员密码。

本地 quickstart 默认使用 File blob storage ，适合试用和开发验证。生产环境建议使用独立 MySQL ，并将 blob 存储切换为 OSS/S3 。

二、创建 PyPI 仓库

进入 /admin/ 后，建议按 PyPI 常见用法创建三类仓库：

pypi-hosted    hosted ，用于发布公司内部 Python 包

pypi-proxy     proxy ，用于代理 PyPI 官方仓库

pypi-group     group ，用于 pip 安装依赖的统一入口

创建 pypi-proxy proxy 仓库时，上游地址可以填写 PyPI 官方 simple index 地址：

https://pypi.org/simple/

创建 pypi-group group 仓库时，把下面几个成员仓库加入 group：

pypi-hosted

pypi-proxy

这样客户端只需要从 pypi-group 一个地址安装依赖：公司内部发布到私服的包会从 pypi-hosted 命中，第三方开源依赖会通过 pypi-proxy 回源并缓存。发布时仍然写入 pypi-hosted。