在 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 迁移或替换。
一、快速启动 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。
Select Language