使用Nexus Repository Manager搭建私有自建 pip 源
为什么要自建 pip 源？
在企业或内网环境中，常见需求：
❌ 无法访问公网 PyPI（如安全隔离网络）
⏳ 安装包太慢（pip 下载慢）
🔐 需要统一管理第三方包或发布内部私有库
📦 缓存常用包，避免重复下载
👉 解决方案：搭建私有 pip 源
而 Nexus 是目前最流行的通用仓库管理工具，支持：
✅ Python (PyPI)
✅ npm
✅ Maven
✅ Docker
✅ Helm 等
官网下载：https://www.sonatype.com/download-oss-sonatype
- 使用Docker Nexus搭建私有pip源完整指南## 标题
- 使用Docker部署Nexus
# 创建数据卷（持久化存储）
docker volume create nexus-data# 启动Nexus容器
docker run -d \--name nexus3 \--restart=always \-p 38081:8081 \-v nexus-data:/nexus-data \sonatype/nexus3
1.2 使用docker-compose部署（推荐）
version: '3'
services:nexus:image: sonatype/nexus3:latestcontainer_name: nexus3restart: alwaysports:- "38081:8081"volumes:- nexus-data:/nexus-dataenvironment:- INSTALL4J_ADD_VM_PARAMS=-Xms2g -Xmx2g -XX:MaxDirectMemorySize=3gvolumes:nexus-data:
启动服务：docker-compose up -d
查看初始密码
# 查看初始密码
docker exec nexus3 cat /nexus-data/admin.password# 或者
docker-compose exec nexus cat /nexus-data/admin.password
- 配置Nexus PyPI仓库
2.1 登录Nexus
访问：http://localhost:38081
使用admin和初始密码登录
按提示修改密码
2.2 创建PyPI仓库
创建代理仓库（缓存公共包）
点击 “设置” → “Repository” → “Repositories”
点击 “Create repository” → 选择 “pypi (proxy)”
配置：
Name: pypi-proxy
Remote storage: https://pypi.org/
创建托管仓库（存储私有包）
点击 “Create repository” → 选择 “pypi (hosted)”
配置：
Name: pypi-hosted
Deployment policy: Allow redeploy
创建仓库组（统一入口）
点击 “Create repository” → 选择 “pypi (group)”
配置：
Name: pypi-all
Member repositories: - pypi-hosted (优先级高)- pypi-proxy
- 配置pip客户端## 标题
3.1 临时使用
# 下载包示例
pip install requests -i http://localhost:8081/repository/pypi-all/simple --trusted-host localhost
3.2 永久配置
# 创建配置目录
mkdir -p ~/.pip# 创建配置文件
cat > ~/.pip/pip.conf << EOF
[global]
index-url = http://localhost:8081/repository/pypi-all/simple
trusted-host = localhost
EOF
3.3 验证配置
# 查看当前配置
pip config list# 测试下载
pip install requests -v
- 上传私有包到Nexus
4.1 创建上传凭证
创建 ~/.pypirc 文件：
[distutils]
index-servers = nexus[nexus]
repository: http://localhost:8081/repository/pypi-hosted/
username: admin
password: your-admin-password
4.2 准备测试包
创建测试项目结构：
mkdir mypackage && cd mypackage
创建 setup.py：
from setuptools import setup, find_packagessetup(name="mypackage",version="0.1.0",author="Your Name",author_email="your.email@example.com",description="A test package",packages=find_packages(),python_requires=">=3.6",
)
创建包文件 mypackage/init.py：
def hello():return "Hello from mypackage!"
4.3 构建并上传包
# 安装构建工具
pip install build twine
# 构建包
python -m build
# 上传到Nexus
python -m twine upload --repository nexus dist/*# 或者直接指定URL上传：
twine upload --repository-url http://localhost:8081/repository/pypi-hosted/ \-u admin -p your-admin-password \dist/*
- 完整使用示例
5.1 下载公共包
# 从Nexus下载（会自动缓存）
pip install numpy pandas requests# 查看已安装包
pip list
5.2 下载私有包
# 安装之前上传的私有包
pip install mypackage# 使用私有包
python -c "from mypackage import hello; print(hello())"
5.3 更新私有包
# 修改版本号 setup.py
setup(name="mypackage",version="0.2.0", # 更新版本...
)
# 重新构建和上传
python -m build
twine upload --repository nexus dist/*# 更新安装
pip install --upgrade mypackage
- 高级配置
6.1 配置HTTPS（生产环境推荐）
使用nginx反向代理：
# docker-compose.yml 添加nginx
version: '3'
services:nexus:image: sonatype/nexus3:latestcontainer_name: nexus3restart: alwaysexpose:- "8081"volumes:- nexus-data:/nexus-dataenvironment:- INSTALL4J_ADD_VM_PARAMS=-Xms2g -Xmx2gnginx:image: nginx:alpinecontainer_name: nexus-nginxrestart: alwaysports:- "443:443"- "80:80"volumes:- ./nginx.conf:/etc/nginx/nginx.conf:ro- ./ssl:/etc/nginx/ssl:rodepends_on:- nexusvolumes:nexus-data:
6.2 批量迁移包
从官方源迁移常用包到私有源：
# migrate_packages.py
import subprocess
import syspackages = ["requests","numpy","pandas","flask","django",# 添加更多需要的包
]for package in packages:print(f"Downloading {package}...")subprocess.check_call([sys.executable, "-m", "pip", "download", "--no-deps", package])print("All packages downloaded to current directory")